通过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分钟之内即可生效。