通过Pod环境变量配置应用日志采集

1. 登录容器计算服务(ACS)管理控制台，在左侧导航栏选择集群

2. 在集群列表页面，单击目标集群名称或者目标集群右侧操作列下的详情。

3. 在集群管理页左侧导航栏中，选择运维管理>组件管理，并在日志与监控区域找到alibaba-log-controller。

4. 在alibaba-log-controller组件右侧，单击安装，并在安装组件对话框中单击确定。

通过控制台向导创建应用并配置日志服务

1. 登录容器计算服务(ACS)管理控制台，在左侧导航栏选择集群

2. 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择工作负载 > 无状态。

3. 在无状态页面上方的命名空间下拉框中设置命名空间，然后单击页面右上角的使用镜像创建。注意：此处是以无状态应用为例子，对于其它类型的工作负载（例如：有状态）配置方式相同。

4. 在应用基本信息页签，设置应用名称、副本数量和类型，单击下一步，进入容器配置页面。

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

5. 在日志配置区域，配置日志相关信息。

   1. 设置采集配置。

      单击+图标创建新的采集配置，每个采集配置由日志库和容器内日志路径两项构成。

      • 日志库：配置Logstore名称，用于指定所采集日志存储于该Logstore。如果该Logstore不存在，ACK将会自动为您在集群关联的日志服务Project下创建相应的Logstore。

        说明

        新创建的Logstore中的日志默认保存时间为180天。

      • 容器内日志路径：指定希望采集的日志所在的路径，例如使用/usr/local/tomcat/logs/catalina.*.log来采集Tomcat的文本日志。

        说明

        指定为stdout时，表示采集容器的标准输出和标准错误输出。

        每一项采集配置都会被自动创建为对应Logstore的一个采集配置，默认采用极简模式（按行）进行采集。如果您需要更丰富的采集方式，请参见通过控制台方式采集容器文本日志、通过控制台方式采集容器标准输出。

      

   2. 设置自定义Tag。

      单击+图标创建新的自定义Tag，每一个自定义Tag都是一个键值对，会拼接到所采集到的日志中，您可以使用它来为容器的日志数据进行标记，例如版本号。

      

6. 当完成所有配置后，可单击右上角的下一步进入后续流程。

   后续操作，可参见创建无状态工作负载Deployment。

通过YAML模板创建

1. 登录容器计算服务(ACS)管理控制台，在左侧导航栏选择集群

2. 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择工作负载 > 无状态。

3. 在无状态页面上方的命名空间下拉框中设置命名空间，然后单击页面右上角的使用YAML创建资源。注意：此处是以无状态应用为例子，对于其它类型的工作负载（例如：有状态）配置方式相同。

4. 配置YAML文件。

   YAML模板的语法同Kubernetes语法，但是为了给容器指定采集配置，需要使用env来为容器增加采集配置和自定义Tag。以下是一个简单的Pod示例：

   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

   根据您的需求按照以下顺序进行配置。

   说明

   如果您有更多的日志采集需求，请参见步骤三：日志采集的高级参数设置。

   1. 通过环境变量来创建您的采集配置和自定义Tag，所有与配置相关的环境变量都采用aliyun_logs_作为前缀。

      • 创建采集配置的规则如下：

        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                        

        示例中创建了两个采集配置，格式为aliyun_logs_{key}，对应的{key}分别为log-stdout和log-varlog。

        • aliyun_logs_log-stdout：该env表示创建一个名为log-stdout的Logstore，日志采集路径为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中。

      • 创建自定义Tag的规则如下：

        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_mytag1_tags
              value: tag1=v1                       

        配置Tag后，当采集到该容器的日志时，会自动附加对应的字段到日志服务。其中mytag1为任意不包含'_'的名称。

   2. 如果您的采集配置中指定了非stdout的采集路径，需要在此部分创建相应的volumeMounts。

      示例中采集配置添加了对/var/log/*.log的采集，因此相应地添加了/var/log的volumeMounts。

5. 当YAML编写完成后，单击创建，即可将相应的配置交由Kubernetes集群执行。

日志服务控制台查看日志

1. 安装成功后，进入日志服务控制台。

2. 在进入控制台后，在Project列表区域选择Kubernetes集群对应的Project（默认为k8s-log-{Kubernetes集群ID}），进入日志库列表页签。

3. 在列表中找到相应的Logstore（采集配置中指定），将鼠标悬浮在相应的Logstore名称的右侧，单击图标，并单击查询分析。

   本例中，在日志查询页面，您可查看Tomcat应用的标准输出日志和容器内文本日志，并可发现自定义tag附加到日志字段中。