> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/sonono/siem-connectors/coralogix.md).

# Coralogix

{% hint style="info" %}
この SIEM コネクタは現在、リクエストに応じて利用可能です。 [サポートまでお問い合わせください](https://www.aikido.dev/contact) ワークスペースで有効化してもらうために。
{% endhint %}

Aikido の問題を Coralogix に送信して一元監視し、セキュリティの検出結果を他のオブザーバビリティデータとあわせて検索できるようにします。

チームがすでに Coralogix を使っていて、Aikido の検出結果をインフラ、アプリケーション、監査シグナルと相関付ける単一の場所が欲しい場合に便利です。

### 要件

接続する前に、Coralogix から次の情報を取得してください:

* **リージョン** - アカウントがプロビジョニングされている Coralogix のリージョン（`us1`, `us2`, `us3`, `eu1`, `eu2`, `ap1`, `ap2`、または `ap3`）。これは、データの送信先となるリージョナルエンドポイントを決定するため、アカウントと一致している必要があります。
* **Send-Your-Data API キー** - Coralogix アカウントから取得します。
* **アプリケーション名とサブシステム名** - Coralogix が受信データを整理するために使用するラベルです。

### Coralogix への接続

{% stepper %}
{% step %}

#### Coralogix の認証情報を取得する

1. Coralogix にサインインし、アカウント URL を次と照合してください [Coralogix のエンドポイント一覧](https://coralogix.com/docs/integrations/coralogix-endpoints/) で確認してください **リージョン**.
2. Coralogix で次へ移動します **設定 > API キー** に移動し、 **キーを追加**.
3. 選択します **Send Your Data キー**に名前（例: 「Aikido」）を付けて、作成します。
4. キーはすぐにコピーしてください。Coralogix では 1 回しか表示されません。
   {% endstep %}

{% step %}

#### SIEM を接続する

次へ移動します： **Settings > Integrations** Aikido アプリで、新しい SIEM 統合を追加します。 **SIEM を接続する** ダイアログで次を選択します： **Coralogix** を選択して、次を入力します：

**設定**

* **リージョン** - アカウントがプロビジョニングされている Coralogix のリージョン。既定値は `us1`.
* **アプリケーション名** - 各レコードに付与されます。Coralogix はこれを使って環境やテナントを分離します。例: `aikido`.
* **サブシステム名** - 各レコードに付与されます。Coralogix はこれを使って、アプリケーション内のコンポーネントを分離します。例: `prod`.
* **通信タイプ** - Coralogix に到達するために使用するトランスポート。現在は **REST（Send-Your-Data）** のみサポートされています。
* **Send-Your-Data API キー** - Coralogix で生成したキー。

**オプション**

* **タイムスタンプのレコード位置** *（任意）* - 受信データ内のタイムスタンプフィールドを指す JSONPath または gjson パス（例: `$.timestamp`）。空欄にすると、送信時刻で各レコードに付与されます。
* **バッチ設定** - 送信前のデータのバッチ方法を制御します:
  * **バッチデータサイズ** - 送信前のバッチの最大合計サイズ（バイト）。既定値は Coralogix の 1 リクエストあたり 2 MB の制限を下回るようになっています。
  * **バッチレコード数** - バッチが自動送信される前に蓄積するレコードの最大数。
  * **最大フラッシュ間隔** - サイズや件数に関係なく、送信前にレコードを保持する最大時間（秒）。

クリックします **接続をテスト** Aikido が Coralogix に到達できることを確認し、次に **変更を保存**.
{% endstep %}

{% step %}

#### 同期する問題を設定

Coralogix の連携ページで、以下の項目の下に **Issue 入力設定**、同期するAikidoの問題を設定します：

* **問題のステータス** － たとえば、未解決の問題のみを同期するか、解決済みや無視された問題も含めるかを選択します。
* **最小重大度** － 同期する最小の重大度レベル。
* **問題の種類** － 特定の問題タイプに限定するか、すべてを同期します。
* **Language** － 特定の言語に限定するか、すべてを同期します。
* **同期頻度** - Aikido が一致する問題を Coralogix に送信する頻度（例: 1 時間ごと）。

クリックします **設定を保存**.
{% endstep %}
{% endstepper %}

### イベントが届いていることを確認する

Coralogix で、次の項目の下のレコードを検索します **アプリケーション名** と **サブシステム名** 設定した内容。設定した同期頻度が経過するのを待つか、Aikido でテスト問題を発生させて、表示されることを確認します。

### 制限事項

* 2 MB を超えるリクエストは Coralogix によって拒否されます。既定のバッチサイズはこれを下回りますが、増やすと `413` エラーが発生する可能性があります。
* **アプリケーション名** と **サブシステム名** は接続全体で固定されるため、問題ごとに変えることはできません。
* REST（Send-Your-Data）トランスポートのみサポートされています。
* 30 秒以内に完了しないリクエストは失敗として扱われ、再試行されます。

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

* **接続拒否またはタイムアウト** - 確認してください **リージョン** が、実際に Coralogix アカウントがプロビジョニングされているリージョンと一致していること。誤ったリージョンはタイムアウトや `401`/`403` エラーが発生する可能性があります。
* **`401` / `403` エラーの原因になります** - Send-Your-Data API キーを再生成し、次の権限があることを確認してください `SendData` 権限。キーはリージョン単位で管理されるため、別の Coralogix アカウントやリージョンのキーは使えません。
* **`413 ペイロードが大きすぎます`** - 減らしてください **バッチデータサイズ** 。これにより、バッチが Coralogix の 2 MB リクエスト上限を下回ります。
* **`429 リクエストが多すぎます`** - Coralogix がアカウントにレート制限をかけています。同期頻度を下げるか、Coralogix に連絡して取り込み上限を引き上げてもらってください。
* **レコードの時刻が正しくありません** - 次を設定してください **タイムスタンプのレコード位置** イベント時刻を持つフィールドに。
* **レコードが誤ったアプリまたはサブシステムの下に表示される** - 次を再確認してください **アプリケーション名** と **サブシステム名**。どちらも各レコードにそのまま付与されます。

### 統合の管理

次から： **設定 > 連携 > Coralogix** Aikido で、次のことができます：

* **統合を管理** - リージョン、アプリケーション/サブシステム名、バッチ設定、または API キーを更新してください。
* **統合を削除** - Coralogix の接続を解除します。これにより今後の同期は停止しますが、すでに Coralogix に送信されたデータは削除されません。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.aikido.dev/docs/docs-ja/sonono/siem-connectors/coralogix.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.