# Диагностика по симптому: z-request-id указывает на 401 / 502 / сломанные потоки > Диагностика AI-шлюза: z-request-id отслеживает 401 / 403 / 404 / 502 / 503 / таймаут / разрыв потока / OOM от начала до конца, нормализация кодов ошибок, без буферизации потока. Триаж по симптому, а не по догадке. Канонический URL: https://www.gatellm.io/ru/use-cases/troubleshooting/ Проследите 401 / 403 / 404 / 502 / 503 / таймаут / разрыв потока / OOM по z-request-id от начала до конца — больше никаких догадок. ## На что на самом деле жалуется сообщество Частые вопросы на StackOverflow: «потоковый ответ после прокси превратился в один блок», «JSON вызова инструментов не собирается», «это 429 из-за лимита частоты или превышения квоты», «этот 502 — шлюз или производитель». Диагностика вызовов AI сложна: многошаговые пути, потоковая передача, несогласованные коды ошибок — когда что-то ломается, непонятно, на каком шаге. ## Как это делает GateLLM GateLLM присваивает каждому запросу z-request-id, который проходит через весь лог, поэтому вы находите по симптому: 401 / 403 → аутентификация и Header ACL; 404 → маршрутизация; 502 / 503 → состояние upstream; таймаут → ограничение частоты и трансконтинентальные задержки; разрыв потока → буферизация и SSE; OOM → конфигурация. Коды ошибок нормализованы (семантика ошибок разных производителей унифицирована), потоковая передача проходит нативно без буферизации, а логи Token Ops доступны для запросов и экспорта. ## 5 рычагов, которые действительно работают - z-request-id проходит через весь лог — найдите по ID за один шаг - Триаж по симптому: 401 / 403 / 404 / 502 / 503 / таймаут / разрыв потока / OOM - Нормализация кодов ошибок: семантика ошибок разных производителей сведена к одному словарю - Нативный проброс потока, без буферизации, без ломки SSE или вызова инструментов - Логи Token Ops доступны для запросов и экспорта, подключены к диагностике и сверке ## FAQ ### Потоковый ответ AI-шлюза перестаёт передаваться после прокси? Плохой прокси буферизует поток. GateLLM пропускает потоки нативно без буферизации и выполняет нормализацию возможностей, никогда не ломая SSE или вызов инструментов. ### Как отличить 429 из-за лимита частоты от 429 из-за превышения квоты? Сквозная трассировка по z-request-id плюс нормализация кодов ошибок различают 429 лимита частоты и 429 превышения квоты — триаж по симптому вместо догадок. - [Полное руководство: диагностика по симптому (документация)](https://docs.gatellm.io/en/usecases/troubleshooting) ## Связанные страницы - [Главная](https://www.gatellm.io/ru/index.md) - [Тарифы](https://www.gatellm.io/ru/pricing.md) - [Калькулятор стоимости LLM](https://www.gatellm.io/ru/calculator.md) - [О нас](https://www.gatellm.io/ru/about.md) - [Заказать демо](https://www.gatellm.io/ru/demo.md) - [FAQ](https://www.gatellm.io/ru/faq.md) - [Сравнить AI-шлюзы](https://www.gatellm.io/ru/compare.md) - [Сравнить LiteLLM](https://www.gatellm.io/ru/compare/litellm.md) - [Сравнить OpenRouter](https://www.gatellm.io/ru/compare/openrouter.md) - [Сравнить Alibaba Cloud AI Gateway](https://www.gatellm.io/ru/compare/alibaba-cloud.md) - [Сравнить Azure API Management](https://www.gatellm.io/ru/compare/azure-apim.md) - [Сравнить Apigee](https://www.gatellm.io/ru/compare/apigee.md) - [Сравнить Cloudflare AI Gateway](https://www.gatellm.io/ru/compare/cloudflare.md) - [Сравнить Kong AI Gateway](https://www.gatellm.io/ru/compare/kong.md) - [Сравнить Portkey](https://www.gatellm.io/ru/compare/portkey.md) - [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/ru/compare/litellm-vs-kong.md) - [LiteLLM vs OpenRouter](https://www.gatellm.io/ru/compare/litellm-vs-openrouter.md) - [LiteLLM vs Portkey](https://www.gatellm.io/ru/compare/litellm-vs-portkey.md) - [Сценарии использования](https://www.gatellm.io/ru/use-cases.md) - [Снижение затрат на LLM](https://www.gatellm.io/ru/use-cases/reduce-cost.md) - [Высокая доступность](https://www.gatellm.io/ru/use-cases/high-availability.md) - [Мультитенантная изоляция](https://www.gatellm.io/ru/use-cases/multi-tenant.md) - [Комплаенс и аудит](https://www.gatellm.io/ru/use-cases/compliance-audit.md) - [Смешанный стек моделей от разных поставщиков](https://www.gatellm.io/ru/use-cases/mixed-model-stack.md) - [ИИ в собственном контуре внутри Office](https://www.gatellm.io/ru/use-cases/self-hosted-office-ai.md) - [Видимость и атрибуция использования токенов](https://www.gatellm.io/ru/use-cases/token-ops.md) - [Token FinOps: распределение и контроль затрат на ИИ](https://www.gatellm.io/ru/use-cases/token-finops.md) - [Управление инструментами MCP](https://www.gatellm.io/ru/use-cases/mcp-tool-governance.md) - [Веб-поиск для всех моделей](https://www.gatellm.io/ru/use-cases/web-search-grounding.md) - [Ротация и резерв нескольких ключей](https://www.gatellm.io/ru/use-cases/multi-key-pooling.md) - [Контроль доступа подключённых клиентов](https://www.gatellm.io/ru/use-cases/client-admission-control.md) - [Принудительная политика использования моделей](https://www.gatellm.io/ru/use-cases/enforce-model-policy.md) - [Без выбора модели на клиенте](https://www.gatellm.io/ru/use-cases/automatic-model-tiering.md) - [Один протокол — любая модель](https://www.gatellm.io/ru/use-cases/one-protocol-any-model.md) - [Надстройка Office / Microsoft 365](https://www.gatellm.io/ru/office-addin.md) - [Глоссарий](https://www.gatellm.io/ru/glossary.md) - [Каталог моделей](https://www.gatellm.io/ru/models.md) - [Интеграции SDK и фреймворков](https://www.gatellm.io/ru/integrations.md) - [ИИ-агенты для кодирования и harness](https://www.gatellm.io/ru/coding-agents.md) - [Безопасность и комплаенс](https://www.gatellm.io/ru/security.md)