用途:将 OpenTelemetry(OTel)遥测数据(trace/metrics/logs)接入华为云 AgentArts 可观测平台(agent-ops)。覆盖四部分:OTel 遥测接入、AI Agent 观测、自动配置、接入诊断。
接入路径:Path A(推荐)OTLP → APM → deliverConfig → Kafka → agent-ops;Path B(仅验证)OTLP → Collector → agent-ops。当前 agent-ops 后端有 OTLP proto 定义但未实现 OTLP receiver,Path B 只用于验证 SDK/Collector 配置正确性。
前置条件:配置华为云凭证(切勿在对话中粘贴 AK/SK,示例:export HUAWEI_ACCESS_KEY="<your-access-key-id>";read -rs HUAWEI_SECRET_KEY; export HUAWEI_SECRET_KEY;export HUAWEI_REGION="cn-southwest-301");安装 hcloud CLI(KooCLI);确认 agent-ops 已订阅 APM 观测(SubscribeOpsObservation / OpenOpsObservation);配置 IAM 最小权限;安装对应语言 OTel SDK(Java 用 opentelemetry-javaagent,Python 用 opentelemetry-sdk,Node.js 用 @opentelemetry/sdk-node,Go 用 go.opentelemetry.io/otel)。
主要流程:检测应用语言与框架;确认区域与端点(默认 region 为 cn-southwest-301);确定采集范围(traces/metrics/logs、appName、businessId);执行接入。Path A 步骤包括:用 hcloud APM CreateBusiness 创建追踪业务、用 hcloud APM ShowToken 获取业务 token、获取接入点、创建 deliverConfig 转发、配置应用侧 SDK/Collector。随后可用管理面观测 API 验证数据到达,如 ShowOpsTrace 与 ShowOpsAgentMetricTrend(用 IAM token 鉴权)。
AI Agent 观测:按 OpenTelemetry GenAI 语义约定埋点,关注 invoke_agent、execute_tool、inference 等 span 及 gen_ai.* 属性,如 gen_ai.system、gen_ai.request.model、gen_ai.usage.input_tokens、gen_ai.usage.output_tokens。
限制:deliverConfig 与部分观测查询 API 来自用户提供、需在 API Explorer 手动验证;AgentArts 观测 API 尚未在 KooCLI 确认,需用 API(curl)方式;GenAI 语义约定处于开发状态(截至 OTel v1.41),属性名可能变化;禁止硬编码 AK/SK。资料未提供收费、价格与具体效果信息。