Skip to main content
Grafanaインスタンスを接続することで、CloudThinkerエージェントがダッシュボードへのアクセス、メトリクスのクエリ、分析中の可視化の参照を行えるようになります。 GrafanaはViewerロールにスコープされたサービスアカウントトークンで認証します。

対応プラットフォーム


前提条件

  • CloudThinkerから到達可能な Grafanaインスタンス(OSS、Enterprise、またはCloud)。
  • Administration → Users and access → Service Accounts でサービスアカウントを作成するための管理者アクセス。
  • GrafanaインスタンスのURL。

セットアップ

1

Grafanaを開く

Grafanaインスタンスにアクセスし、管理者権限でサインインします。
2

サービスアカウントへ移動

Administration → Users and access → Service Accounts へ移動します。
3

サービスアカウントを作成

Add service account をクリックし、次の情報を入力します:
  • Name: cloudthinker-readonly
  • Role: Viewer を選択
Create をクリックしてサービスアカウントを作成します。
4

トークンを生成

新しいサービスアカウントのページで:
  1. Add service account token をクリック
  2. トークン名を入力(例: cloudthinker-token
  3. 必要に応じて有効期限を設定
  4. Generate token をクリック
  5. トークンをすぐにコピー — 再表示されません
5

CloudThinkerで接続を追加

Connections → Grafana に移動し、次の情報を入力します:
  • Grafana URL: インスタンスURL(例: https://grafana.your-domain.com
  • Service Account Token: コピーしたトークン
Connect をクリックします。CloudThinkerが認証情報を検証し、Connected ステータスを表示します。
サービスアカウントトークンは生成直後にコピーしてください。Grafanaはトークンを再表示しないため、紛失した場合は新しいトークンを作成する必要があります。

接続の詳細


必要な権限

読み取り専用の調査には Viewer ロールを割り当ててください。アノテーションの作成やダッシュボードスナップショットが必要な場合のみEditorを使用してください。

エージェント機能

接続後、エージェントは次のことができます:

接続を確認

プロンプト例

対応データソース

CloudThinkerはGrafanaの設定済みデータソースを通じてクエリできます:

トラブルシューティング

  • Grafana URLがCloudThinkerからアクセス可能であることを確認してください。
  • SSL証明書が有効であることを確認してください。
  • プロキシが接続をブロックしていないことを確認してください。
  • Grafanaが実行中で到達可能であることを確認してください。
  • サービスアカウントトークンが正しいことを確認してください。
  • トークンが期限切れになっていないことを確認してください。
  • サービスアカウントがアクティブであることを確認してください。
  • アカウントにIP制限が設定されていないことを確認してください。
  • Administration → Service Accounts に移動します。
  • CloudThinkerのサービスアカウントを選択します。
  • 新しいトークンを生成します。
  • CloudThinkerの接続設定でトークンを更新します。
  • サービスアカウントにViewerロールが割り当てられていることを確認してください。
  • フォルダ権限にサービスアカウントが含まれていることを確認してください。
  • ダッシュボードが制限付きフォルダに含まれていないことを確認してください。

セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • Viewerロールのみ — CloudThinkerサービスアカウントにEditorまたはAdminロールを付与しないでください
  • トークンの有効期限 — 有効期限を設定し、90日ごとにサービスアカウントトークンをローテーションしてください

関連情報

Elasticsearch 接続

ログデータソースの接続

AWS 接続

CloudWatchメトリクスの接続