> 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` の sink を確認してください。既定の Console ロガーでは stdout です（ `dotnet run`, `journalctl`、またはコンテナログから確認できます）。IIS でホストされるアプリは、 `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.