日志服务支持使用用户自定义标识动态定义机器组,本文介绍如何创建自定义标识机器组。

前提条件

  • 已创建Project和Logstore。更多信息,请参见创建Project和Logstore
  • 已有一台及以上的服务器。
    • 如果是阿里云ECS,请确保ECS和日志服务Project属于同账号且同地域。
    • 如果是与日志服务属于不同账号的ECS、其他云厂商的服务器或自建IDC,请先配置用户标识。更多信息,请参见配置用户标识
  • 已在服务器上安装Logtail。更多信息,请参见安装Logtail(ECS实例)

背景信息

用户自定义标识机器组在以下场景中具有明显优势:
  • 在VPC等自定义网络环境中,可能出现不同服务器IP地址冲突的问题,导致日志服务无法管理Logtail。使用自定义标识可以避免此类情况的发生。
  • 多台服务器通过同一个自定义标识实现机器组弹性伸缩。您只需为新增的服务器配置相同的自定义标识,日志服务可自动识别,并将其添加至机器组中。

操作步骤

  1. 在指定目录下创建user_defined_id文件。
    • Linux服务器:/etc/ilogtail/user_defined_id
    • Windows服务器:C:\LogtailData\user_defined_id
  2. 在服务器上配置用户自定义标识。
    说明
    • 同一机器组中不允许同时存在Linux服务器、Windows服务器,请勿在Linux和Windows服务器上配置相同的用户自定义标识。
    • 一个服务器可配置多个用户自定义标识,标识之间以换行符分割。
    • 如果目录/etc/ilogtail/C:\LogtailData或文件/etc/ilogtail/user_defined_idC:\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,并保存。

  3. 登录日志服务控制台
  4. Project列表区域,单击目标Project。
  5. 在左侧导航栏中,单击机器组
  6. 选择机器组右侧的机器组 > 创建机器组
  7. 创建机器组对话框中,配置如下参数,单击确定
    参数 说明
    名称 名称只能包含小写字母、数字、连字符(-)和下划线(_)且必须以小写字母或数字开头和结尾,长度为2~128字符。
    注意 创建后,不支持修改机器组名称,请谨慎填写。
    机器组标识 选择用户自定义标识
    机器组Topic 机器组Topic用于区分不同服务器产生的日志数据。更多信息,请参见日志主题
    用户自定义标识 配置为2中配置的用户自定义标识。
  8. 查看机器组状态。
    1. 在机器组列表中,单击目标机器组。
    2. 机器组配置页面,可看到使用相同用户自定义标识的服务器及其心跳状态。
      • 机器组状态中的IP列表,即为使用相同用户自定义标识的服务器的IP地址。例如:

        假设当前为用户自定义标识机器组,用户自定义标识为userdefined,机器组状态中的IP分别为10.10.10.10、10.10.10.11、10.10.10.12。则表示您在这三个服务器上创建了相同的用户自定义标识userdefined。如果您需要新增10.10.10.13服务器,则只需要在该服务器上创建用户自定义标识userdefined,即可在机器组状态中看到该服务器。

      • 心跳OK表示服务器与日志服务的连接正常,如果显示FAIL请参见Logtail机器组无心跳
      机器组状态

禁用用户自定义标识

如果您要恢复服务器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系统
    1. 选择开始 > 控制面板 > 管理工具 > 服务
    2. 服务对话框中,选择对应的服务。
      • 如果是0.x.x.x版本,选择LogtailWorker服务。
      • 如果是1.0.0.0及以上版本,选择LogtailDaemon服务。
    3. 右键单击重新启动使配置生效。