# 症状からトラブルシューティング：z-request-id で 401 / 502 / ストリーム断を特定 > AI ゲートウェイのトラブルシューティング：z-request-id が 401 / 403 / 404 / 502 / 503 / タイムアウト / ストリーム断 / OOM をエンドツーエンドに追跡、エラーコードの正規化、ストリームのバッファリングなし。推測ではなく症状で切り分け。 正規 URL: https://www.gatellm.io/ja/use-cases/troubleshooting/ 401 / 403 / 404 / 502 / 503 / タイムアウト / ストリーム断 / OOM を z-request-id でエンドツーエンドに追跡し、推測をやめられます。 ## コミュニティが実際に不満を言っていること StackOverflow で頻出する質問：「プロキシを通したらストリーミングのレスポンスが 1 つの塊になった」「ツール呼び出しの JSON が組み立たない」「この 429 はレート制限かクォータ超過か」「この 502 はゲートウェイかベンダーか」。 AI 呼び出しのトラブルシューティングは難しいものです。多段の経路、ストリーミング、一貫しないエラーコード。何かが壊れたとき、どのホップか分かりません。 ## GateLLM の実現方法 GateLLM は各リクエストに z-request-id を付与し、ログ全体を通します。症状から特定できます。401 / 403 → 認証と Header ACL、404 → ルーティング、502 / 503 → アップストリームの健全性、タイムアウト → レート制限と越境、ストリーム断 → バッファリングと SSE、OOM → 設定。 エラーコードは正規化され（クロスベンダーのエラーセマンティクスを統一）、ストリーミングはバッファリングせずネイティブに通し、Token Ops のログは照会・エクスポートできます。 ## 実際に効果が出る 5 つのレバー - z-request-id がログ全体を通るため、ID で一発特定 - 症状からの切り分け：401 / 403 / 404 / 502 / 503 / タイムアウト / ストリーム断 / OOM - エラーコードの正規化：クロスベンダーのエラーセマンティクスを 1 つの語彙に統一 - ネイティブなストリームのパススルー。バッファリングせず、SSE やツール呼び出しを壊さない - Token Ops のログは照会・エクスポートでき、トラブルシューティングと照合に使える ## FAQ ### AI ゲートウェイのストリーミングレスポンスがプロキシ後に止まるのは？ 粗悪なプロキシはストリームをバッファリングします。GateLLM はストリームをバッファリングせずネイティブに通し、ケイパビリティ正規化を行うため、SSE やツール呼び出しを壊しません。 ### レート制限の 429 とクォータ超過の 429 をどう見分けますか？ z-request-id によるエンドツーエンド追跡とエラーコードの正規化により、レート制限の 429 とクォータ超過の 429 を区別できます。推測ではなく症状から切り分けられます。 - [詳細手順：症状からのトラブルシューティング（docs）](https://docs.gatellm.io/en/usecases/troubleshooting) ## 関連ページ - [ホーム](https://www.gatellm.io/ja/index.md) - [料金](https://www.gatellm.io/ja/pricing.md) - [コスト計算ツール](https://www.gatellm.io/ja/calculator.md) - [会社概要](https://www.gatellm.io/ja/about.md) - [デモを予約](https://www.gatellm.io/ja/demo.md) - [FAQ](https://www.gatellm.io/ja/faq.md) - [AI ゲートウェイ比較](https://www.gatellm.io/ja/compare.md) - [LiteLLM 比較](https://www.gatellm.io/ja/compare/litellm.md) - [OpenRouter 比較](https://www.gatellm.io/ja/compare/openrouter.md) - [Alibaba Cloud AI Gateway 比較](https://www.gatellm.io/ja/compare/alibaba-cloud.md) - [Azure API Management 比較](https://www.gatellm.io/ja/compare/azure-apim.md) - [Apigee 比較](https://www.gatellm.io/ja/compare/apigee.md) - [Cloudflare AI Gateway 比較](https://www.gatellm.io/ja/compare/cloudflare.md) - [Kong AI Gateway 比較](https://www.gatellm.io/ja/compare/kong.md) - [Portkey 比較](https://www.gatellm.io/ja/compare/portkey.md) - [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/ja/compare/litellm-vs-kong.md) - [LiteLLM vs OpenRouter](https://www.gatellm.io/ja/compare/litellm-vs-openrouter.md) - [LiteLLM vs Portkey](https://www.gatellm.io/ja/compare/litellm-vs-portkey.md) - [ユースケース](https://www.gatellm.io/ja/use-cases.md) - [LLM コスト削減](https://www.gatellm.io/ja/use-cases/reduce-cost.md) - [高可用性](https://www.gatellm.io/ja/use-cases/high-availability.md) - [マルチテナント分離](https://www.gatellm.io/ja/use-cases/multi-tenant.md) - [コンプライアンスと監査](https://www.gatellm.io/ja/use-cases/compliance-audit.md) - [マルチベンダー混合モデル構成](https://www.gatellm.io/ja/use-cases/mixed-model-stack.md) - [Office 内での AI セルフホスト](https://www.gatellm.io/ja/use-cases/self-hosted-office-ai.md) - [Token 使用量の可視化と帰属](https://www.gatellm.io/ja/use-cases/token-ops.md) - [Token FinOps：AI コストの配賦と統制](https://www.gatellm.io/ja/use-cases/token-finops.md) - [MCP ツールガバナンス](https://www.gatellm.io/ja/use-cases/mcp-tool-governance.md) - [すべてのモデルに Web 検索を追加](https://www.gatellm.io/ja/use-cases/web-search-grounding.md) - [マルチキーのローテーションと待機系](https://www.gatellm.io/ja/use-cases/multi-key-pooling.md) - [接続クライアントの受付制御](https://www.gatellm.io/ja/use-cases/client-admission-control.md) - [モデル利用ポリシーの強制](https://www.gatellm.io/ja/use-cases/enforce-model-policy.md) - [クライアントにモデル選択を公開しない](https://www.gatellm.io/ja/use-cases/automatic-model-tiering.md) - [1 つのプロトコルで、あらゆるモデル](https://www.gatellm.io/ja/use-cases/one-protocol-any-model.md) - [Office / Microsoft 365 アドイン](https://www.gatellm.io/ja/office-addin.md) - [用語集](https://www.gatellm.io/ja/glossary.md) - [モデルカタログ](https://www.gatellm.io/ja/models.md) - [SDK・フレームワーク連携](https://www.gatellm.io/ja/integrations.md) - [AI コーディングエージェントとハーネス](https://www.gatellm.io/ja/coding-agents.md) - [セキュリティとコンプライアンス](https://www.gatellm.io/ja/security.md)