本文介绍如何使用安装脚本或批量作业为云服务器安装 O11yAgent 采集插件。

背景信息

O11yAgent 采集插件是新一代可观测性数据采集和处理管道，能够简化在云环境中接入可观测性系统的复杂度，同时可以让用户轻松地从可观测性数据中获取更多价值。

相比旧版 cloud-monitor-agent 插件而言，O11yAgent 采集插件具有以下优势：

提供插件安装、升级的白屏化操作界面。

后续仅基于 O11yAgent 采集插件增加监控指标。

方式一：黑屏安装插件

支持登录 ECS 实例的终端界面，在实例中下载插件安装脚本，并安装 O11yAgent 插件。

Linux ECS 安装插件

Windows ECS 安装插件

步骤一：获取插件安装脚本

使用 ECS Terminal 登录 ECS 实例。详情请参见登录概述。

执行以下命令，获取地域信息并获取安装脚本。

region=$(wget -q -O - http://100.96.0.96/volcstack/latest/region_id);wget https://o11yagent-registry-${region}.tos-${region}.ivolces.com/scripts/o11yagentd/latest/o11yagentd_ecs.sh && chmod +x o11yagentd_ecs.sh​

说明

默认情况下，使用上述命令会获取并安装采集插件的最新版本，您也可以将latest参数修改为具体的版本号，安装指定的版本。详情请参见插件发布记录。

步骤二：安装插件

ECS 实例安装命令如下：

./o11yagentd_ecs.sh --region ${region} --o11yagent.service_id o11yagent_ecs

GPU ECS 实例安装命令如下：

./o11yagentd_ecs.sh --region ${region} --o11yagent.service_id o11yagent_hpc

步骤三：结果验证

执行以下命令，验证插件是否安装成功。

o11yagentctl ps

预期结果如下，可以查看已安装的插件进程，并且插件的STATUS为online，表示插件安装成功，工作正常。

AGENT_ID NAME PKG STATUS START_TIME
ecs_i-ydmrej19*** o11yagent_ecs:3.23.0 online 2025-01-09 06:13:53.266884841 +0000 UTC

说明

插件的STATUS状态更新略有延迟，建议多次查看，以确认插件状态。

登录云监控控制台，在云产品监控下选择云服务器。单击目标 ECS 实例名称，进入 ECS 实例监控详情，可以正确查看到该 ECS 实例的监控信息。

方式二：使用批量作业安装插件

批量作业是平台打造的原生自动化运维工具。支持通过批量作业以免密码、免登录、无需使用跳板机的形式，在单个或多个执行对象中便捷执行运维命令。您可以使用批量作业，快速在多个 ECS 主机实例中安装 O11yAgent 插件。

步骤一：前置检查

登录云服务器控制台。

在左侧导航栏中选择运维与监控 > 云助手。

选择公共命令页签，确认是否已经录入了公共命令云监控 ECS 采集组件安装。

确认目标 ECS 主机已经安装批量作业 Agent。否则将会安装失败并提示CloudAssistantNotInstalled信息。如何安装批量作业 Agent，请参见安装批量作业客户端。

步骤二：创建批量作业

在公共命令页签中的云监控 ECS 采集组件安装卡片中，单击创建作业，创建插件安装批量作业。

基本信息：配置批量作业的基本信息。

执行命令：配置插件安装参数。

参数	是否必填	参数含义	参数类型	参数示例
site	否	ECS 实例所属站点，取值： volcengine：火山引擎站点。 byteplus：BytePlus 站点。	字符串，取值范围为 1～1000	volcengine
region	否	ECS 实例所在地域 Region ID。详情请参见地域和可用区。	字符串，取值范围为 1～1000	cn-beijing
o11yagentd_version	否	o11yagentd 插件的版本号，默认为latest，表示安装最新的插件版本。也支持配置为具体的版本号，安装指定的版本。详情请参见插件发布记录。	字符串，取值范围为 1～1000	latest
o11yagent_version	否	o11yagent 插件的版本号，默认为latest，表示安装最新的插件版本。也支持配置为具体的版本号，安装指定的版本。详情请参见插件发布记录。	字符串，取值范围为 1～1000	latest
o11yagentd_control_plane_region	否说明当 ECS 实例所在区域与 o11yagentd 控制面所在区域不一致时，必填。	配置 o11yagentd 控制面所在地域 Region ID。	字符串，取值范围为 1～1000	cn-beijing
o11yagentd_log_dir	否	o11yagentd 日志路径。	字符串，取值范围为 1～1000	/tmp/log
o11yagentd_cpu_quota	否	o11yagentd 插件的 CPU 限额，单位为核数百分比，例如：取值为 50 或 50% 时，表示 0.5 Core。取值为 200 或 200% 时，表示 2 Core。	字符串，取值范围为 1～1000	50
o11yagentd_memory_max	否	o11yagentd 插件的内存限额，单位为字节。例如：取值为 2048 时，表示 2048 Bytes。取值为 1024K 或 1024k 时，表示 1024 KB。取值为 200M 或 200m 时，表示 200MB。取值为 1G 或 1g 时，表示 1GB。	字符串，取值范围为 1～1000	1024
o11yagent_total_cpu_quota	否	o11yagent 插件的总 CPU 限额，单位为核数百分比，例如：取值为 50 或 50% 时，表示 0.5 Core。取值为 200 或 200% 时，表示 2 Core。	字符串，取值范围为 1～1000	100
o11yagent_total_memory_max	否	o11yagent 插件的总内存限额，单位为字节。例如：取值为 2048 时，表示 2048 Bytes。取值为 1024K 或 1024k 时，表示 1024 KB。取值为 200M 或 200m 时，表示 200MB。取值为 1G 或 1g 时，表示 1GB。	字符串，取值范围为 1～1000	2048
o11yagent_cpu_quota	否	o11yagent 插件的 CPU 限额，单位为核数百分比，例如：取值为 50 或 50% 时，表示 0.5 Core。取值为 200 或 200% 时，表示 2 Core。	字符串，取值范围为 1～1000	100
o11yagent_memory_max	否	o11yagent 插件的内存限额，单位为字节。例如：取值为 2048 时，表示 2048 Bytes。取值为 1024K 或 1024k 时，表示 1024 KB。取值为 200M 或 200m 时，表示 200MB。取值为 1G 或 1g 时，表示 1GB。	字符串，取值范围为 1～1000	1024
instance_type	否	ECS 实例类型，取值： ecs：云服务器实例。 gpu：异构计算类型云服务器实例。更多详情，请参见实例规格介绍。	字符串，取值范围为 1～1000	ecs
registry_address	否	o11yagent 产物地址。	字符串，取值范围为 1～1000	http://127.0.0.1

执行路径：配置作业执行路径，Linux 云服务器下默认为/home。

执行用户：配置作业的执行用户，Linux 云服务器下默认为root，可以选择其他执行用户，以降低风险。

超时时间：配置作业的超时时间，当执行命令超过该时间时，系统会自动终止任务进程。

执行方式：选择作业的执行方式，包括：

立即执行：配置完成后，立即执行作业。

定时执行：作业在指定的时间执行，需要配置作业执行的具体日期和时间。

周期执行：作业周期执行，支持按分钟、按小时和按天执行，并支持配置周期执行的开始时间和结束时间。

执行对象：在全部列表中勾选目标 ECS 实例，将其加到已选列表中。

高级配置：配置任务的所属项目和标签。

单击确定，完成配置。

步骤三：结果验证

插件安装完成后，选择作业管理页签，在任务列表中查看目标任务，其任务状态显示执行成功，表示插件在 ECS 实例中安装成功。

登录云监控控制台，在云产品监控下选择云服务器。单击目标 ECS 实例名称，进入 ECS 实例监控详情，可以正确查看到该 ECS 实例的监控信息。

云监控