日志服务支持将多台服务器上的日志采集到一个Logstore中。这些服务器可以组成一个机器组,也可以组成多个独立的机器组。通过将Logtail采集配置应用到指定的机器组,日志服务便会将该配置下发至机器组内的所有服务器,从而采集服务器上的日志。本文介绍如何在日志服务Project中创建、查看、修改和删除机器组。
创建机器组
前提条件
已创建Project。具体操作,请参见创建项目Project。
服务器已安装Logtail,安装步骤请参见安装Logtail(Linux系统)或安装Logtail(Windows系统)。如果日志服务Project与ECS实例属于同一地域,您可在创建Logtail采集配置时自动安装Logtail。具体操作,请参见安装Logtail(ECS实例)。
服务器已配置用户标识。如果日志服务Project与服务器属于同一阿里云账号,则无需配置用户标识。
操作步骤
日志服务Project支持使用IP地址或用户自定义标识创建机器组。使用IP地址创建相对更简单,但使用用户自定义标识具有以下优势,推荐使用。
在VPC等自定义网络环境中,可能出现服务器IP地址冲突问题,导致Logtail采集失败。使用用户自定义标识可避免此类情况发生。
使用用户自定义标识可实现机器组的弹性伸缩。为新增的服务器配置相同的用户自定义标识,日志服务可自动识别,并将其添加至机器组中。如果不再需要采集服务器日志,直接删除在服务器上配置的用户自定义标识文件,日志服务可自动将该服务器从机器组中移除。
创建IP地址机器组
获取服务器IP地址。
在已安装Logtail的服务器,打开app_info.json文件,并查看
ip
字段的值。app_info.json文件路径说明如下所示。
操作系统
Logtail
app_info.json文件路径
Linux
Logtail(64位程序)
/usr/local/ilogtail/app_info.json
Windows(64位操作系统)
Logtail(64位程序)
C:\Program Files\Alibaba\Logtail\app_info.json
Logtail(32位程序)
C:\Program Files (x86)\Alibaba\Logtail\app_info.json
Windows (32位操作系统)
Logtail(32位程序)
C:\Program Files\Alibaba\Logtail\app_info.json
Logtail自动获取的服务器IP地址记录在app_info.json文件的
ip
字段中,如下所示。
登录日志服务控制台,在Project列表,单击打开目标Project。
左侧导航栏中,选择
。在打开的机器组页面中,选择机器组右侧的 。在弹出的创建机器组页面,填写以下信息,并单击确定。
参数
说明
名称
机器组名称,命名规则如下所示:
只能包括小写字母、数字、短划线(-)和下划线(_)。
必须以小写字母或者数字开头和结尾。
长度必须在 2~128 字符之间。
重要创建后,不支持修改机器组名称,请谨慎填写。
机器组标识
选择IP地址。
机器组Topic
(可选)机器组Topic用于区分不同服务器产生的日志数据。更多信息,请参见日志主题。
IP地址
填入上述步骤中获取的服务器IP地址。
重要存在多台服务器时,请手动输入对应的IP地址,IP地址之间需使用换行符分隔。
同一机器组中不允许同时存在Linux和Windows服务器。请勿将Windows和Linux服务器IP添加到同一机器组中。
创建用户自定义标识机器组
在指定目录下创建用户自定义标识文件
user_defined_id
并配置用户自定义标识。重要同一机器组中不允许同时存在Linux和Windows服务器,请勿在Linux和Windows服务器上配置相同的用户自定义标识。
一个服务器可配置多个用户自定义标识,标识之间以换行符分割。
用户自定义标识文件存放路径:
Linux:/etc/ilogtail/user_defined_id。
Windows:C:\LogtailData\user_defined_id。
如果目录
/etc/ilogtail/
、C:\LogtailData
或文件/etc/ilogtail/user_defined_id
、C:\LogtailData\user_defined_id
不存在,请手动创建。
Linux环境
在Linux服务器配置用户自定义标识,可使用以下命令完成。
echo "user-defined-linux-1" > /etc/ilogtail/user_defined_id
检查用户自定义标识是否写入成功,可使用以下命令。
[root@test-host ~]# cat /etc/ilogtail/user_defined_id user-defined-linux-1
新增、删除、修改user_defined_id文件后,默认情况下,1分钟内生效。如果需要立即生效,请执行以下命令重启Logtail。
/etc/init.d/ilogtaild stop /etc/init.d/ilogtaild start
Windows环境
在Windows服务配置用户自定义标识,可在
C:\LogtailData\user_defined_id
文件中输入user-defined-windows-1
,并保存。检查用户自定义标识是否写入成功,可打开
C:\LogtailData\user_defined_id
文件直接查看。新增、删除、修改user_defined_id文件后,默认情况下,1分钟内生效。如果需要立即生效,请执行以下命令重启Logtail。
选择
。在服务对话框中,选择对应的服务。
如果是0.x.x.x版本,选择LogtailWorker服务。
如果是1.0.0.0及以上版本,选择LogtailDaemon服务。
右键单击重新启动使配置生效。
容器环境
用户自定义标识配置在Logtail容器的环境变量
ALIYUN_LOGTAIL_USER_DEFINED_ID
中,可通过docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID
命令查看。登录日志服务控制台,在Project列表,单击打开目标Project。
左侧导航栏中,选择
。在打开的机器组页面中,选择机器组右侧的 。在弹出的创建机器组页面,填写以下信息,并单击确定。
参数
说明
名称
机器组名称,命名规则如下所示:
只能包括小写字母、数字、短划线(-)和下划线(_)。
必须以小写字母或者数字开头和结尾。
长度必须在 2~128 字符之间。
重要创建后,不支持修改机器组名称,请谨慎填写。
机器组标识
选择用户自定义标识。
机器组Topic
(可选)机器组Topic用于区分不同服务器产生的日志数据。更多信息,请参见日志主题。
用户自定义标识
填入上述步骤中配置的用户自定义标识。
查看机器组
在机器组列表中,单击目标机器组。在机器组配置页面,可查看机器组配置信息以及服务器状态。
心跳状态为OK表示服务器上的Logtail实例与日志服务Project连接正常。
如果心跳状态显示FAIL,处理操作请参见Logtail机器组问题排查思路(主机场景)。
重要创建机器组大约需要2分钟。创建未生效,将导致心跳为FAIL。请2分钟后单击刷新进行重试。
修改机器组
在机器组列表中,单击目标机器组。然后在机器组配置页面,单击页面右上角的修改。
在机器组信息区域可切换机器组标识,更新机器组Topic。如果是用户自定义标识机器组,可更新用户自定义标识。如果是IP地址机器组,可增删改IP地址。
在管理配置区域可Logtail配置应用到该机器组,或删除已生效Logtail配置。
重要添加Logtail配置到机器组后,该Logtail配置会被下发到机器组内的服务器的Logtail上。
从机器组移除Logtail配置后,该Logtail配置会从机器组内的服务器的Logtail上移除。
修改完成后,单击保存。
删除机器组
在机器组列表中,选择目标机器组对应的
。在弹出的对话框中,输入机器组名称,并单击确认。
相关文档
在日志服务Project中创建Logtail配置。更多信息,请参见采集主机文本日志。
管理机器组的API请参见: