日志服务支持使用用户自定义标识动态定义机器组,本文介绍创建自定义标识机器组的操作步骤。
前提条件
已创建Project和Logstore。更多信息,请参见创建项目Project和创建Logstore。
已安装Logtail,安装步骤请参见安装Logtail(Linux系统)、安装Logtail(Windows系统)。对于本账号与日志服务Project相同地域的ECS实例,安装步骤请参见安装Logtail(ECS实例)。
已配置用户标识。对于本账号的ECS实例,无需配置用户标识。
背景信息
用户自定义标识机器组在以下场景中具有明显优势:
在VPC等自定义网络环境中,可能出现不同服务器IP地址冲突的问题,导致日志服务无法管理Logtail。使用自定义标识可以避免此类情况的发生。
多台服务器通过同一个自定义标识实现机器组的弹性伸缩。您只需为新增的服务器配置相同的自定义标识,日志服务可自动识别,并将其添加至机器组中。
操作步骤
在指定目录下创建user_defined_id文件。
Linux服务器:/etc/ilogtail/user_defined_id
Windows服务器:C:\LogtailData\user_defined_id
在服务器上配置用户自定义标识。
重要同一机器组中不允许同时存在Linux服务器、Windows服务器,即请勿在Linux和Windows服务器上配置相同的用户自定义标识。
一个服务器可配置多个用户自定义标识,标识之间以换行符分割。
如果目录/etc/ilogtail/、C:\LogtailData或文件/etc/ilogtail/user_defined_id、C:\LogtailData\user_defined_id不存在,请手动创建。
Linux服务器
在/etc/ilogtail/user_defined_id文件中配置用户自定义标识。例如:您要配置用户自定义标识为
userdefined
,则执行如下命令编辑文件,在文件中输入userdefined
,并保存。vim /etc/ilogtail/user_defined_id
Windows服务器
在C:\LogtailData\user_defined_id文件中配置用户自定义标识。例如:您要配置用户自定义标识为
userdefined_windows
,则在C:\LogtailData\user_defined_id文件中输入userdefined_windows
,并保存。
登录日志服务控制台。
在Project列表区域,单击目标Project。
在左侧导航栏中,选择 。
选择机器组右侧的 。
在创建机器组面板中,配置如下参数,然后单击确定。
查看机器组状态。
在机器组列表中,单击目标机器组。
在机器组配置页面,查看使用相同用户自定义标识的服务器及其心跳状态。
机器组状态中的IP列表,即为使用相同用户自定义标识的服务器的IP地址。例如:
假设当前为用户自定义标识机器组,用户自定义标识为userdefined,机器组状态中的IP分别为10.10.10.10、10.10.10.11、10.10.10.12。则表示您在这三个服务器上创建了相同的用户自定义标识userdefined。如果您需要新增10.10.10.13服务器,则只需要在该服务器上创建用户自定义标识userdefined,即可在机器组状态中看到该服务器。
心跳为OK表示服务器上的Logtail实例与日志服务的连接正常,如果显示FAIL请参见Logtail机器组无心跳处理。
重要创建机器组后立刻查看状态,可能因为连接未生效,导致心跳为FAIL,您可单击刷新进行重试。
禁用用户自定义标识
如果您要恢复服务器IP地址作为标识,请删除user_defined_id文件,1分钟内生效。
Linux系统
rm -f /etc/ilogtail/user_defined_id
Windows系统
del C:\LogtailData\user_defined_id
生效时间
新增、删除、修改user_defined_id文件后,默认情况下,1分钟内生效。如果需要立即生效,请执行以下命令重启Logtail。
Linux系统
/etc/init.d/ilogtaild stop /etc/init.d/ilogtaild start
Windows系统
选择
。在服务对话框中,选择对应的服务。
如果是0.x.x.x版本,选择LogtailWorker服务。
如果是1.0.0.0及以上版本,选择LogtailDaemon服务。
右键单击重新启动使配置生效。