SuperAPI AI 工具集

explore-datasources

数据与分析

查看项目

更新于 10-15 21:55

技能介绍

用途:通过 gcx 发现 Grafana 实例中存在哪些可观测性数据,包括已配置数据源及其名称、类型、UID、URL 和访问设置,并进一步探索 Prometheus 指标与 Loki 日志内容。使用前若 gcx 未配置,需先参考 setup-gcx 技能。

主要能力与用法:

  1. 列出数据源:gcx datasources list,可按类型过滤,如 gcx datasources list --type prometheus 或 --type loki,输出 UID、NAME、TYPE、URL、DEFAULT 列。后续命令应使用 UID 而非名称。
  2. 探索 Prometheus:gcx metrics labels -d <datasource-uid> 列出标签;加 --label job 查看某标签取值;gcx metrics metadata -d <datasource-uid> 列出指标及描述;gcx metrics query -d <datasource-uid> 'up' 查看抓取目标。
  3. 探索 Loki:gcx logs labels -d <datasource-uid> 列出索引流标签;加 --label job 查看取值;gcx logs series -d <datasource-uid> -M '{job="varlogs"}' 列出匹配的日志流,series 至少需要一个 -M 选择器。注意 gcx logs labels 列出的是索引流标签,结构化元数据(如 detected_level)和解析标签不是索引标签,需在管道后过滤,不能放在 {} 内。
  4. 测试查询:Prometheus 即时查询用 --time,范围查询用 --from/--to;长时间窗口的 increase()、max_over_time() 等应使用范围查询。
  5. 设置默认数据源:gcx config set contexts.<context-name>.default-prometheus-datasource <uid> 或 default-loki-datasource <uid>,之后可省略 -d。

适用场景:查找可用 HTTP 指标、发现向 Loki 发送日志的服务、排查仪表盘无数据、查找特定命名空间的日志流等。

限制与注意:所有命令支持 -o json 或 -o yaml 便于程序化处理,默认表格输出。常见错误包括缺少 -d 且未设默认数据源、loki series 缺少 -M、LogQL 选择器引号被 shell 错误解析(应整体用单引号)、数据源 UID 不存在或无权限、数据源无数据等。资料未提供 gcx 的安装方式、收费、平台支持等细节。