除IP地址外,您还可以使用用户自定义标识(Custom ID)来动态定义机器组。

自定义标识机器组在以下场景中具有明显优势:

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

操作步骤

  1. 在服务器上设置用户自定义标识。
    • Linux Logtail

      通过文件/etc/ilogtail/user_defined_id 来设置用户自定义标识。

      例如,设置用户自定义标识如下:

      # vim /etc/ilogtail/user_defined_id

      在该文件中输入userdefined

    • Windows Logtail

      通过文件C:\LogtailData\user_defined_id来设置用户自定义标识。

      例如,设置用户自定义标识如下:

      C:\LogtailData>more user_defined_id
      userdefined_windows
    说明
    • 同一机器组中不允许同时存在Linux和Windows服务器,请勿在Linux和Windows服务器上配置同样的用户自定义标识。
    • 一个服务器可配置多个用户自定义标识,标识之间以换行符分割。
    • 若目录 /etc/ilogtail/C:\LogtailData或文件/etc/ilogtail/user_defined_idC:\LogtailData\user_defined_id不存在,请手动创建。
  2. 创建机器组。
    1. 登录日志服务控制台,单击Project名称。
    2. 单击左侧导航栏中的Logtail机器组
    3. 机器组列表页面单击右上角的创建机器组
    4. 填写机器组配置。
      • 机器组名称:填写机器组名称。

        机器组名称只能包含小写字母、数字、连字符(-)和下划线(_)且必须以小写字母或数字开头和结尾,长度为3~128字节。

        说明 不支持修改机器组名称,请谨慎填写。
      • 机器组标识:选择用户自定义标识
      • (可选)机器组Topic:填写机器组Topic,详细信息请参考文本-生成主题
      • 用户自定义标识:填写步骤一中配置的用户自定义标识。


    5. 单击确认结束配置。
      说明 需要扩容服务器时,只需要在新服务器上设置用户自定义标识即可。
  3. 查看机器组状态。
    机器组列表页面,单击目标机器组 操作列的 查看状态,可以查看使用相同用户自定义标识的服务器列表及其心跳状态。

禁用用户自定义标识

如果想恢复使用服务器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系统

    Windows控制面板 > 管理工具 > 服务,在服务列表中右键单击LogtailWorker服务,选择重新启动以使配置生效。

示例

系统通常由多个模块组成,每个模块可以包含多台服务器。比如常见网站分为前端HTTP请求处理模块、缓存模块、逻辑处理模块和存储模块,每个模块可以进行单独的水平扩展,因此在新增服务器时需要能够对其进行实时日志采集。

  1. 创建自定义标识。

    安装完成Logtail客户端后,为服务器开启用户自定义标识。对于示例场景中的模块可以分别分成4类机器标识:http_module、cache_module、logic_module和store_module。

  2. 创建机器组。

    创建机器组时,用户自定义标识请填写机器组名称对应的用户自定义标识。http_module机器组如下图所示:



  3. 可以在机器组查看状态中查看使用相同自定义标识的服务器列表及其心跳状态。


  4. 若前端模块增加服务器10.1.1.3,只需在新服务器上开启用户自定义标识。成功执行操作后可以在机器组查看状态中看到新增服务器。