用途:使用 cx logs 命令配合 DataPrime 语法查询和分析 Coralogix 日志,适用于搜索日志、定位错误、排查日志数据与调试。
主要能力:Coralogix 日志大多非结构化,元数据($m.)与标签($l.)可预测,可直接按严重级别、时间戳、应用名、子系统名过滤;用户数据($d.*)由应用自定义,字段名、嵌套与类型不可预测,需先验证。严重级别关键字不加引号:DEBUG | INFO | WARNING | ERROR | CRITICAL。
使用方式:命令为 cx logs '<dataprime_query>',若查询未包含 source 命令会自动注入 source logs 前缀。选项:--start 默认 now-1h,--end 默认 now,--limit 默认 100,--tier 默认 frequent(可选 archive),-o/--output 默认 text(可选 json、agents)。示例:cx logs 'filter $m.severity == ERROR';cx logs "filter $l.applicationname == 'api' && $l.subsystemname == 'auth'";聚合示例 cx logs 'filter $m.severity == ERROR | groupby $l.subsystemname aggregate count() as errors | orderby errors desc'。
字段发现:仅用标准字段、用户已指定字段、查找特定错误消息或已发现字段时可跳过。否则可优先从源码推断,或用 cx search-fields "customer identifier" --dataset logs 做语义搜索,或运行 cx logs "filter $l.subsystemname == 'api'" --limit 5 -o json 检查实际字段。
限制与排错:默认避免 wildfind,仅在用户给出具体引号错误消息且不知字段时使用。查询无结果时逐一调整:扩大时间范围、放宽过滤、用 -o json 验证字段名、尝试 archive 层级。内联帮助可用 cx dataprime list 与 cx dataprime show filter。相关技能包括 cx-metrics-query、cx-query-spans、cx-telemetry-querying、cx-alerts。