文档中心

日志服务

机器组

创建机器组（IP 地址）

本文档为您介绍创建 IP 地址类型机器组的操作步骤。

前提条件

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

如果不启用火山 ECS 功能，批量添加火山 ECS 服务器到机器组时，需提前在服务器上安装最新版本的 LogCollector。详细说明请参考安装 LogCollector（宿主机）。

注意事项

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

目前仅支持 Linux 服务器。

机器组中不同服务器通过 IP 地址进行标识和区分，默认使用第一块网卡的 IP 地址，您也可以在初始化时通过参数 ip 指定使用其他 IP 地址。详细说明请参考安装 LogCollector。

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

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

操作步骤

获取宿主机的 IP 地址（不启用火山 ECS 功能时配置）。

机器组中以 IP 地址的方式标识不同的服务器。创建 IP 地址类型的机器组之前，应从宿主机或容器中获取 LogCollector 上报的 IP 地址。您可以在 /usr/local/logcollector/agent_info.json 文件的 ip 字段中查看此 IP 地址。

说明

如果 Logcollector 版本低于 v2.2.0，则配置文件路径为 /usr/local/filebeat-7.12.0/agent_info.json。如何查看 LogCollector 版本，请参考查看软件版本。

如下所示，登录指定宿主机，并在 /usr/local/logcollector/agent_info.json 文件中查看 ip 字段。

hostname:/home # cat /usr/local/logcollector/agent_info.json
{
"hostname": "logcollector-dnwwc",
"ip": "10.56.*.*",
"logcollect_version": "2.2.1",
"update_time": "2025.01.14 15:19:29"
}

Tip

默认情况 LogCollector 将第一块网卡的 IP 地址作为当前宿主机或容器的 IP 地址，并将其上报到服务端。您也可以手动指定 IP 地址，或修改 LogCollector 获取 IP 地址的策略。详细说明请参考为宿主机或容器设置 IP 地址。

登录日志服务控制台。

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

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

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

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

参数	说明
机器组名称	机器组的名称。
机器组类型	机器组的类型。此处设置为 IP地址。
火山ECS	是否启用并添加火山 ECS 实例到当前机器组，开启后需手动选择要添加的 ECS 实例。仅支持添加已安装 ECS 云助手且云助手状态和实例状态均为运行中的 ECS 实例。系统会自动为所选择的 ECS 实例安装 LogCollector。已开始安装 LogCollector 的 ECS 实例不支持停止或解除安装，请谨慎操作。
IP地址	服务器 IP 地址。 Tip 请填写为您第 1 步中获取的服务器 IP 地址。机器组中添加多台机器时，IP 地址之间以中文逗号、英文逗号、空格或换行符分隔。暂不支持 Windows 系统的服务器。
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 地址的数量，及各种状态的服务器数量。

正常：服务器 LogCollector 和日志服务连接状态正常。

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

Tip

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

最近更新时间：2026.08.26 10:55:46

这个页面对您有帮助吗？

有用

无用