功能特点

限制说明

• 采集停止策略：当容器被停止后，Logtail监听到容器die的事件后会停止该容器日志的采集，若此时采集出现延迟，则可能丢失停止前的部分日志。
• Docker存储驱动限制：目前只支持overlay、overlay2，其他存储驱动需将日志所在目录挂载到宿主机上。
• 不支持采集软链接：目前Logtail无法访问业务容器的软链接，请按真实路径配置采集目录。

创建采集配置

1. 登录日志服务控制台。
2. 在接入数据区域，单击Kubernetes-文件。
3. 选择目标Project和Logstore，单击下一步。
4. 创建机器组，创建完成后单击确认安装完毕。

   根据页面提示创建机器组，如果您已有可用的机器组，可直接单击使用现有机器组。

5. 选中目标机器组，将该机器组从源机器组移动到应用机器组，单击下一步。
   注意 如果创建机器组后立刻应用，可能因为连接未生效，导致心跳为FAIL，您可单击自动重试。如果还未解决，请参见Logtail机器组无心跳进行排查。
6. 设置数据源，单击下一步。

   配置项	是否必选	说明
   是否为Docker文件	必须勾选	确认采集的目标文件是否为Docker文件。
   Label白名单	可选	如果要设置Label白名单，则LabelKey必填。如果LabelValue不为空，则只采集容器label中包含LabelKey=LabelValue的容器；如果LabelValue为空，则采集所有label中包含LabelKey的容器。 说明 多个键值对之间为或关系，即只要容器的label满足任一键值对即可被采集。 LabelValue默认为字符串匹配，即只有LabelValue和容器名称完全相同才会匹配。如果该值以^开头并且以$结尾，则为正则匹配，例如：LabelValue配置为^(kube-system|istio-system)$，可同时匹配kube-system和istio-system。 请勿设置相同的LabelKey，如果重名只生效一个。
   Label黑名单	可选	如果要设置Label黑名单，则LabelKey必填。如果LabelValue不为空，则只排除容器label中包含LabelKey=LabelValue的容器；如果LabelValue为空，则排除所有label中包含LabelKey的容器。 说明 多个键值对之间为或关系，即只要容器的label满足任一键值对即可被采集。 LabelValue默认为字符串匹配，即只有LabelValue和容器名称完全相同才会匹配。如果该值以^开头并且以$结尾，则为正则匹配，例如：LabelValue配置为^(kube-system|istio-system)$，可同时匹配kube-system和istio-system。 请勿设置相同的LabelKey，如果重名只生效一个。
   环境变量白名单	可选	如果要设置环境变量白名单，则EnvKey必填。如果EnvValue不为空，则只采集容器环境变量中包含EnvKey=EnvValue的容器；如果EnvValue为空，则采集所有环境变量中包含EnvKey的容器。 说明 多个键值对之间为或关系，即只要容器的环境变量满足任一键值对即可被采集。 EnvValue默认为字符串匹配，即只有EnvValue和容器名称完全相同才会匹配。如果该值以^开头并且以$结尾，则为正则匹配，例如：EnvValue配置为^(kube-system|istio-system)$，可同时匹配kube-system和istio-system。
   环境变量黑名单	可选	如果要设置环境变量黑名单，则EnvKey必填。如果EnvValue不为空，则只排除容器环境变量中包含EnvKey=EnvValue的容器；若EnvValue为空，则排除所有环境变量中包含EnvKey的容器。 说明 多个键值对之间为或关系，即只要容器的环境变量满足任一键值对即可被采集。 EnvValue默认为字符串匹配，即只有EnvValue和容器名称完全相同才会匹配。如果该值以^开头并且以$结尾，则为正则匹配，例如：EnvValue配置为^(kube-system|istio-system)$，可同时匹配kube-system和istio-system。
   其他配置项	无	其他采配置项及说明请参见概述。 说明 采集宿主机文本文件时，默认将宿主机根目录挂载到Logtail容器的/logtail_host目录。所以配置路径时，您需要加上此前缀。例如需要采集宿主机上/home/logs/app_log/目录下的日志，配置页面中日志路径设置为/logtail_host/home/logs/app_log/。

   说明

   • Kubernetes中的namespace和容器名会映射到Docker的Label中，分别为io.kubernetes.pod.namespace和io.kubernetes.container.name。例如您创建的Pod所属namespace为backend-prod，容器名为worker-server，则仅需将其中一个配置为Label白名单，以指定只采集该容器的日志，分别为io.kubernetes.pod.namespace : backend-prod或者io.kubernetes.container.name : worker-server。
   • Kubernetes中除io.kubernetes.pod.namespace和io.kubernetes.container.name外不建议使用其他Label。其他情况请使用环境变量白名单或环境变量黑名单。
7. 配置查询分析，单击下一步。
   默认已经创建索引，您也可以手动修改。

配置示例

• 环境变量配置方式

  例如：采集环境变量为NGINX_PORT_80_TCP_PORT=80且不为POD_NAMESPACE=kube-system的容器日志，日志文件路径为/var/log/nginx/access.log，日志解析方式为极简类型。

  
  本示例中数据源配置如下，日志格式解析内容请参见使用完整正则模式采集日志、使用Nginx模式采集日志和使用分隔符模式采集日志。
• Label配置方式
  采集label为io.kubernetes.container.name=nginx的容器日志，日志文件路径为/var/log/nginx/access.log，日志解析方式为极简类型。
  本示例中数据源配置如下，日志格式解析内容请参见使用完整正则模式采集日志、使用Nginx模式采集日志和使用分隔符模式采集日志。

默认字段