通过阿里云日志服务采集应用日志 - 容器服务 ACK

本文将介绍如何在ASK集群中将业务容器的标准输出和日志文件收集到阿里云日志服务。

前提条件

已创建ASK集群。具体操作，请参见创建ASK集群。
已开启阿里云日志服务。具体操作，请参见在ASK集群中开启应用日志。

步骤一：创建应用并配置日志服务

您可以在创建应用的同时配置日志服务，从而对容器的日志进行采集。目前支持通过镜像和YAML模板两种方式创建应用。

方式一：通过镜像创建应用并配置日志服务

登录容器服务管理控制台，在左侧导航栏中选择集群。
在集群列表页面中，单击目标集群名称，然后在左侧导航栏中，选择工作负载 > 无状态。

在无状态页面上方的命名空间下拉列表中选择目标命名空间，然后在页面右上角单击使用镜像创建。

在应用基本信息页签，设置应用名称、副本数量和类型，然后单击下一步。

在容器配置页签的日志服务区域，进行相关配置。

说明本文仅介绍日志服务相关的配置，其他的应用配置，请参见创建无状态工作负载Deployment。

配置示例如下：


配置项	说明
采集配置	单击采集配置，配置日志库和容器内日志路径。日志库：配置Logstore名称，名称中只能包含小写字母、数字和短划线（-）。您可以使用它来指定所采集日志存储于该Logstore，如果该Logstore不存在的话，ASK会自动为您在集群关联的日志服务Project下创建相应的Logstore。容器内日志路径：指定希望采集的日志所在的路径，例如使用`/usr/local/tomcat/logs/catalina.*.log`来采集Tomcat的文本日志。说明如果指定为`stdout`，表示采集容器的标准输出和标准错误输出。每一项采集配置都会被自动创建为对应Logstore的一个采集配置，默认采用极简模式（按行）进行采集，如果您需要更丰富的采集方式，可以登录日志服务控制台，进入相应的Project（默认是k8s-log前缀）和Logstore对配置进行修改。
自定义Tag	单击自定义Tag，配置Tag名称和Tag值。每一个自定义Tag都是一个键值对，会拼接到所采集到的日志中，您可以使用它来为容器的日志数据进行标记，例如版本号。

配置完成后，在页面右侧单击下一步，后续操作，请参见创建无状态工作负载Deployment。

方式二：通过YAML模板创建应用并配置日志服务

在集群管理页左侧导航栏中，选择工作负载 > 无状态。
在无状态页面上方的命名空间下拉列表中选择目标命名空间，然后在页面右上角单击使用YAML创建资源。
在创建页面，选择示例模板，并配置相应的模板。
YAML模板的语法同Kubernetes语法，但是为了给容器指定采集配置，需要使用env来为容器增加采集配置和自定义Tag，并根据采集配置，创建对应的volumeMounts和volumes。Pod YAML示例如下：
```
apiVersion: v1
kind: Pod
metadata:
  name: my-demo
spec:
  containers:
  - name: my-demo-app
    image: 'registry.cn-hangzhou.aliyuncs.com/log-service/docker-log-test:latest'
    env:
    ######### 配置环境变量 ###########
    - name: aliyun_logs_log-stdout
      value: stdout
    - name: aliyun_logs_log-varlog
      value: /var/log/*.log
    - name: aliyun_logs_mytag1_tags
      value: tag1=v1
    ######### 配置Volume Mount ###########
    volumeMounts:
    - name: volumn-sls-mydemo
      mountPath: /var/log
  volumes:
  - name: volumn-sls-mydemo
    emptyDir: {}
```
按需在Pod YAML示例中增加以下配置示例：

