grafana/gcx

gcx 是一个命令行工具（CLI），将 Grafana（一个用于监控和可观测性的平台）直接带入你的终端或 AI 编码助手。无需在浏览器标签页之间切换，你可以直接从命令行或通过运行 shell 命令的 AI 代理查询实时指标、检查告警、管理仪表盘等。

它的功能：

• 查询数据：直接从终端运行 PromQL（指标）、LogQL（日志）以及类似的追踪和配置文件查询。
• 管理资源：以代码形式（GitOps 风格）拉取和推送仪表盘、文件夹和告警规则。
• 检查告警和 SLO：列出触发中的告警、审查服务级别目标，并调查事件。
• 与 Grafana Cloud 产品配合使用：包含用于 SLO、合成监控、IRM（事件响应）、k6 负载测试、Fleet Management 等的命令——但仅在 Grafana Cloud 上可用。
• 与 AI 代理集成：附带一组“技能”，让 AI 编码工具（如 Claude Code、OpenAI Codex）能够使用 gcx 命令调查告警、创建仪表盘和修复问题。

兼容性：

• 适用于 Grafana Cloud、Enterprise 和 OSS（自托管）版本。
• 完全支持 Grafana 13+；Grafana 12 可用但功能有限；不支持低于 12 的版本。
• 仅云产品（SLO、合成监控等）需要 Grafana Cloud。

安装：

• 快速脚本：curl -fsSL https://raw.githubusercontent.com/grafana/gcx/main/scripts/install.sh | sh
• Homebrew：brew install gcx

示例用法：

gcx metrics query 'rate(http_requests_total[5m])' --since 1h
gcx alert rules list --state firing
gcx slo definitions list

费用： gcx 本身是免费的，但它交互的一些 Grafana Cloud 产品（如 Assistant、合成监控、k6）按使用量计费。查询和资源推送/拉取不收费。

简而言之，gcx 是 Grafana 数据与你的终端或 AI 助手之间的桥梁，使可观测性工作流更快、更可脚本化。