> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Coralogix

> CloudThinker と Coralogix を接続して、ログ検索、メトリクス、トレース、インシデントトリアージ、パイプラインヘルス調査を実現する

Coralogix アカウントを接続することで、CloudThinker エージェントがログの検索、メトリクスとトレースのクエリ、インシデントのトリアージ、オブザーバビリティスタック全体のデータパイプラインヘルスの調査を行えるようになります。

Coralogix は**リージョン**にスコープされた **API キー**で認証します。CloudThinker はリージョンから適切な Coralogix エンドポイントを解決するため、同じセットアップが米国、EU、アジア太平洋のすべてのデータセンターで機能します。

***

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

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

| データセンター | リージョン               |
| ------- | ------------------- |
| 米国      | `us1`, `us2`, `us3` |
| ヨーロッパ   | `eu1`, `eu2`        |
| アジア太平洋  | `ap1`, `ap2`, `ap3` |

***

## 前提条件

* 調査対象のチームにアクセスできる **Coralogix アカウント**。
* CloudThinker がアクセスするオブザーバビリティデータへの読み取り権限を持つ **API キー**。
* Coralogix チームの**リージョン**。

<Info>
  読み取り専用調査に必要な最小限の権限を持つ API キーを使用してください。CloudThinker のセットアップ確認ではデータの読み取りのみを行い、Coralogix リソースを変更することはありません。
</Info>

***

## セットアップ

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

  <Step title="API キーを作成する">
    **Settings → Users and Teams → API Keys** に移動し、**Add key** をクリックします。

    * **Name**: `cloudthinker`
    * **Type**: **Team Key** を選択 — 共有キーのため、個人キーとは異なり作成ユーザーのアクセスが期限切れになっても有効なまま維持されます。個人キーは個人に紐付けられており、テスト用途向けです
    * **Permissions**: CloudThinker がアクセスするデータへの読み取り権限を付与する

    キーを直ちにコピーしてください。後から表示されない場合があります。
  </Step>

  <Step title="CloudThinker で接続を追加する">
    **Connections → Coralogix** に移動して以下を入力します。

    * **API Key**: 作成したキー
    * **Region**: ログイン URL のリージョン（例: `eu2`）

    **Connect** をクリックします。CloudThinker が認証情報を検証し、**Connected** ステータスを表示します。
  </Step>
</Steps>

<Warning>
  API キーは作成直後にコピーしてください。紛失した場合は新しいキーを作成する必要があります。
</Warning>

***

## 接続の詳細

| フィールド                   | 説明                 | 例     |
| ----------------------- | ------------------ | ----- |
| **CORALOGIX\_API\_KEY** | Coralogix API キー   | —     |
| **CORALOGIX\_REGION**   | チームのログインドメインのリージョン | `us2` |

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

***

## 必要な権限

CloudThinker が調査するオブザーバビリティデータ（ログ、メトリクス、トレース、インシデント、アラート、コネクタ、解析ルール、プリセット、ダッシュボード）に対して API キーに**読み取り**権限を付与してください。

<Tip>
  最小権限の原則に従ってください。調査には読み取り専用キーで十分です。書き込みワークフローで特に必要でない限り、CloudThinker が使用するキーには変更権限を付与しないでください。
</Tip>

***

## エージェントの機能

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

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

### 接続の確認

```text theme={null}
@alex run Coralogix discovery and summarize active incidents, connector count, disabled parsing rule count, and whether metric no-match handling is healthy
```

### プロンプト例

```text theme={null}
@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
```

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

***

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

<Accordion title="401 または 403 Unauthorized">
  API キーが欠落、期限切れ、または必要な権限がありません。必要な読み取り権限を持つ新しい Coralogix API キーを作成して再接続してください。
</Accordion>

<Accordion title="404 Not Found">
  API キーが別の Coralogix リージョンに属しています。チームのログインドメインを確認し、**CORALOGIX\_REGION** を更新してください。
</Accordion>

<Accordion title="メトリクスが見つからない">
  メトリクスカタログに一致するメトリクスがないか、アカウントにメトリクスデータがありません。空の結果として扱い、既知のメトリクス名を試すか、インシデントとログで続行してください。
</Accordion>

<Accordion title="検出でデグレード状態が表示される">
  1 つ以上の Coralogix リスト呼び出しでエラーが返されました。API キーの権限とリージョンを確認し、検出を再実行してください。
</Accordion>

<Accordion title="出力が大きい、またはノイズが多い">
  範囲を限定しないカタログまたはクエリの使用はデータが多すぎます。結果を絞り込むために短い時間ウィンドウと特定のクエリでリクエストを限定してください。
</Accordion>

***

## セキュリティ

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

- **正しいリージョン** — API キーのリージョンを Coralogix チームのログインドメインと一致させてください。リージョンが一致しない場合は 404 エラーが発生します。

***

## 関連情報

<CardGroup cols={2}>
  <Card title="Datadog 接続" icon="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" href="/ja/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    ログ検索、メトリクス、監視
  </Card>

  <Card title="Better Stack 接続" icon="https://mintcdn.com/cloudthinker/uIxpc0ZqZtveGXWt/images/icons/betterstack.svg?fit=max&auto=format&n=uIxpc0ZqZtveGXWt&q=85&s=61b580a94f2f0b8abd07eb7f494739c2" href="/ja/guide/connections/betterstack" width="24" height="24" data-path="images/icons/betterstack.svg">
    アップタイム、インシデント、ログ検索
  </Card>
</CardGroup>