gcx（Grafana CLI）とは？ターミナルからGrafanaを操作するAIエージェント対応CLIツール

Grafanaの監視ダッシュボードを毎回ブラウザで開いて確認していませんか？GrafanaがリリースしたCLIツール「gcx」は、ターミナルから直接Grafanaを操作できるツールです。GitHubでは 381スター を獲得し、特にSRE・DevOpsエンジニアから注目されています。

本記事では、gcxの概要・主要機能・導入方法・具体的な活用例を詳しく解説します。

gcx Grafana CLI の基本概念と使い方

gcxは、Grafana公式が開発したGo製CLIツールです。「ターミナルとAIコーディング環境からGrafanaを操作する」ことを目的として設計されており、Grafana Cloud・Enterprise・OSS（Grafana 12以降）に対応しています。

ダッシュボード管理・アラート確認・SLO操作・メトリクス/ログ/トレースのクエリ・GitOps・CI/CD統合まで、Grafanaの主要機能をコマンドラインから一括操作できます。さらに、Claude CodeやOpenAI Codexなどのエージェント環境向けの「Agent Skills」も22種類同梱されており、AIエージェントが本番監視データを参照しながら問題を自動調査する未来が実現しつつあります。

主要機能：gcxが実現するワークフロー

ダッシュボード・アラート管理

# ダッシュボード一覧・検索
gcx dashboards list
gcx dashboards search "node exporter"

# 発火中のアラート確認
gcx alert rules list --state firing

# SLOステータス確認
gcx slo definitions list

リアルタイムなメトリクス・ログクエリ

# PromQLでメトリクスを照会（直近1時間）
gcx metrics query 'rate(http_requests_total[5m])' --since 1h

# LogQLでエラーログ抽出
gcx logs query '{app="nginx"} |= "error"' --since 1h

# ターミナル上でグラフ表示
gcx metrics query 'sum by(handler)(rate(...)' --since 1h -o graph

AIエージェント統合（Agent Skills）

gcxが特に注目される機能が「Agent Skills」です。Claude Code（/plugin marketplace add grafana/gcx）や他の.agents対応ツールからGrafanaへのアクセスを提供します。アラート調査・ダッシュボード作成・SLO管理・オブザーバビリティセットアップなど22種類のスキルが含まれています。

GitOpsとCI/CD統合

# Grafanaリソースをローカルファイルへ取得
gcx resources pull dashboards -p ./resources -o yaml

# 変更をGrafanaへ適用
gcx resources push -p ./resources

# ドライラン（差分確認）
gcx resources push -p ./resources --dry-run

Grafana CLI 使い方 ターミナルから始めるインストール手順

インストール方法

macOS / Linux（推奨）:

curl -fsSL https://raw.githubusercontent.com/grafana/gcx/main/scripts/install.sh | sh

Homebrew（macOS / Linux）:

brew install grafana/grafana/gcx

Go install:

go install github.com/grafana/gcx/cmd/gcx@latest

認証設定

# Grafana Cloudへ接続（OAuth推奨）
gcx login prod --server https://<your-stack>.grafana.net

# セルフホストGrafanaへ接続（サービスアカウントトークン）
gcx login local --server http://localhost:3000 --token <token>

# CI/CD環境では環境変数で設定
export GRAFANA_SERVER="https://your-instance.grafana.net"
export GRAFANA_TOKEN="your-service-account-token"

活用例：SRE・DevOpsチームでの具体的な使用シナリオ

活用例1：アラート調査の自動化

SREエンジニアがP95レイテンシのアラート発火を受けた際、従来はブラウザでGrafanaを開き、複数のダッシュボードを切り替えながら調査していました。gcxとAIエージェントを組み合わせると、エージェントがgcx alert rules list --state firingでアラート状況を取得し、gcx metrics queryで関連メトリクスを分析して根本原因を特定し、修正コードをPRとして提出するまでをエディタを離れずに完結できます。

活用例2：GrafanaリソースのGitOps管理

DevOpsチームが数十のGrafanaダッシュボードをYAMLファイルとしてGit管理し、gcx resources pushでCI/CDパイプラインから本番Grafanaへ自動デプロイするGitOpsパイプラインを構築できます。--dry-runオプションで差分を事前確認し、--on-error abortでエラー時に自動停止する安全なデプロイが実現します。

Grafana コマンドライン SLO アラート 操作方法：Grafana Cloud製品との統合

gcxはGrafana Cloudの各製品に対応したコマンドを持っています：

製品	コマンド例
SLO	gcx slo definitions list
Synthetic Monitoring	gcx synthetic-monitoring checks list
IRM（インシデント管理）	gcx irm incidents list
k6 Cloud	gcx k6 load-tests list
Fleet Management	gcx fleet pipelines list
Assistant（AI調査）	gcx assistant investigations list

まとめ：gcxはSRE・DevOpsエンジニア必携のCLIツール

gcxはGrafanaの監視業務をターミナルとAIエージェントから完結させる強力なCLIツールです。381スター（2026年6月時点）は公開間もない数字ですが、Grafana公式製品として継続的なサポートが期待できます。

現在はPublic Preview段階ですが、既に豊富な機能を持ち、以下のような方に特に推奨します：

• Grafanaを使うSRE・DevOpsエンジニア
• ターミナル中心のワークフローでGrafana操作を効率化したい方
• AIエージェントを活用してオブザーバビリティを自動化したい方
• GrafanaリソースのGitOps管理を導入したいチーム

関連ツール・おすすめサービス

• DigitalOcean — 開発者向けクラウド・App PlatformでGrafana自己ホストも簡単
• さくらVPS — 国内ホスティングでのGrafanaセルフホストならこちら

この技術を学ぶ

CLIツール・監視・オブザーバビリティに興味を持った方には、Udemyのオンラインコースもおすすめです。

• 🎓 関連するCLI/DevOpsコース一覧 — セール時（最大90%OFF）を狙うとお得です