说明若您有更多的日志采集需求，请参见步骤二：配置环境变量的高级参数。
1. 通过环境变量创建采集配置和自定义Tag，所有与配置相关的环境变量都采用aliyun_logs_作为前缀。
  1. 创建采集配置的规则：
    - name: aliyun_logs_log-stdout value: stdout - name: aliyun_logs_log-varlog value: /var/log/*.log
    示例中创建了两个采集配置，格式为aliyun_logs_{key}，对应的{key}分别为log-stdout和log-varlog。
    
    aliyun_logs_log-stdout：该env表示创建一个Logstore名称为log-stdout，日志采集路径为stdout的配置，对应的日志服务采集配置名称也是log-stdout，目的是将容器的标准输出采集到log-stdout这个Logstore中。
    
    aliyun_logs_log-varlog：该env表示创建一个Logstore名称为log-varlog，日志采集路径为/var/log/*.log的配置，对应的日志服务采集配置名称也是log-varlog，目的是将容器的/var/log/*.log文件内容采集到log-varlog这个Logstore中。
  2. 创建自定义Tag规则：
    - name: aliyun_logs_mytag1_tags value: tag1=v1
    配置Tag后，当采集到该容器的日志时，会自动附加对应的字段到日志服务。其中mytag1为只能包含小写字母、数字和短划线（-）的名称。
2. 如果您的采集配置中指定了非stdout的采集路径，需要在此部分创建相应的volumeMounts。示例中采集配置添加了对/var/log/*.log的采集，因此相应地添加了/var/log的volumeMounts。
配置完YAML模板后，单击创建。

步骤二：配置环境变量的高级参数

通过容器环境变量配置采集支持多种配置参数，您可根据实际需求设置高级参数来实现日志采集的特殊需求。

重要通过容器环境变量配置采集日志的方式不适用边缘场景。


字段	说明	示例	注意事项
aliyun_logs_{key}	必选项。{key}只能包含小写字母、数字和短划线（-）。若不存在aliyun_logs_{key}_logstore，则默认创建并采集到名为{key}的logstore。当值为stdout表示采集容器的标准输出；其他值为容器内的日志路径。	`- name: aliyun_logs_catalina stdout` `- name: aliyun_logs_access-log /var/log/nginx/access.log`	默认采集方式为极简模式，如需解析日志内容，建议使用日志服务控制台。 {key}需保持在K8s集群内唯一。
aliyun_logs_{key}_tags	可选。值为{tag-key}={tag-value}类型，用于对日志进行标识。	`- name: aliyun_logs_catalina_tags app=catalina`	-
aliyun_logs_{key}_project	可选。值为指定的日志服务Project。当不存在该环境变量时为您安装时所选的Project。	`- name: aliyun_logs_catalina_project my-k8s-project`	Project需与您的Logtail工作所在Region一致。
aliyun_logs_{key}_logstore	可选。值为指定的日志服务Logstore。当不存在该环境变量时Logstore和{key}一致。	`- name: aliyun_logs_catalina_logstore my-logstore`	-
aliyun_logs_{key}_shard	可选。值为创建Logstore时的shard数，有效值为1~10。当不存在该环境变量时值为2。	`- name: aliyun_logs_catalina_shard 4`	-
aliyun_logs_{key}_ttl	可选。值为指定的日志保存时间，有效值为1~3650。当取值为3650时，指定日志的保存时间为永久保存。当不存在该环境变量时，默认指定日志的保存时间为90天。	`- name: aliyun_logs_catalina_ttl 3650`	-
aliyun_logs_{key}_machinegroup	可选。值为应用的机器组。当不存在该环境变量时与安装Logtail的默认机器组一致。	`- name: aliyun_logs_catalina_machinegroup my-machine-group`	-

定制需求1：将多个应用数据采集到同一Logstore
如果您需要将多个应用数据采集到同一Logstore，可以设置 aliyun_logs_{key}_logstore参数，例如以下配置将2个应用的stdout采集到stdout-logstore中。

示例中应用1的{key}为app1-stdout，应用2的{key}为app2-stdout。
应用1设置的环境变量为：
```
######### 配置环境变量 ###########
    - name: aliyun_logs_app1-stdout
      value: stdout
    - name: aliyun_logs_app1-stdout_logstore
      value: stdout-logstore
```
应用2设置的环境变量为：
```
######### 配置环境变量 ###########
    - name: aliyun_logs_app2-stdout
      value: stdout
    - name: aliyun_logs_app2-stdout_logstore
      value: stdout-logstore
```
定制需求2：将不同应用数据采集到不同的Project
如果您需要将不同应用的数据采集到多个Project中，您需要进行以下操作：
1. 在每个Project中创建一个机器组，选择自定义标识，标识名为k8s-group-{cluster-id}，其中{cluster-id}为您的集群ID，机器组名称您可以自定义配置。
2. 每个应用的环境变量中配置project、logstore、machinegroup信息，其中机器组名称为您在上一步创建的机器组名。
  如下示例中应用1的{key}为app1-stdout，应用2的{key}为app2-stdout。其中如果两个应用在同一个K8s集群中，对应machinegroup可以使用同一个machinegroup。
  应用1设置的环境变量为：
```
######### 配置环境变量 ###########
    - name: aliyun_logs_app1-stdout
      value: stdout
    - name: aliyun_logs_app1-stdout_project
      value: app1-project
    - name: aliyun_logs_app1-stdout_logstore
      value: app1-logstore
    - name: aliyun_logs_app1-stdout_machinegroup
      value: app1-machine-group
```
  应用2设置的环境变量为：
```
######### 应用2 配置环境变量 ###########
    - name: aliyun_logs_app2-stdout
      value: stdout
    - name: aliyun_logs_app2-stdout_project
      value: app2-project
    - name: aliyun_logs_app2-stdout_logstore
      value: app2-logstore
    - name: aliyun_logs_app2-stdout_machinegroup
      value: app1-machine-group
```

步骤三：查看日志

在容器服务控制台查看应用容器的日志的具体步骤如下。

登录容器服务管理控制台，在左侧导航栏中选择集群。
在集群列表页面中，单击目标集群名称，然后在左侧导航栏中，选择运维管理 > 日志中心。
在日志中心页面，单击应用日志页签，设置检索条件后单击选择日志库，查看应用容器的相关日志。