文档中心

日志服务

机器组

创建机器组（机器标识）

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

前提条件

已准备一台作为日志源的服务器。如果服务器是火山引擎 ECS，则必须和日志项目属于同一地域。

如果不启用火山 ECS 功能，批量添加火山 ECS 服务器到机器组时，需提前在服务器上安装 1.0.3 及后续版本的 LogCollector，推荐使用最新版本。下载及安装说明请参考安装 LogCollector。

注意事项

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

目前仅支持 Linux 服务器。

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

容器场景 LogCollector 暂不支持自动升级，请手动替换镜像。

操作步骤

1 配置机器标识（不启用火山 ECS 功能时配置）

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

Tip

初始化步骤的详细说明，请参考 LogCollector 安装与升级。

机器标识长度范围为 2～128 个字符，只能包含小写字母、数字、连字符（-）和下划线（_）。

机器组以 IP 地址的方式标识不同的容器，此 IP 地址默认为 LogCollector 获取的第一块网卡地址。为便于机器组管理，您可以修改 LogCollector 获取 IP 地址的策略。详细说明请参考为宿主机或容器设置 IP 地址。

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

停止 LogCollector。

sudo systemctl stop logcollectord.service

重新执行初始化命令。

各个参数说明请参考2 安装并启动 LogCollector。

sudo ./logcollector.sh install --region {region} --endpoint {endpoint} --secret_id {secret_id} --secret_key {secret_key} --label {label}

启动 LogCollector。

sudo systemctl start logcollectord.service

2 创建机器组

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 机器组。

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

在创建机器组对话框中，填写机器组的基本信息，然后单击创建。

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

查看机器组 LogCollector 连接状态

安装了 LogCollector 的机器会定时向日志服务上报心跳状态，您可以通过心跳状态判断对应服务器的 LogCollector 和日志服务连接状态是否正常。创建机器组成功后，您可以在机器组管理页面单击机器组名称，查看机器组中每台服务器的心跳状态。

心跳状态页签中的IP列展示了使用相同机器标识的服务器的 IP 地址。机器组中的不同服务器通过 IP 地址进行标识和区分，默认为 LogCollector 获取到的当前服务器地址，即第一块网卡的 IP 地址。

您可以核对 IP 地址的数量是否和实际已配置机器标识的服务器数量一致，并查看每台服务器的心跳状态。

状态一列显示正常：日志服务已成功识别该服务器，且服务器 LogCollector 和日志服务连接状态正常。

状态一列显示异常：机器组中有部分机器状态异常。单击机器组名称可以查看心跳异常的服务器 IP 地址。

Tip

在机器组中添加服务器后，服务器心跳状态会短暂显示为异常，直到 LogCollector 成功向日志服务上报心跳状态。如果服务器心跳状态异常持续 1 分钟以上，建议参考机器组心跳问题排查逐步排查处理。

在机器标识类型的机器组中，状态异常的服务器重启后对应的 IP 地址会变化，日志服务根据原 IP 地址查看心跳状态会持续失败，所以原状态异常的 IP 地址记录会持续留存。在这种情况下建议您查看心跳状态正常的机器数量，如果和实际服务器数量一致，则可以忽略异常状态的错误信息。

最近更新时间：2026.10.30 18:26:15

这个页面对您有帮助吗？

有用

无用