用途:通过 cx spans 命令以 DataPrime 语法查询和分析分布式追踪数据。Coralogix 中 trace 并非独立存储,而是共享同一 traceID 的 span 逻辑集合,因此分析 trace 即查询其组成 span。
主要能力:可按时间、时长、服务名、操作名等标准字段过滤;支持聚合(如按操作名统计平均延迟)、排序、按 traceID 还原调用链、查找慢 span 与错误 span。
用法:命令为 cx spans '<dataprime_query>',source spans 会自动注入,无需在查询中写出。常用选项:--start(默认 now-1h,支持 ISO 8601 或相对时间)、--end(默认 now)、--limit(默认 200)、--tier(frequent 热存储或 archive 冷存储)、-o/--output(text、json、agents)。
数据模型:标准字段始终可用,包括 $m.timestamp、$m.duration(微秒)、$l.applicationName、$l.subsystemName、$l.serviceName、$l.operationName、$d.traceID、$d.spanID、$d.parentSpanID。$l.applicationName 与 $l.subsystemName 的含义因客户而异,不要臆测其映射。$m.duration 为微秒,展示时应转换为毫秒、秒或分钟并带单位。span 没有 $m.severity,错误通常由 $d.tags.error == true 或自定义状态码字段表示,具体取决于埋点库。
字段发现:仅用标准字段或用户已明确字段时可跳过;否则可优先从源码推断,或用 cx search-fields "..." --dataset spans 语义搜索,或采样查询 cx spans "..." --limit 5 -o json 检查实际字段。wildfind 默认避免使用,仅在用户给出具体字符串且不知字段时例外。
限制与排错:查询无结果时逐一调整时间范围、放宽过滤、检查字段可用性与名称、确认服务名大小写,或改用 archive 层。相关技能包括 cx-metrics-query、cx-query-logs、cx-telemetry-querying。