创建用户自定义标识机器组

日志服务支持使用用户自定义标识动态定义机器组,本文介绍创建自定义标识机器组的操作步骤。

前提条件

背景信息

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

  • 在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。

    image

  5. 在左侧导航栏中,选择资源 > 机器组

  6. 选择机器组右侧的机器组 > 创建机器组

  7. 创建机器组面板中,配置如下参数,然后单击确定

    参数

    说明

    名称

    设置机器组的名称。

    重要

    创建后,不支持修改机器组名称,请谨慎填写。

    机器组标识

    选择用户自定义标识

    机器组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表示服务器上的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系统

    1. 选择开始 > 控制面板 > 管理工具 > 服务

    2. 服务对话框中,选择对应的服务。

      • 如果是0.x.x.x版本,选择LogtailWorker服务。

      • 如果是1.0.0.0及以上版本,选择LogtailDaemon服务。

    3. 右键单击重新启动使配置生效。