创建机器组（机器标识）

本文介绍创建机器标识类型机器组的操作步骤。

前提条件

• 已准备一台作为日志源的服务器。如果服务器是火山引擎 ECS，则必须和日志项目属于同一地域。
• 已在服务器上成功安装了 1.0.3 及后续版本的的 LogCollector，推荐使用最新版本。下载及安装说明请参考安装 LogCollector。

注意事项

每个火山引擎主账号下，每个地域最多可以创建 200 个机器组。

• 目前仅支持 Linux 服务器。
• 仅 LogCollector V1.0.8 及后续版本支持自动升级。如需使用自动升级功能，请在创建机器组前，确认待加入机器组的服务器均安装了指定版本，否则不符合版本要求的 LogCollector 将无法自动升级。V1.0.7 及之前的历史版本 LogCollector，请参考升级 LogCollector 进行升级。
• 容器场景 LogCollector 暂不支持自动升级，请手动替换镜像。

操作步骤

1 配置机器标识

如果某台服务器需要加入机器标识类型的机器组，在指定服务器上初始化 LogCollector 时，应指定 label 参数，并传入自定义的机器标识。

如果初始化时未填写 label 参数，则需要停止 LogCollector，并重新执行初始化命令、填写正确的参数，最后再次启动 LogCollector 即可。如果设置机器标识之后，需要修改机器标识，同样可以参考以下步骤操作。

#停止LogCollector
systemctl stop    filebeatd.service

#重新执行初始化命令
./filebeat.sh init --endpoint <tls_endpoint> --secret_id {AccessKeyID} --secret_key {AccessKeySecret} --region {region} --label {label}

#启动LogCollector
systemctl start   filebeatd.service

2 创建机器组

1. 登录日志服务控制台。

2. 在左侧目录中选择日志服务 > 机器组管理。

3. 在机器组管理页面单击创建机器组。

4. 填写机器组的基本信息，并单击确定。

   参数	说明
   机器组名称	机器组的名称。
   机器组类型	机器组的类型。此处选择机器标识。
   自定义标识	填写服务器上已配置的自定义标识。
   LogCollector服务日志	是否开启 LogCollector 服务日志功能。开启后，LogCollector 客户端在运行过程中会实时记录运行状态和采集进度等信息。 详细说明请参考服务日志。
   LogCollector自动升级	机器组服务器中安装的 LogCollector 是否开启自动升级功能。 开启：日志服务将会在每天的指定时间段进行升级前检查，若满足升级条件，则自动升级 LogCollector，无需手动操作。 关闭：LogCollector 不自动升级，如需使用更高版本的 LogCollector，请参考升级 LogCollector操作。 说明 仅 LogCollector V1.0.8 及后续版本支持自动升级。
   自动升级时间	LogCollector 的自动升级时间。 说明 仅在LogCollector自动升级为启用状态时需要设置。 自动升级时间建议设置为业务低峰期，自动升级过程中可能会重启 LogCollector，但不会丢失日志。
   所属项目	在下拉列表里选择当前创建的机器组所属的 IAM 项目。 如果您尚未创建任何 IAM 项目，或没有合适的 IAM 项目以供选择，可以单击创建新项目创建一个新的 IAM 项目。未指定 IAM 项目时，日志服务会将机器组添加到名为 default 的 IAM 项目中。

后续操作

安装了 LogCollector 的机器会定时向日志服务上报心跳状态，日志服务通过心跳状态判断对应服务器的 LogCollector 和日志服务连接状态是否正常。成功创建机器组后，可以在机器组管理页面单击机器组名称，查看机器组中每台服务器的心跳状态。
心跳状态页签中的IP一列即使用相同机器标识的服务器的 IP 地址。机器组中不同服务器通过 IP 地址进行标识和区分，默认为 LogCollector 获取到的当前服务器地址，即第一块网卡的 IP 地址，您可以在 /filebeat-7.12.0/agent_info.json 文件的 ip 字段中查看该 IP 地址。
您可以核对 IP 地址的数量是否和实际已配置机器标识的服务器数量一致，并查看每台服务器的心跳状态。

• 状态一列显示正常：日志服务已成功识别该服务器，且服务器 LogCollector 和日志服务连接状态正常。
• 状态一列显示异常：机器组中有部分机器状态异常。单击机器组名称可以查看心跳异常的服务器 IP 地址。