管理机器组

日志服务支持将多台服务器上的日志采集到一个Logstore中。这些服务器可以组成一个机器组,也可以组成多个独立的机器组。通过将Logtail采集配置应用到指定的机器组,日志服务便会将该配置下发至机器组内的所有服务器,从而采集服务器上的日志。本文介绍如何在日志服务Project中创建、查看、修改和删除机器组。

创建机器组

前提条件

操作步骤

说明

日志服务Project支持使用IP地址用户自定义标识创建机器组。使用IP地址创建相对更简单,但使用用户自定义标识具有以下优势,推荐使用。

  • VPC等自定义网络环境中,可能出现服务器IP地址冲突问题,导致Logtail采集失败。使用用户自定义标识可避免此类情况发生。

  • 使用用户自定义标识可实现机器组的弹性伸缩。为新增的服务器配置相同的用户自定义标识日志服务可自动识别,并将其添加至机器组中。如果不再需要采集服务器日志,直接删除在服务器上配置的用户自定义标识文件,日志服务可自动将该服务器从机器组中移除。

创建IP地址机器组

  1. 获取服务器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字段中,如下所示。IP地址

  2. 登录日志服务控制台,在Project列表,单击打开目标Project。

  3. 左侧导航栏中,选择资源 > 机器组。在打开的机器组页面中,选择机器组右侧的机器组 > 创建机器组image

  4. 在弹出的创建机器组页面,填写以下信息,并单击确定

    参数

    说明

    名称

    机器组名称,命名规则如下所示:

    • 只能包括小写字母、数字、短划线(-)和下划线(_)。

    • 必须以小写字母或者数字开头和结尾。

    • 长度必须在 2~128 字符之间。

    重要

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

    机器组标识

    选择IP地址

    机器组Topic

    (可选)机器组Topic用于区分不同服务器产生的日志数据。更多信息,请参见日志主题

    IP地址

    填入上述步骤中获取的服务器IP地址。

    重要
    • 存在多台服务器时,请手动输入对应的IP地址,IP地址之间需使用换行符分隔。

    • 同一机器组中不允许同时存在Linux和Windows服务器。请勿将Windows和Linux服务器IP添加到同一机器组中。

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

  1. 在指定目录下创建用户自定义标识文件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_idC:\LogtailData\user_defined_id不存在,请手动创建。

    Linux环境

    1. 在Linux服务器配置用户自定义标识,可使用以下命令完成。

      echo "user-defined-linux-1" > /etc/ilogtail/user_defined_id
    2. 检查用户自定义标识是否写入成功,可使用以下命令。

      [root@test-host ~]# cat /etc/ilogtail/user_defined_id
      user-defined-linux-1
    3. 新增、删除、修改user_defined_id文件后,默认情况下,1分钟内生效。如果需要立即生效,请执行以下命令重启Logtail。

      /etc/init.d/ilogtaild stop
      /etc/init.d/ilogtaild start

    Windows环境

    1. 在Windows服务配置用户自定义标识,可在C:\LogtailData\user_defined_id文件中输入user-defined-windows-1,并保存。

    2. 检查用户自定义标识是否写入成功,可打开C:\LogtailData\user_defined_id文件直接查看。

    3. 新增、删除、修改user_defined_id文件后,默认情况下,1分钟内生效。如果需要立即生效,请执行以下命令重启Logtail。

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

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

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

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

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

    容器环境

    用户自定义标识配置在Logtail容器的环境变量ALIYUN_LOGTAIL_USER_DEFINED_ID中,可通过docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID命令查看。

  2. 登录日志服务控制台,在Project列表,单击打开目标Project。

  3. 左侧导航栏中,选择资源 > 机器组。在打开的机器组页面中,选择机器组右侧的机器组 > 创建机器组image

  4. 在弹出的创建机器组页面,填写以下信息,并单击确定

    参数

    说明

    名称

    机器组名称,命名规则如下所示:

    • 只能包括小写字母、数字、短划线(-)和下划线(_)。

    • 必须以小写字母或者数字开头和结尾。

    • 长度必须在 2~128 字符之间。

    重要

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

    机器组标识

    选择用户自定义标识

    机器组Topic

    (可选)机器组Topic用于区分不同服务器产生的日志数据。更多信息,请参见日志主题

    用户自定义标识

    填入上述步骤中配置的用户自定义标识。

查看机器组

机器组列表中,单击目标机器组。在机器组配置页面,可查看机器组配置信息以及服务器状态。image

  • 心跳状态为OK表示服务器上的Logtail实例与日志服务Project连接正常。

  • 如果心跳状态显示FAIL,处理操作请参见Logtail机器组问题排查思路(主机场景)

    重要

    创建机器组大约需要2分钟。创建未生效,将导致心跳为FAIL。请2分钟后单击刷新进行重试。

修改机器组

  1. 机器组列表中,单击目标机器组。然后在机器组配置页面,单击页面右上角的修改

  2. 机器组信息区域可切换机器组标识,更新机器组Topic。如果是用户自定义标识机器组,可更新用户自定义标识。如果是IP地址机器组,可增删改IP地址image

  3. 管理配置区域可Logtail配置应用到该机器组,或删除已生效Logtail配置

    重要
    • 添加Logtail配置到机器组后,该Logtail配置会被下发到机器组内的服务器的Logtail上。

    • 从机器组移除Logtail配置后,该Logtail配置会从机器组内的服务器的Logtail上移除。

    image

  4. 修改完成后,单击保存

删除机器组

  1. 机器组列表中,选择目标机器组对应的机器组管理图标 > 删除

  2. 在弹出的对话框中,输入机器组名称,并单击确认

相关文档