通过SLS采集ECI日志_弹性容器实例(ECI)-阿里云帮助中心

ECI支持对接阿里云日志服务SLS，将ECI日志采集到SLS中。本文介绍如何通过环境变量自定义配置ECI日志采集，包括指定项目、日志库、机器组等。

背景信息

阿里云日志服务SLS是针对日志数据的一站式服务，您无需开发就能快捷完成日志数据采集、消费、投递以及查询分析等功能。更多信息，请参见日志服务简介。

重要

日志服务按照您的实际使用量收费。关于日志服务如何计费，请参见计费概述。

默认情况下，创建ECI实例时如果开启了日志采集功能，系统会自动生成一个项目和一个机器组：

项目名称为eci-log-default-project-{Region}-{账号ID}。
机器组名称为eci-log-default-machine-group-{Region}。

如果您有自定义日志采集的需求，例如需要将日志收集到自定义的项目和日志库，或者需要将不同应用对应的ECI实例加入到不同的机器组，可以通过容器的环境变量传入日志相关的自定义配置，如果日志服务没有环境变量对应的项目、日志库和机器组等，系统将自动创建。

注意事项

仅在创建ECI实例时才能通过环境变量自定义配置日志采集，更新实例时传入的日志相关环境变量不会生效。
对于自定义配置的日志Project和Logtail配置，如果后续不再使用，请及时删除相关Project和Logtail配置，避免产生不必要的费用。

配置说明

创建ECI实例时，可以通过容器的环境变量传入日志相关的自定义配置，包括项目（Project）、日志库（Logstore）、Logtail配置、机器组（Machinegroup）、分区（Shard）、日志保留时间、标签（Tag）等。可配置的环境变量如下：

说明

日志相关环境变量名称的格式前缀为aliyun_logs_{key}，{key}表示日志服务中Logtail配置的名称，只能包含小写字母、数字和短划线（-）。

配置对象	环境变量名称	环境变量取值说明

配置对象	环境变量名称	环境变量取值说明
Logtail配置	aliyun_logs_{key}	创建Logtail配置。取值为日志采集路径。采集标准输出时，取值如下： stdout：采集正常输出和错误信息。 stderr-only：只采集错误信息，不采集正常输出。 stdout-only：只采集正常输出，不采集错误信息。采集文本文件时，取值为容器内的文件目录。
项目	aliyun_logs_{key}_project	指定Project。Project名称格式要求如下：长度为3~63个字符。仅支持小写字母、数字和短划线（-），且必须以小写字母和数字作为开头和结尾。说明项目名称必须全局唯一，创建后不可修改。如果名称格式校验不通过，将直接忽略该配置，采用默认项目。
日志库	aliyun_logs_{key}_logstore	指定Logstore。Logstore名称格式要求如下：长度为3~63个字符。仅支持小写字母、数字、短划线（-）和下划线（_），且必须以小写字母和数字作为开头和结尾。说明如果名称格式校验不通过，将直接忽略该配置，采用默认日志库。默认情况下，日志库名称与Logtail配置名称`{key}`相同。
机器组	aliyun_logs_{key}_machinegroup	指定机器组。机器组名称格式要求如下：长度为3~63个字符。仅支持小写字母、数字、短划线（-）和下划线（_），且必须以小写字母和数字作为开头和结尾。说明如果名称格式校验不通过，将直接忽略该配置，采用默认机器组。
分区	aliyun_logs_{key}_shard	设置日志分区数。取值范围为1~10。 Logstore读写日志必须保存在某一个分区上，默认情况下，每个日志库有2个分区。
日志保留时间	aliyun_logs_{key}_ttl	设置日志保留时间，单位为天。取值范围为1~3650。取值为3650时，表示永久保留日志。默认保留90天。
标签	aliyun_logs_{key}_tags	绑定标签。取值格式为`tag-key=tag-value`，用于对日志进行标识。

配置示例

假设您需要自定义以下日志相关配置项：

Logtail配置和Logstore名称：标准输出日志保存到stdout-eci，文本文件日志保存到file-eci。
Project名称：project-eci-test
机器组名称：mg-eci-test

说明

以下为示例配置，实际配置请使用您自定义的配置，确保Project名称唯一。

OpenAPI

控制台

调用CreateContainerGroup接口创建ECI实例时，可以通过Container.N.EnvironmentVar.N.Key和Container.N.EnvironmentVar.N.Value来设置环境变量。示例如下：

ContainerGroupName=test-sls
Container.1.Name=busybox
Container.1.Image=registry-vpc.cn-shanghai.aliyuncs.com/eci_open/busybox:1.30
Container.1.Command.1=/bin/sh
Container.1.Arg.1=-c
Container.1.Arg.2=mkdir -p /log;while true; do echo hello world; date; echo hello sls >> /log/busy.log; sleep 1;done
# 采集标准输出
Container.1.EnvironmentVar.1.Key=aliyun_logs_stdout-eci
Container.1.EnvironmentVar.1.Value=stdout
Container.1.EnvironmentVar.2.Key=aliyun_logs_stdout-eci_project
Container.1.EnvironmentVar.2.Value=project-eci-test
Container.1.EnvironmentVar.3.Key=aliyun_logs_stdout-eci_machinegroup
Container.1.EnvironmentVar.3.Value=mg-eci-test
# 采集文本文件
Container.1.EnvironmentVar.4.Key=aliyun_logs_file-eci
Container.1.EnvironmentVar.4.Value=/log/*.log
Container.1.EnvironmentVar.5.Key=aliyun_logs_file-eci_project
Container.1.EnvironmentVar.5.Value=project-eci-test
Container.1.EnvironmentVar.6.Key=aliyun_logs_file-eci_machinegroup
Container.1.EnvironmentVar.6.Value=mg-eci-test

通过弹性容器实例控制台创建ECI实例时，您可以在容器配置区域选择容器，展开该容器的高级配置，然后打开环境变量开关，添加环境变量。示例如下：

设置环境变量采集日志.png

效果示例

在日志服务控制台找到目标Project，单击Project名称后进入日志库，可查看日志信息。示例如下：

标准输出

文本文件

日志-标准.png

日志-文本.png