Skip to main content
Coralogix アカウントを接続することで、CloudThinker エージェントがログの検索、メトリクスとトレースのクエリ、インシデントのトリアージ、オブザーバビリティスタック全体のデータパイプラインヘルスの調査を行えるようになります。 Coralogix はリージョンにスコープされた API キーで認証します。CloudThinker はリージョンから適切な Coralogix エンドポイントを解決するため、同じセットアップが米国、EU、アジア太平洋のすべてのデータセンターで機能します。

​
サポートされるリージョン

Coralogix チームのログインドメインに対応するリージョンを選択してください。

​
前提条件

  • 調査対象のチームにアクセスできる Coralogix アカウント。
  • CloudThinker がアクセスするオブザーバビリティデータへの読み取り権限を持つ API キー。
  • Coralogix チームのリージョン。
読み取り専用調査に必要な最小限の権限を持つ API キーを使用してください。CloudThinker のセットアップ確認ではデータの読み取りのみを行い、Coralogix リソースを変更することはありません。

​
セットアップ

1

Coralogix を開く

Coralogix アカウントにサインインします。ログイン URL は https://<team>.app.<region>.coralogix.com の形式で、<region> の部分がリージョンになります。
2

API キーを作成する

Settings → Users and Teams → API Keys に移動し、Add key をクリックします。
  • Name: cloudthinker
  • Type: Team Key を選択 — 共有キーのため、個人キーとは異なり作成ユーザーのアクセスが期限切れになっても有効なまま維持されます。個人キーは個人に紐付けられており、テスト用途向けです
  • Permissions: CloudThinker がアクセスするデータへの読み取り権限を付与する
キーを直ちにコピーしてください。後から表示されない場合があります。
3

CloudThinker で接続を追加する

Connections → Coralogix に移動して以下を入力します。
  • API Key: 作成したキー
  • Region: ログイン URL のリージョン（例: eu2）
Connect をクリックします。CloudThinker が認証情報を検証し、Connected ステータスを表示します。
API キーは作成直後にコピーしてください。紛失した場合は新しいキーを作成する必要があります。

​
接続の詳細

CloudThinker はリージョンから Coralogix API エンドポイントを導出するため、URL の手動設定は不要です。

​
必要な権限

CloudThinker が調査するオブザーバビリティデータ（ログ、メトリクス、トレース、インシデント、アラート、コネクタ、解析ルール、プリセット、ダッシュボード）に対して API キーに読み取り権限を付与してください。
最小権限の原則に従ってください。調査には読み取り専用キーで十分です。書き込みワークフローで特に必要でない限り、CloudThinker が使用するキーには変更権限を付与しないでください。

​
エージェントの機能

接続後、エージェントは Coralogix のオブザーバビリティデータへの読み取りアクセスを持ちます。

​
接続の確認

​
プロンプト例

カタログが大きくノイズが多い場合は、エージェントが絞り込んだ結果を返せるよう、短い時間ウィンドウと既知のメトリクスまたはログクエリでリクエストを限定してください。

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

API キーが欠落、期限切れ、または必要な権限がありません。必要な読み取り権限を持つ新しい Coralogix API キーを作成して再接続してください。
API キーが別の Coralogix リージョンに属しています。チームのログインドメインを確認し、CORALOGIX_REGION を更新してください。
メトリクスカタログに一致するメトリクスがないか、アカウントにメトリクスデータがありません。空の結果として扱い、既知のメトリクス名を試すか、インシデントとログで続行してください。
1 つ以上の Coralogix リスト呼び出しでエラーが返されました。API キーの権限とリージョンを確認し、検出を再実行してください。
範囲を限定しないカタログまたはクエリの使用はデータが多すぎます。結果を絞り込むために短い時間ウィンドウと特定のクエリでリクエストを限定してください。

​
セキュリティ

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

​
関連情報

Datadog 接続

ログ検索、メトリクス、監視

Better Stack 接続

アップタイム、インシデント、ログ検索