用途:当 Coralogix/OpenTelemetry 问题取决于遥测语义时使用,例如资源、Span、指标、日志的属性名称与取值、作用域、schema、生成指标标签等。它把 Coralogix 产品行为映射到其消费的属性,并提供跨产品分诊流程,详细产品规则放在 references/ 中。
主要能力:按场景路由到参考文档。选择新 HTTP/DB/RPC/消息 Span 属性、诊断 APM Service Catalog 缺失操作、诊断 Database Monitoring 缺失数据库、处理 db.system.name / db.query.text 等新语义约定名称、排查跨产品常见陷阱、回答“哪些字段/确切名称”问题、分诊 SDK/Collector 升级后的语义约定破坏性变更、配置 Span Metrics 标签与基数、诊断 Span Metrics 写入者身份与拓扑、诊断 otel.metric.overflow 序列、诊断 Infrastructure Explorer 缺失 Pod/主机、诊断资源元数据生命周期与 Resource Catalog 清单、诊断自定义指标 temporality/重复标签/_1_total 名称、诊断 Lambda/日志元数据作用域或 EC2 标签富化,以及判断何时移交其他技能。
属性放置:Resource 用于生产者身份/环境,如 service.name、service.instance.id、host.name、k8s.pod.name;Span 用于每次操作上下文,如 http.route、db.system、db.operation;Metric data point 用于有界维度,如 http.request.method、http.response.status_code;Log record 用于每条日志事件字段;Span event 用于时间点细节,如 exception.type。
常见分诊流程:确认变更的 OTel 版本、插桩来源与 schema_url;确定受影响的 Coralogix 产品面并加载对应参考;用 collector debug exporter 检查转换前后的原始遥测;将破坏分类为属性名重命名、属性值/枚举重命名、生成指标标签或数据点变化、作用域不匹配、采集拓扑或产品路径缺口;选择桥接位置;把具体实现交给对应技能。资料给出仅用于检查原始作用域和属性名的最小 collector 配置,生产管线接线仍属于 opentelemetry-collector。
限制:本技能只诊断遥测语义,实现细节需移交:core 负责 cx.application.name、cx.subsystem.name 与路由;opentelemetry-instrumentation 负责 SDK 环境变量、采样器与手动 Span;ai-app-instrumentation 负责 AI Center 与 GenAI;opentelemetry-ottl 负责 set(...)、replace_pattern(...) 等;opentelemetry-collector 负责管线、Helm/Fleet、ConfigMap 等;产品工作流如仪表盘查询、SLO、告警、合成监控、RUM 等除非根因是本文档所述属性形态,否则不在范围内。