Skip to main content
Prometheus互換の監視バックエンドを接続することで、CloudThinkerエージェントがPromQLクエリを実行し、メトリクスとラベルを探索し、スクレイプターゲットのヘルスを検査し、アクティブなアラートを相関付けられるようになります。すべての操作は読み取り専用です。
このコネクターは、標準のPrometheus HTTP APIを使用するすべてのバックエンドで動作します: セルフホスト Prometheus、Thanos、VictoriaMetrics、および Grafana Cloud。認証は None、Bearer Token、Basic Auth をサポートします。

​
対応プラットフォーム

マネージドのMimirベースエンドポイント（Grafana Cloud）では、/api/v1/targets、/rules、/alerts パスが公開されておらず404を返します。これは想定通りの動作です。クエリAPI（インスタントクエリ、レンジクエリ、ラベル、メタデータ）は正常に動作します。

​
前提条件

  • CloudThinkerからHTTPS経由で到達可能な Prometheus互換エンドポイント — セルフホストPrometheus、Thanos、VictoriaMetrics、またはGrafana Cloud。
  • エンドポイントが認証を必要とする場合の認証情報: bearerトークン（Bearer Tokenモード）またはユーザー名とパスワード（Basic Authモード）。
  • Grafana Cloud の場合、数値のインスタンスIDと metrics:read スコープのアクセスポリシートークン。

​
認証モードの選択

エンドポイントの公開方法に合ったモードを選択してください:
Grafana Cloud の場合、ユーザー名は数値のインスタンスIDで、パスワードはmetricsの読み取りスコープを持つアクセスポリシートークンです。

​
セットアップ

1

PrometheusのURLを確認

Prometheus HTTP APIのベースURLを特定します（例: https://prometheus.your-domain.com またはGrafana CloudのPrometheusクエリエンドポイント）。CloudThinkerは標準の /api/v1/... パスを自動的に付加します。
2

認証情報を準備（必要な場合）

  • None — 準備不要。エンドポイントは認証なしで到達可能です。
  • Bearer Token — プロキシまたはゲートウェイが期待するbearerトークンを取得します。
  • Basic Auth — ユーザー名とパスワードを取得します（Grafana Cloudの場合は数値のインスタンスIDとアクセスポリシートークン）。
3

CloudThinkerで接続を追加

Connections → Prometheus に移動し、次の情報を入力します:
  • PROMETHEUS_URL: エンドポイント（例: https://prometheus.your-domain.com）
  • PROMETHEUS_AUTH_TYPE: None、Bearer Token、または Basic Auth を選択
選択に応じて認証情報フィールドが表示されます:
  • Bearer Token → PROMETHEUS_TOKEN
  • Basic Auth → PROMETHEUS_USERNAME と PROMETHEUS_PASSWORD
Connect をクリックします。CloudThinkerがエンドポイントを検証し、Connected ステータスを表示します。

​
接続の詳細

​
必要な権限

Prometheusコネクターは読み取り専用です。エージェントはクエリと検査を行いますが、監視バックエンドへの書き込みは行いません。
  • Grafana Cloud の場合、metrics:read スコープのみのアクセスポリシートークンを作成してください。
  • 保護されたエンドポイントの場合、認証情報がクエリ、ラベル、ターゲット、ルール、アラートAPIパスに到達できることを確認してください。
Grafana Cloudでは、アクセスポリシートークンを metrics:read のみにスコープしてください。CloudThinkerに必要なスコープはそれだけです。

​
エージェント機能

Prometheusコネクターは読み取り専用です。エージェントはクエリと検査を行いますが、監視バックエンドを変更することはありません。

​
接続を確認

​
プロンプト例

Prometheusにはラベル値を取得するツールがありません。ラベル列挙はラベル名のみを返します。エージェントが正確なPromQLセレクターを構築できるよう、メトリクス名と関心のあるラベルを明示してください。

​
トラブルシューティング

  • PROMETHEUS_AUTH_TYPE がエンドポイントの期待する方式と一致しているか確認してください。
  • Bearer の場合、トークンが最新で失効していないことを確認してください。
  • Basic の場合、ユーザー名/パスワードを確認してください。Grafana Cloudでは、ユーザー名が数値のインスタンスIDで、パスワードがアクセスポリシートークンであることを確認してください。
  • マネージドのMimirベースエンドポイント（Grafana Cloud）では想定される動作です。これらのパスは公開されていません。
  • クエリAPI（インスタント、レンジ、ラベル、メタデータ）は引き続き動作します。ターゲット/ルール検査の代わりにクエリを使用してください。
  • PROMETHEUS_URL がCloudThinkerからHTTPS経由で到達可能であることを確認してください。
  • セルフホストまたはネットワーク制限付きエンドポイントの場合、CloudThinkerからのネットワークパスがあることを確認してください。
  • URLから末尾の /api/v1 を削除してください。ベースURLのみを入力してください。
  • ラベルでスライスする前に、探索クエリでメトリクスの存在を確認してください。
  • 時間ウィンドウを広げてください。リクエストした範囲にサンプルがない可能性があります。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • 設計上読み取り専用 — コネクターは監視バックエンドへの書き込みを行いません。書き込み権限は不要です
  • 最小権限の認証情報 — Grafana Cloudでは、アクセスポリシートークンをメトリクス読み取りのみにスコープしてください

​
関連情報

Grafana 接続

ダッシュボードと統合オブザーバビリティ

Datadog 接続

ログ検索、メトリクス、インフラストラクチャ監視