> 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/zen-firewall/miscellaneous/zen-firewall-information-for-support.md).

# サポート向け情報

Zen Firewall について Aikido Support にお問い合わせいただく際は、まず以下の確認事項を順にご確認のうえ、チケットに必要な情報を含めてください。これにより、問題をより迅速に診断でき、不要なやり取りを減らせます。

### 1. トークンを確認する

Zen が Aikido と通信するには有効なトークンが必要です。アプリが次の [Zen ダッシュボード](https://app.aikido.dev/runtime/services)に表示されない場合、最初に確認すべきなのはトークンです。

* 確認 `AIKIDO_TOKEN` が、アプリが実際に実行されている環境に設定されていることを確認してください（シェルだけでなく）。
* トークンに余分な引用符や空白が付いていないことを確認してください。
* トークンが正しいアプリに属していることを確認してください — 参照: [Aikido Zen Firewall トークンの作成](/docs/docs-ja/zen-firewall/zen-installation-instructions/creating-an-aikido-zen-firewall-token.md).
* 有効にする [`AIKIDO_DEBUG=true`](/docs/docs-ja/zen-firewall/zen-installation-instructions/configuration-via-environment-variables.md#debugging) そして、起動ログにトークンが検出されたことが記録されていることを確認してください。

### 2. Aikido への接続を確認する

Zen には Aikido のクラウドへのアウトバウンド HTTPS アクセスが必要です。トークンが設定されているにもかかわらずアプリがダッシュボードに表示されない場合、最も可能性が高い原因はネットワーク制限です。

参照: [Zen のアウトバウンドネットワーク接続](/docs/docs-ja/zen-firewall/miscellaneous/outbound-network-connections-for-zen.md) ドメイン（EU、US、ME）の完全な一覧と接続テストコマンドについては、こちらをご覧ください。これらの確認は、アプリが実行されているのと同じホスト（該当する場合は同じコンテナ）から実行し、いずれかが失敗した場合はその出力を共有してください。

### 3. サポートに提供する情報

チケットを開く際は、以下を共有してください:

**アプリと環境**

* Aikido 内のアプリへのリンク [Zen ダッシュボード](https://app.aikido.dev/runtime/services)
* プログラミング言語とランタイムのバージョン（例: Node.js 20、Python 3.12、PHP 8.3）
* フレームワークとバージョン（例: Express、Django、Spring MVC、Laravel、ASP.NET Core）
* Zen パッケージ / ライブラリのバージョン
* オペレーティングシステム、コンテナのベースイメージ、またはホスティングプラットフォーム（例: Ubuntu 24.04、 `php:8.3-fpm`、AWS Lambda、Kubernetes）
* アプリがプロキシ、ロードバランサー、CDN、またはサービスメッシュの背後で動作しているか

**設定**

* モード: ブロッキング（`AIKIDO_BLOCK=true`）または検出のみ
* その他の `AIKIDO_*` 設定している環境変数 — 参照: [環境変数による設定](/docs/docs-ja/zen-firewall/zen-installation-instructions/configuration-via-environment-variables.md)

**問題の再現性**

* この問題は一貫して再現できますか？
* 単一のエンドポイントに影響しますか、それとも複数のエンドポイントに影響しますか？
* 問題を発生させるサンプルリクエスト（シークレットと PII は伏せてください）
* 期待していた動作と実際に起きたこと

**デバッグログ**

1. 設定 `AIKIDO_DEBUG=true` アプリが実行されている環境で。
2. アプリを再起動して、問題を再現してください。
3. ログの該当箇所を取得し、チケットに添付してください。どの行が Zen のものかわからない場合は、次を検索してください: `Aikido` または `Zen` が出力内に含まれているかを確認してください。

Zen の出力先は、ランタイムによって異なります:

* **Node.js** — Node プロセスの stdout / stderr です。プロセスマネージャー（PM2、systemd、Docker、Kubernetes、 `npm start` コンソールなど）がそれらを収集する場所を確認してください。
* **Python** — Python プロセスの stdout / stderr です。Gunicorn や Uvicorn などの WSGI / ASGI サーバーを使用している場合は、ワーカーに設定されているエラーログの出力先を確認してください（例: Gunicorn の `--error-logfile`、またはフォアグラウンドで実行している場合は stdout）。
* **PHP** — SAPI によります:
  * Apache（`mod_php`）：Apache のエラーログ（ `ErrorLog` ディレクティブで設定されたパス。通常は `/var/log/apache2/error.log`).
  * PHP-FPM: `error_log` が FPM プールに設定されているほか、上流の Web サーバーのエラーログも確認してください。
  * FrankenPHP: Caddy / FrankenPHP の stdout、または設定している場合は Caddy のログファイル。
  * CLI ワーカー（queue、cron、artisan）: コマンドの stderr。
* **Java（Spring、Javalin など）** — アプリケーションで設定されているログフレームワーク（SLF4J / Logback / Log4j2）です。Zen のメッセージは、他のアプリログと同じ出力先（コンソール、ログファイル、コンテナ内では stdout への JSON 出力など）に表示されます。
* **.NET（ASP.NET Core / Framework）** — アプリケーションで設定されている `ILogger` の出力先です。既定の Console ロガーでは stdout になります（次から確認できます: `dotnet run`, `journalctl`、またはコンテナログ）。IIS でホストされているアプリでは、stdout は次の場合にのみログファイル経由で確認できます: `stdoutLogEnabled="true"` が `web.config`.
* **Ruby on Rails** — Rails のロガー（`log/development.log`, `log/production.log`、または設定した任意の場所）。単体の Ruby スクリプトは stderr にログを出力します。
* **Go** — Go バイナリの stdout / stderr です。

コンテナまたはサーバーレスプラットフォーム（Docker、Kubernetes、AWS Lambda / CloudWatch、Cloud Run、App Service、Heroku、Fly.io など）で実行している場合でも、上記の行はプロセスから引き続き出力されます。ただし、プラットフォームのログコレクターに転送されるだけです。そこからログを取得してください。

上記すべてを提供いただくことで、フレームワーク、ランタイム、または環境に固有の問題をより効率的に特定できます。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/zen-firewall/miscellaneous/zen-firewall-information-for-support.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.