用可观测性数据（日志/指标/链路/RUM）排查生产问题时如何…

当需要调查线上问题、调试性能或错误、分析用户行为时，先判断信号位于哪个数据源（指标、日志、链路、RUM），再加载对应参考文档并执行查询。

适用场景

解决思路

1. 先根据问题类型用快速路由表选定首选数据源：UI 行为/页面加载/前端错误选 RUM；接口延迟/吞吐/错误率选 Metrics；服务间依赖/请求流选 Traces；具体错误信息/堆栈选 Logs；基础设施健康（CPU、内存、磁盘）选 Metrics；业务事件（购买、注册）走发现流程。
2. 查询前按数据源加载对应参考文件：Logs 加载 references/dataprime-reference.md + references/logs-querying.md；Spans/Traces 加载 references/dataprime-reference.md + references/spans-querying.md；Metrics 加载 references/promql-guidelines.md + references/metrics-querying.md；RUM 加载 references/dataprime-reference.md + references/logs-querying.md + references/rum-querying.md + references/rum-fields.md；仅需 DataPrime 语法时只加载 references/dataprime-reference.md。
3. 对来源不明确的问题（如“上周用户花了多少钱”）并行执行发现流程：先用 cx metrics search --name '*transaction*'、--name '*payment*'、--name '*revenue*' 或 --description "total purchase amount" 搜索指标。
4. 用语义字段搜索定位 DataPrime 路径：cx search-fields "transaction amount" --dataset logs、cx search-fields "payment total" --dataset spans、cx search-fields "purchase value" --dataset logs --limit 10。
5. 当已知具体值但不知道字段名时改用值搜索，它会返回匹配字段键和样本值，并可据此推断字段类型：cx search-fields "payment_failed" -s value --dataset logs、cx search-fields "grpc.status.UNAVAILABLE" -s value --dataset spans、cx search-fields "eu-west-1" -s value --dataset all。
6. 若 cx search-fields 因缺少凭证失败，提示用户运行 cx profiles add <name> 配置 Coralogix API key 或 OAuth。
7. 发现结果模糊或需确认指标/字段含义时搜索代码库：查找指标注册代码（如 prometheus.NewCounter、metrics.record）、发出该字段的日志语句（如 logger.info("transaction", ...)）、span 属性（如 span.setAttribute("purchase.amount", ...)）。
8. 根据发现结果选定信号最清晰的数据源，加载其参考文件后执行查询。
9. 初次查询无结果时切换数据源重试：Metrics 为空改试 traces（逐请求数据）或 logs（事件记录）；Logs 为空改试 traces（结构化 span 属性）或 metrics（聚合计数）；Traces 为空改试 logs（文本调试输出）；至少尝试两个数据源后再判定数据不存在。
10. 用 cx schema 输出完整命令树 JSON，发现所有可用命令及其参数。
11. 用 cx metrics search --name <pattern> 按名称查找指标，用 --description <text> 做语义搜索。
12. 用 cx spans "filter $l.serviceName == '<service>'" --limit 10 按服务搜索 span。
13. 用 cx dataprime list 列出 DataPrime 命令/函数以构建日志或 span 查询。
14. 创建新仪表盘前先用 cx dashboards search "<description>" 按自然语言描述查找已有仪表盘。
15. 用 cx dashboards query-search --description "<text>" 查找覆盖某主题的仪表盘组件，用 --field "<field-path>" 查找引用特定字段的组件，以复用已有 PromQL/DataPrime 模式。
16. 若用户意图是运维而非调查，转交对应工作流技能：成本优化→cx-cost-optimization；案件分诊→cx-cases；SLO/错误预算→cx-slos；监控/Webhook/通知配置→cx-observability-setup；解析规则/富化/E2M→cx-data-pipeline；访问审计/API key/用户管理→cx-platform-admin；仪表盘创建管理→cx-dashboards；查找仪表盘→cx-search-dashboard。

适用边界 · 注意事项

• 需要 Coralogix CLI（cx）及 API key 或 OAuth 凭证；缺少凭证时无法执行查询与字段搜索。
• 非调查类运维意图（成本、案件、SLO、监控配置、数据管道、平台管理、仪表盘管理）应转交对应技能，而非用本流程查询数据。