创建机器组并管理 - 日志服务

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

创建机器组

前提条件

已创建Project。具体操作，请参见创建项目Project。
服务器已安装Logtail，安装步骤请参见安装Logtail（Linux系统）或安装Logtail（Windows系统）。如果日志服务Project与ECS实例属于同一地域，您可在创建Logtail采集配置时自动安装Logtail。具体操作，请参见安装Logtail（ECS实例）。
如果您的服务器与日志服务Project分属于不同的阿里云账号，或是部署在其他云厂商环境、自建IDC等，则需要在服务器配置用户标识。具体操作，请参见配置用户标识。

操作步骤

说明

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

在VPC等自定义网络环境中，可能出现服务器IP地址冲突问题，导致Logtail采集失败。使用用户自定义标识可避免此类情况发生。
使用用户自定义标识可实现机器组的弹性伸缩。为新增的服务器配置相同的用户自定义标识，日志服务可自动识别，并将其添加至机器组中。如果不再需要采集服务器日志，直接删除在服务器上配置的用户自定义标识文件，日志服务可自动将该服务器从机器组中移除。

创建IP地址机器组

获取服务器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
Windows（64位操作系统）	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字段中，如下所示。

登录日志服务控制台，在Project列表，单击打开目标Project。
左侧导航栏中，选择资源 > 机器组。在打开的机器组页面中，选择机器组右侧的 > 创建机器组。

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

参数	说明
名称	机器组名称，命名规则如下所示：只能包括小写字母、数字、短划线（-）和下划线（_）。必须以小写字母或者数字开头和结尾。长度必须在 2~128 字符之间。重要创建后，不支持修改机器组名称，请谨慎填写。
机器组标识	选择IP地址。
机器组Topic	（可选）机器组Topic用于区分不同服务器产生的日志数据。更多信息，请参见日志主题。
IP地址	填入上述步骤中获取的服务器IP地址。重要存在多台服务器时，请手动输入对应的IP地址，IP地址之间需使用换行符分隔。同一机器组中不允许同时存在Linux和Windows服务器。请勿将Windows和Linux服务器IP添加到同一机器组中。

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

在指定目录下创建用户自定义标识文件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_id、C:\LogtailData\user_defined_id不存在，请手动创建。
Linux环境
1. 在Linux服务器配置用户自定义标识，可使用以下命令完成。
```
echo "user-defined-linux-1" > /etc/ilogtail/user_defined_id
```
2. 检查用户自定义标识是否写入成功，可使用以下命令。
```
cat /etc/ilogtail/user_defined_id
```
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命令查看。
登录日志服务控制台，在Project列表，单击打开目标Project。
左侧导航栏中，选择资源 > 机器组。在打开的机器组页面中，选择机器组右侧的 > 创建机器组。

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

参数	说明
名称	机器组名称，命名规则如下所示：只能包括小写字母、数字、短划线（-）和下划线（_）。必须以小写字母或者数字开头和结尾。长度必须在 2~128 字符之间。重要创建后，不支持修改机器组名称，请谨慎填写。
机器组标识	选择用户自定义标识。
机器组Topic	（可选）机器组Topic用于区分不同服务器产生的日志数据。更多信息，请参见日志主题。
用户自定义标识	填入上述步骤中配置的用户自定义标识。

查看机器组

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

心跳状态为OK表示服务器上的Logtail实例与日志服务Project连接正常。
如果心跳状态显示FAIL，处理操作请参见Logtail机器组问题排查思路（主机场景）。
重要
创建机器组大约需要2分钟。创建未生效，将导致心跳为FAIL。请2分钟后单击刷新进行重试。

修改机器组

在机器组列表中，单击目标机器组。然后在机器组配置页面，单击页面右上角的修改。
在机器组信息区域可切换机器组标识，更新机器组Topic。如果是用户自定义标识机器组，可更新用户自定义标识。如果是IP地址机器组，可增删改IP地址。
在管理配置区域可Logtail配置应用到该机器组，或删除已生效Logtail配置。
重要
- 添加Logtail配置到机器组后，该Logtail配置会被下发到机器组内的服务器的Logtail上。
- 从机器组移除Logtail配置后，该Logtail配置会从机器组内的服务器的Logtail上移除。
修改完成后，单击保存。