> 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 サポートにお問い合わせいただく際は、まず以下の確認事項を順番に実施し、チケットに必要情報を含めてください。これにより、問題の診断をより早く行え、不要なやり取りを減らせます。

### 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 パッケージ / ライブラリのバージョン
* OS、コンテナのベースイメージ、またはホスティングプラットフォーム（例: 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 プールで設定された error\_log と、上流の 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.