阿里云容器服务Kubernetes集群集成了日志服务,您可在创建集群时启用日志服务,快速采集Kubernetes集群的容器日志,包括容器的标准输出以及容器内的文本文件。

新建Kubernetes集群

如果您尚未创建任何的Kubernetes集群,可以按照本节的步骤进行操作:

  1. 登录容器服务管理控制台
  2. 在控制台左侧导航栏中,选择集群 > 集群
  3. 单击右上角的创建Kubernetes集群,进入创建页面后,参见创建Kubernetes集群进行配置。
  4. 拖动到页面底部,勾选日志服务配置项,表示在新建的Kubernetes集群中安装日志插件。
  5. 当勾选了使用日志服务后,会出现创建Project(日志服务管理日志的组织结构,具体可见项目)的提示,目前有两种方式可选。
    • 选择一个现有的Project来管理采集的日志。
      新建集群采集日志1
    • 自动创建一个新的Project来管理采集的日志,Project会自动命名为k8s-log-{ClusterID},ClusterID表示您新建的Kubernetes集群的唯一标识。
      采集日志2
  6. 配置完成后,单击右上角创建集群,在弹出的窗口中单击确定,完成创建。
    完成创建后,您可在集群列表页面看到创建的Kubernetes集群。
    创建集群

安装日志服务组件logtail

如果您先前已创建了Kubernetes集群,可以根据本节的内容来进行所需的操作以使用日志服务。

  1. 登录容器服务管理控制台
  2. 在左侧导航栏,单击集群 > 集群进入集群列表页面。
  3. 在目标集群右侧操作列,单击管理进入集群基本信息页面
    集群列表
  4. 在左侧导航栏中,单击组件管理,并在可选组件区域找到logtail-ds
  5. logtail-ds组件右侧,单击安装
    logtail安装

升级日志服务组件logtail

如果您已安装旧版本的日志服务组件,可按照安装日志服务组件logtail的步骤找到logtail-ds,并在logtail-ds组件右侧,单击升级logtail-ds升级

创建应用时配置日志服务

在容器服务中,您可以在创建应用的同时配置日志服务对容器的日志进行采集,目前支持以控制台向导和YAML模板两种方式进行创建。

控制台向导创建

  1. 登录容器服务管理控制台
  2. 在控制台左侧导航栏中,选择应用 > 无状态,然后单击页面右上角的使用镜像创建
  3. 设置应用名称部署集群命名空间副本数量类型,单击下一步,进入容器配置页面。
    容器配置页面
  4. 进入容器配置页面中,本例中选择nginx镜像,对容器采集进行配置。
    以下仅介绍日志服务相关的配置,其他的应用配置可参见使用镜像创建无状态Deployment应用
  5. 进行日志配置。单击+号创建新的采集配置,每个采集配置由Logstore名称日志采集路径两项构成。
    • Logstore名称:您可以使用它来指定所采集日志存储于哪个Logstore,如果该Logstore不存在的话,我们会自动为您在集群关联的日志服务Project下创建相应的Logstore。
      说明 名称中不能包含下划线(_),可以使用 - 来代替。
    • 日志采集路径:您可以用它来指定希望采集的日志所在的路径,如使用/usr/local/tomcat/logs/catalina.*.log 来采集tomcat的文本日志。
      说明 如果指定为stdout则表示采集容器的标准输出和标准错误输出。

      每一项采集配置都会被自动创建为对应Logstore的一个采集配置,默认采用极简模式(按行)进行采集,如果您需要更丰富的采集方式,可以前往日志服务控制台,进入相应的Project(默认是k8s-log前缀)和Logstore对配置进行修改。

    配置Logstore
  6. 自定义Tag。
    单击+号创建新的自定义Tag,每一个自定义Tag都是一个键值对,会拼接到所采集到的日志中,您可以使用它来为容器的日志数据进行标记,例如版本号。
    自定义tag
  7. 当完成所有配置后,可单击右上角的下一步进入后续流程,后续操作可参见使用镜像创建无状态Deployment应用

使用YAML模板创建

  1. 在Kubernetes菜单下,单击左侧导航栏中的应用 > 无状态,然后单击页面右上角的使用模板创建
  2. YAML模板的语法同Kubernetes语法,但是为了给容器指定采集配置,需要使用env来为container增加采集配置自定义Tag,并根据采集配置,创建对应的volumeMounts和volumes。以下是一个简单的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
        ###############################
        ######### 配置volume mount ###########
        volumeMounts:
        - name: volumn-sls-mydemo
          mountPath: /var/log
      volumes:
      - name: volumn-sls-mydemo
        emptyDir: {}
      ###############################
    • 根据您的需求进行配置,一般按照顺序进行配置。
    • 第一部分通过环境变量来创建您的采集配置自定义Tag,所有与配置相关的环境变量都采用aliyun_logs_作为前缀。
      • 创建采集配置的规则如下:
        - name: aliyun_logs_{Logstore名称}
          value: {日志采集路径}                            

        示例中创建了两个采集配置,其中aliyun_logs_log-stdout这个env表示创建一个Logstore名字为log-stdout,日志采集路径为stdout的配置,从而将容器的标准输出采集到log-stdout这个Logstore中。

        说明 Logstore名称中不能包含下划线(_),可以使用 - 来代替。
      • 创建自定义Tag的规则如下:
        - name: aliyun_logs_{任意不包含'_'的名称}_tags
          value: {Tag名}={Tag值}                            
        配置Tag后,当采集到该容器的日志时,会自动附加对应的字段到日志服务。
    • 如果您的采集配置中指定了非stdout的采集路径,需要在此部分创建相应的volumnMounts。

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

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

环境变量高级配置

通过容器环境变量配置采集支持多种配置参数,您可根据实际需求设置高级参数来实现日志采集的特殊需求。
注意 通过容器环境变量配置采集日志的方式不适用边缘场景。
字段 说明 示例 注意事项
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
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_tags

   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设置的环境变量为:
    ######### 配置 环境变量 ###########
        - 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中创建的机器组名,例如:
      ######### 配置 环境变量 ###########
          - 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

查看日志

本例中查看通过控制台向导创建的tomcat应用的日志。完成配置后,tomcat应用的日志已被采集并存储到日志服务中,您可以通过以下步骤来查看您的日志:

  1. 安装成功后,进入日志服务控制台
  2. 在进入控制台后,在Project列表区域选择Kubernetes集群对应的Project(默认为k8s-log-{Kubernetes集群ID}),进入日志库列表页签。
  3. 在列表中找到相应的Logstore(采集配置中指定),将鼠标悬浮在相应的Logstore名称的右侧,单击button并单击查询分析
  4. 本例中,在日志查询页面,您可查看tomcat应用的标准输出日志和容器内文本日志,并可发现自定义tag附加到日志字段中。
    日志字段

更多信息

  1. 默认情况下,我们会使用极简模式来采集您的数据(按行采集、不解析),如果您需要更复杂的配置,可以参见以下日志服务文档并前往日志服务控制台进行配置修改。
  2. 除了通过控制台配置采集以外,您还可以直接通过CRD配置来对Kubernetes集群进行日志采集,具体可参见通过DaemonSet-CRD方式采集日志
  3. 对于异常的排查,可以参见Logtail排查简介