管理机器组

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

创建机器组

前提条件

操作步骤

说明

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

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

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

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

重要
  • 同一机器组中不允许同时存在LinuxWindows服务器,请勿在LinuxWindows服务器上配置相同的用户自定义标识

  • 一个服务器可配置多个用户自定义标识,标识之间以换行符分割。

  1. 配置用户自定义标识

    Linux环境
    1. 登录已安装LogtailLinux服务器,使用以下命令配置用户自定义标识

      说明

      如果目录/etc/ilogtail/不存在,请先手动创建该目录。

      echo "user-defined-1" > /etc/ilogtail/user_defined_id
    2. (可选)使用以下命令检查用户自定义标识是否写入成功。如果返回user-defined-1,则表示写入成功。

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

      /etc/init.d/ilogtaild stop
      /etc/init.d/ilogtaild start
    Windows环境
    1. 登录已安装LogtailWindows服务器,在C:\LogtailData目录下新建user_defined_id文件并写入user-defined-1,完成后保存。

      说明

      如果目录C:\LogtailData不存在,请先手动创建该目录。

    2. 新增、删除、修改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用于区分不同服务器产生的日志数据。更多信息,请参见日志主题

    用户自定义标识

    填入已配置的用户自定义标识,例如user-defined-1

创建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地址

    填入Logtail自动获取的服务器IP。

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

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

查看机器组配置

机器组列表中,单击目标机器组进入机器组配置页面。您可在此查看机器组信息机器组状态管理配置

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

  • 如果心跳状态显示FAIL,可能是配置未生效导致(配置生效时间大约需要2分钟)。如果2分钟后依然显示FAIL,则可能是其他配置问题,您可参见Logtail机器组问题排查思路(主机场景)处理。

image

修改机器组信息

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

  2. 日志服务支持修改以下机器组信息

    • 更改机器组标识

    • 更新机器组Topic

    • 更新用户自定义标识IP地址

    image

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

应用Logtail采集配置到指定机器组

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

  2. 管理配置区域,选择左侧的Logtail采集配置,然后单击>,将其移动到右侧已生效Logtail配置区域。

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

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

    image

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

删除机器组

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

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

相关文档