cx-search-dashboard

仪表板搜索技能

使用此技能，通过 cx dashboards CLI 命令进行语义搜索或基于字段的搜索，发现现有的 Coralogix 仪表板和小组件。创建新仪表板之前，务必先搜索，避免重复。

CLI 命令

命令	用途	关键标志
cx dashboards search "<description>"	根据自然语言描述查找仪表板	--limit
cx dashboards query-search --description "<text>"	查找查询与描述相符的小组件	--limit
cx dashboards query-search --field "<field-path>"	查找引用特定字段的所有小组件	--limit
cx dashboards catalog -o json	列出所有仪表板	-
cx dashboards get <id> -o json	获取完整的仪表板定义	-

**输出格式：**追加 -o json 或 -o toon，以获取机器可读的输出。

各命令的适用场景

目标	命令
检查是否已有适用于某项服务或主题的仪表板	cx dashboards search
查找查询涵盖你关注主题的小组件	cx dashboards query-search --description
查找查询引用特定字段路径的小组件	cx dashboards query-search --field
浏览所有仪表板	cx dashboards catalog

示例

查找适用于某项服务的仪表板

cx dashboards search "payment service error rate"
cx dashboards search "kubernetes node cpu"

查找查询涵盖某个主题的小组件

cx dashboards query-search --description "http 5xx error rate"
cx dashboards query-search --description "p99 latency over time"

查找引用某个字段的所有小组件

cx dashboards query-search --field '$d.http.status_code'
cx dashboards query-search --field '$d.kubernetes.pod.name'

这可以展示已在使用的查询模式，便于添加新小组件时复用现有方案。

检查并克隆找到的仪表板

# Get full JSON of a dashboard you found
cx dashboards get <dashboard-id> -o json > dashboard.json
# Modify it, then create a copy
cx dashboards create --from-file dashboard.json

核心原则

• 创建前先搜索——创建新仪表板之前，务必先运行 cx dashboards search，以避免重复
• 使用字段搜索进行发现——cx dashboards query-search --field 会展示已有的字段查询方式，这是找到可复用 PromQL 或 DataPrime 模式最快的方法
• 描述搜索采用模糊匹配——结果按相似度排序，而非精确匹配；如果首次搜索没有有用结果，请尝试不同的表述
• 使用 cx dashboards get 进行检查——找到相关仪表板或小组件后，获取其完整 JSON 以了解查询结构

相关技能

• cx-dashboards——从头构建并部署新的 Coralogix 仪表板
• cx-telemetry-querying——搜索仪表板之前，先了解有哪些遥测字段和指标