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

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

Coralogix チームのログインドメインに対応するリージョンを選択してください。
データセンターリージョン
米国us1, us2, us3
ヨーロッパeu1, eu2
アジア太平洋ap1, ap2, ap3

​
前提条件

  • 調査対象のチームにアクセスできる 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 キーは作成直後にコピーしてください。紛失した場合は新しいキーを作成する必要があります。

​
接続の詳細

フィールド説明例
CORALOGIX_API_KEYCoralogix API キー—
CORALOGIX_REGIONチームのログインドメインのリージョンus2
CloudThinker はリージョンから Coralogix API エンドポイントを導出するため、URL の手動設定は不要です。

​
必要な権限

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

​
エージェントの機能

接続後、エージェントは Coralogix のオブザーバビリティデータへの読み取りアクセスを持ちます。
機能説明
検出アカウントのヘルスをまとめる — アクティブなインシデント、コネクタ数、無効化された解析ルール、メトリクスの不一致処理
インシデントトリアージアクティブなインシデントとそのコンテキストを一覧表示・調査する
ログ時間ウィンドウでログを検索・分析する
メトリクスメトリクスをクエリし、メトリクスカタログを調査する
トレース分散トレースを調査する
パイプラインヘルスコネクタ、解析ルール、プリセットの設定ミスをレビューする
アラートとダッシュボードアラート定義とダッシュボードを調査する

​
接続の確認

@alex run Coralogix discovery and summarize active incidents, connector count, disabled parsing rule count, and whether metric no-match handling is healthy

​
プロンプト例

@alex triage active Coralogix incidents and #report anything affecting production
@alex search Coralogix logs for 5xx errors in the api-gateway over the last hour
@alex check Coralogix pipeline health and list any disabled parsing rules
カタログが大きくノイズが多い場合は、エージェントが絞り込んだ結果を返せるよう、短い時間ウィンドウと既知のメトリクスまたはログクエリでリクエストを限定してください。

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

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

​
セキュリティ

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

​
関連情報

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48

Datadog 接続

ログ検索、メトリクス、監視
https://mintcdn.com/cloudthinker/uIxpc0ZqZtveGXWt/images/icons/betterstack.svg?fit=max&auto=format&n=uIxpc0ZqZtveGXWt&q=85&s=61b580a94f2f0b8abd07eb7f494739c2

Better Stack 接続

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