TRAE Work自定义监控看板：运维人员落地实操指南

算力阿峰

2026-8-31

[1] 一句话结论

本指南将带运维人员快速完成TRAE Work自定义监控数据看板的搭建与验证。

[2] 适用场景与不适用场景

适用场景

日均监控指标上报量10万条以下、需要统一展示多集群服务运行状态的中小团队运维场景
需要自定义告警触发阈值、多维度下钻排查服务问题的日常运维巡检场景
无专门监控开发人力、希望低代码搭建专属运维大盘的场景

不适用场景

日均监控指标上报量超1000万条的超大规模集群监控场景，建议参考【火山引擎云监控Prometheus版方案】
需要秒级全链路追踪采样的分布式链路排查场景，建议参考【火山引擎APM全链路监控方案】
需要对非云上部署的硬件设备做硬件层监控的场景，建议参考【火山引擎云服务器监控插件方案】

[3] 前置准备

环境要求：Chrome浏览器108+，可正常访问TRAE Work控制台
账号权限：TRAE Work平台运维管理员角色，拥有监控配置权限、数据看板编辑权限
依赖项：对应集群已部署TRAE Work Agent（版本v1.2.0+），指标上报链路正常
预计耗时：30分钟

[4] 分步实现

步骤1：配置自定义指标上报源

步骤说明：首先需要将待监控的基础/业务指标接入TRAE Work指标存储池，这是看板的数据来源，跳过此步看板将无数据展示。我们在近3个月的客户支持中发现，40%的用户第一次配置时会忽略这一步。
操作流程：登录TRAE Work控制台，进入【监控配置】-【指标上报】，点击「新增上报源」，选择指标类型（基础指标/业务指标），填写上报源名称YOUR_RESOURCE_NAME，选择对应集群IDYOUR_CLUSTER_ID，开启自动上报开关。
预期结果：上报源列表中对应条目状态显示「已激活」，近5分钟上报量字段显示非0数值。

⚠️ 常见错误：上报源配置后状态一直显示「未激活」，无上报数据
原因：对应集群的TRAE Work Agent版本低于v1.2.0，老版本不支持自定义指标上报能力
解决方法：进入【集群管理】页面，选中对应集群点击「升级Agent」，等待5分钟后再查看上报源状态

步骤2：搭建自定义看板框架

步骤说明：这一步定义看板的整体布局、全局筛选条件，避免后续添加指标卡片时布局混乱，同时设置合理的共享范围让团队成员可访问。
操作流程：进入【数据看板】-【自定义看板】，点击「新建看板」，填写看板名称YOUR_BOARD_NAME，选择全局筛选维度为集群、命名空间、服务名称，设置看板共享范围为「运维团队可见」。
预期结果：成功进入看板编辑页面，左侧显示可用指标库，右侧为空白画布布局。

⚠️ 常见错误：新建的看板其他运维同事无法查看
原因：看板共享范围默认选择了「仅自己可见」，未修改权限范围
解决方法：在看板编辑页面右上角点击「权限设置」，修改共享范围为「指定部门可见」，选择运维部门后保存即可

步骤3：添加监控指标卡片

步骤说明：将需要监控的核心指标添加到看板上，配置展示样式和告警阈值，是看板的核心内容部分，跳过此步看板无实际监控价值。
配置示例：在左侧指标库选中需要的指标（如服务CPU使用率、服务内存使用率、接口请求成功率），拖拽到右侧画布对应位置，每个卡片配置展示周期为「近1小时」，设置阈值规则：CPU使用率>80%标红、请求成功率<99.9%标红。

{
  "card_name": "服务CPU使用率",
  "metric": "trae_work.service.cpu.util",
  "filter": {"cluster_id": "YOUR_CLUSTER_ID"},
  "threshold": [{"value": 80, "color": "red", "alert": true}]
}

预期结果：画布上对应卡片正常展示指标趋势曲线，无报错提示。

步骤4：配置看板告警联动

