用途:系统性诊断华为云 AgentArts agent-ops 平台中指标、日志、链路/会话无数据的问题。数据链路为:链路经 OTEL SDK 到 APM(OTLP)、deliverConfig、Kafka 再到 agent-ops;指标经 AOM(Prometheus);日志经 LTS(需 logGroup/logStream 元数据)。诊断顺序固定为订阅元数据检查、数据管道排查、查询参数校验,必要时再查权限。
主要能力:按数据类型分支排查。指标侧检查 AOM 的 Prometheus 实例与访问码、端点可达性,并用即时查询验证数据;日志侧检查 LTS 日志组/流并查询日志,处理 LTS.2446 语法错误与 403 权限问题;链路侧检查 OTEL SDK 端点与令牌、APM deliverConfig 的 deliver_otel_trace 是否开启及 Kafka 连通性,并通过 API 查询链路。最后可按模板生成诊断报告。
使用方式:需配置华为云凭证环境变量与 hcloud CLI(KooCLI),并具备相应 IAM 权限。常用命令如 hcloud APM ListBusiness --cli-region=cn-north-4、hcloud AOM ListPromInstance --cli-region=cn-north-4 --Enterprise-Project-Id=0、hcloud LTS ListLogGroups --cli-region=cn-north-4;agent-ops 链路查询使用 POST {AGENT_OPS_ENDPOINT}/v1/ops/observation/traces,IAM_TOKEN 需运行期获取替换。
限制:时间戳须为 13 位毫秒,10 位秒会导致无数据;采集与查询区域须一致;凭证不得硬编码。部分参考文档与具体权限清单等细节暂未提供。