2018-06-04

通过Logtail采集服务器日志可以通过以下步骤完成

1.安装Logtail。
2.创建用户标识（非阿里云ECS）。从阿里云ECS采集日志不需要执行此步骤。
3.创建机器组。日志服务通过机器组的方式管理所有需要通过Logtail客户端采集日志的服务器。日志服务支持通过IP或者自定义标识的方式定义机器组。您也可以在应用Logtail配置到机器组时，根据提示创建机器组。
4.创建Logtail采集配置，并应用到机器组。您可以通过数据接入向导创建Logtail配置以 采集文本文件、收集syslog日志等，并将该Logtail配置应用到机器组。

标准docker日志采集

安装Logtail

步骤一 部署Logtail容器

1.拉取Logtail镜像

docker pull registry.cn-hangzhou.aliyuncs.com/log-service/logtail

2.启动Logtail容器

替换启动模板中的3个参数：${your_region_name}、${your_aliyun_user_id}和${your_machine_group_user_defined_id}

docker run -d -v /:/logtail_host:ro -v /var/run/docker.sock:/var/run/docker.sock --env ALIYUN_LOGTAIL_CONFIG=/etc/ilogtail/conf/${your_region_name}/ilogtail_config.json --env ALIYUN_LOGTAIL_USER_ID=${your_aliyun_user_id} --env ALIYUN_LOGTAIL_USER_DEFINED_ID=${your_machine_group_user_defined_id} registry.cn-hangzhou.aliyuncs.com/log-service/logtail

参数说明

参数	参数说明
${your_region_name}	region名，请替换为您创建的日志服务project所在Region。Region名称请从Logtail安装参数列表中选择。
${your_aliyun_user_id}	用户标识，请替换为您的阿里云主账号用户ID。主账号用户ID为字符串形式。
${your_machine_group_user_defined_id}	您集群的机器组自定义标识。如您尚未开启自定义标识，请参考自定义机器组的步骤一，开启userdefined-id。

注意事项

您可以自定义配置Logtail容器的启动参数，只需保证以下前提条件：
1.启动时，必须具备3个环境变量：ALIYUN_LOGTAIL_USER_DEFINED_ID、ALIYUN_LOGTAIL_USER_ID、ALIYUN_LOGTAIL_CONFIG。

2.必须将Docker的Domain Socket挂载到/var/run/docker.sock。

3.如果您需要采集其他容器或宿主机文件，需要将根目录挂载到Logtail容器的/logtail_host目录。

步骤二 配置机器组

1.开通日志服务并创建Project、Logstore。
2.在日志服务控制台的机器组列表页面单击创建机器组。
3.选择用户自定义标识，将您上一步配置的 ALIYUN_LOGTAIL_USER_DEFINED_ID填入用户自定义标识内容框中。

配置完成一分钟后，在机器组列表页面单击右侧的查看状态按钮，即可看到已经部署Logtail容器的心跳状态。具体参见机器组配置中的查看状态部分。

步骤三 创建采集配置

• 容器标准输出 默认配置

机器组标识

步骤一 开启userdefined-id

• Linux Logtail
  通过文件 /etc/ilogtail/user_defined_id 来设置userdefined-id。
  例如，设置自定义机器标志如下：

1.#cat /etc/ilogtail/user_defined_id
2.aliyun-ecs-rs1e16355

添加aliyun-ecs-rs1e16355 到机器组，1分钟之内即可生效。
注意：若目录 /etc/ilogtail/或文件 /etc/ilogtail/user_defined_id不存在，请手动创建。

步骤二 创建机器组（即安装Logtail中的步骤二）

1.在机器组列表页面单击右上角的创建机器组。

2.填写机器组配置。

• 机器组名称。填写自定义的机器组名称。

• 机器组标识。选择用户自定义标识。

• 用户自定义标识。填写步骤一中配置的userdefined-id。

3.单击确认结束配置。需要扩容机器时，只需要在新服务器上执行步骤一即可

步骤三 查看机器组状态

在机器组列表页面，单击目标机器组右侧的查看状态，可以查看使用相同自定义标识的机器列表及其心跳状态。

其他操作

禁用 userdefined-id

如果想恢复使用机器IP作为标识，请删除user_defined_id文件，1分钟之内即可生效。

• Linux Logtail

1.rm -f /etc/ilogtail/user_defined_id

生效时间

新增、删除、修改user_defined_id文件后，默认情况下，1分钟之内即可生效。

如需立即生效，请执行以下命令重启Logtail：

• Linux Logtail

1./etc/init.d/ilogtaild stop
2./etc/init.d/ilogtaild start

非本人ECS（或线下机器）

配置用户标识

1.查看阿里云账号ID

登陆 阿里云账号管理页面，查看日志服务Project所属账号的ID（主账号id）。

2. 在服务器上配置账号ID标识文件

• Linux系统
  创建账号ID同名文件到 /etc/ilogtail/users 目录，如目录不存在请手动创建。
  一台机器上可以配置多个账号ID，例如：

1.touch /etc/ilogtail/users/{ACCOUNT_ID_A}
2.touch /etc/ilogtail/users/{ACCOUNT_ID_B}

当不需要Logtail采集数据到该用户的日志服务Project后，可删除用户标识：

1.rm /etc/ilogtail/users/{ACCOUNT_ID_A}

注意：

• 机器上配置账号ID标识后，表示该云账号有权限通过Logtail采集该机器上的日志数据。机器上不必要的账号标识文件请及时清理。
• 新增、删除用户标识后，1分钟之内即可生效。