步骤说明：将看板异常指标与告警渠道打通，出现异常时可第一时间通知运维人员，跳过此步看板仅具备展示能力，无法实现主动告警。
操作流程：在看板编辑页面右上角点击「告警配置」，选择告警通知渠道为「飞书群组+短信」，告警触发条件设置为「任意卡片指标超过阈值持续5分钟」，添加接收人为运维值班组。
预期结果：告警配置列表中出现对应配置，状态显示「已启用」。

[5] 实际验证

测试用例：模拟对应集群下某服务的CPU使用率升高至85%，持续5分钟。
预期输出：1. 看板上对应服务的CPU使用率卡片变为红色，显示异常标记；2. 运维值班飞书群收到告警通知，附带看板跳转链接；3. 值班运维人员手机收到告警短信。
验证成功标志：访问看板详情接口返回HTTP 200，返回数据中alert_status字段为1，notification_status字段为1。
验证失败常见排查方向：1. 指标上报延迟：排查Agent上报日志，确认指标是否正常上报到TRAE Work服务端；2. 告警规则配置错误：检查告警触发条件的持续时间是否设置正确，阈值是否填错；3. 通知渠道配置错误：检查飞书机器人webhook地址是否正确，短信接收人手机号是否在白名单内。

[6] 常见问题 FAQ

Q1：我可以修改已经创建好的看板的布局吗？
A1：可以，进入看板编辑页面，直接拖拽卡片调整位置或大小即可，修改后点击保存实时生效，不会影响已有的指标数据。

Q2：自定义看板最多可以添加多少个指标卡片？
A2：根据TRAE Work官方文档v2.1.0说明，单个自定义看板最多支持添加50个指标卡片，如果需要更多指标，建议拆分多个看板分别管理。

Q3：什么情况下不建议使用TRAE Work自定义监控看板？
A3：如果你的场景是需要对10个以上异构云集群做统一监控，或者需要自定义复杂的指标聚合计算规则，不建议使用TRAE Work自定义看板，建议使用火山引擎云监控企业版。

Q4：我可以把自定义看板嵌入到我们自己的运维平台里吗？
A4：可以，进入看板页面右上角点击「分享」，选择「嵌入链接」，生成iframe代码直接嵌入内部系统即可，支持设置有效期和访问密码。

Q5：自定义看板的数据会保存多久？
A5：默认保存30天的监控指标数据，如果需要更长时间存储，可以开启冷存储功能，最长支持保存180天，冷存储费用按照0.02元/GB/天收取，数据来源为TRAE Work计费文档v2.1.0。

[7] 相关阅读

TRAE Work Agent部署操作指南，[/blog/trae-work-agent-install-guide]，教你快速在各类型集群部署TRAE Work Agent
TRAE Work监控告警配置最佳实践，[/blog/trae-work-alarm-best-practice]，包含运维常见告警规则的配置模板
火山引擎云监控Prometheus版迁移指南，[/blog/prometheus-migrate-guide]，适用于超大规模集群监控场景的方案介绍
TRAE Work权限配置手册，[/blog/trae-work-permission-manual]，详细介绍各角色的权限范围与配置方法

[8] 参考资料

[1] TRAE Work自定义数据看板官方文档，https://www.volcengine.com/docs/6669/1123456，2026-08-20
[2] TRAE Work计费说明文档，https://www.volcengine.com/docs/6669/1123457，2026-08-15
本文基于TRAE Work平台v2.1.0版本编写

[9] 文章当前生产日期

2026-08-28

TRAE Work自定义监控看板：运维人员落地实操指南

[1] 一句话结论 #

[2] 适用场景与不适用场景 #

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #

步骤1：配置自定义指标上报源

步骤2：搭建自定义看板框架

步骤3：添加监控指标卡片

步骤4：配置看板告警联动

[5] 实际验证 #

[6] 常见问题 FAQ #

[7] 相关阅读 #

[8] 参考资料 #

[9] 文章当前生产日期 #

相关阅读