# Diagnosticar por sintoma: z-request-id localiza 401 / 502 / streams quebrados > Solução de problemas de AI gateway: z-request-id rastreia 401 / 403 / 404 / 502 / 503 / timeout / stream quebrado / OOM de ponta a ponta, normalização de códigos de erro, sem buffer de stream. Triagem por sintoma, não por adivinhação. Canônico: https://www.gatellm.io/pt-BR/use-cases/troubleshooting/ Rastreie 401 / 403 / 404 / 502 / 503 / timeout / stream quebrado / OOM por z-request-id de ponta a ponta — chega de adivinhar. ## Do que a comunidade realmente reclama Perguntas frequentes no StackOverflow: "a resposta em streaming virou um bloco único depois do proxy", "o JSON de chamada de ferramentas não monta", "este 429 é limite de taxa ou cota excedida", "este 502 é do gateway ou do fornecedor". Diagnosticar chamadas de IA é difícil: caminhos com vários saltos, streaming, códigos de erro inconsistentes — quando algo quebra, você não sabe qual salto falhou. ## Como o GateLLM faz isso O GateLLM atribui a cada requisição um z-request-id que percorre todo o log, então você localiza por sintoma: 401 / 403 → autenticação e Header ACL; 404 → roteamento; 502 / 503 → saúde do upstream; timeout → limite de taxa e transoceânico; stream quebrado → buffer e SSE; OOM → configuração. Os códigos de erro são normalizados (semântica de erros entre fornecedores unificada), o streaming passa nativamente sem buffer, e os logs do Token Ops são consultáveis e exportáveis. ## 5 alavancas que realmente funcionam - z-request-id percorre todo o log — localize pelo id em um passo - Triagem por sintoma: 401 / 403 / 404 / 502 / 503 / timeout / stream quebrado / OOM - Normalização de códigos de erro: semântica de erros entre fornecedores unificada em um vocabulário - Repasse nativo de stream, sem buffer, sem quebrar SSE ou chamada de ferramentas - Logs do Token Ops consultáveis e exportáveis, conectados ao diagnóstico e à conciliação ## FAQ ### A resposta em streaming do AI gateway para de fazer streaming depois do proxy? Um proxy ruim faz buffer do stream. O GateLLM repassa streams nativamente sem buffer e faz normalização de capacidades, nunca quebrando SSE ou chamada de ferramentas. ### Como distingo um 429 de limite de taxa de um 429 de cota excedida? O rastreamento ponta a ponta por z-request-id mais a normalização de códigos de erro distinguem o 429 de limite de taxa do 429 de cota excedida — triagem por sintoma em vez de adivinhação. - [Guia completo: Diagnosticar por sintoma (docs)](https://docs.gatellm.io/en/usecases/troubleshooting) ## Relacionados - [Início](https://www.gatellm.io/pt-BR/index.md) - [Preços](https://www.gatellm.io/pt-BR/pricing.md) - [Calculadora de custos](https://www.gatellm.io/pt-BR/calculator.md) - [Sobre](https://www.gatellm.io/pt-BR/about.md) - [Agendar uma demonstração](https://www.gatellm.io/pt-BR/demo.md) - [FAQ](https://www.gatellm.io/pt-BR/faq.md) - [Comparar gateways de IA](https://www.gatellm.io/pt-BR/compare.md) - [Comparar LiteLLM](https://www.gatellm.io/pt-BR/compare/litellm.md) - [Comparar OpenRouter](https://www.gatellm.io/pt-BR/compare/openrouter.md) - [Comparar Alibaba Cloud AI Gateway](https://www.gatellm.io/pt-BR/compare/alibaba-cloud.md) - [Comparar Azure API Management](https://www.gatellm.io/pt-BR/compare/azure-apim.md) - [Comparar Apigee](https://www.gatellm.io/pt-BR/compare/apigee.md) - [Comparar Cloudflare AI Gateway](https://www.gatellm.io/pt-BR/compare/cloudflare.md) - [Comparar Kong AI Gateway](https://www.gatellm.io/pt-BR/compare/kong.md) - [Comparar Portkey](https://www.gatellm.io/pt-BR/compare/portkey.md) - [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/pt-BR/compare/litellm-vs-kong.md) - [LiteLLM vs OpenRouter](https://www.gatellm.io/pt-BR/compare/litellm-vs-openrouter.md) - [LiteLLM vs Portkey](https://www.gatellm.io/pt-BR/compare/litellm-vs-portkey.md) - [Casos de uso](https://www.gatellm.io/pt-BR/use-cases.md) - [Reduzir custo de LLM](https://www.gatellm.io/pt-BR/use-cases/reduce-cost.md) - [Alta disponibilidade](https://www.gatellm.io/pt-BR/use-cases/high-availability.md) - [Isolamento multilocatário](https://www.gatellm.io/pt-BR/use-cases/multi-tenant.md) - [Conformidade e auditoria](https://www.gatellm.io/pt-BR/use-cases/compliance-audit.md) - [Stack de modelos multivendor](https://www.gatellm.io/pt-BR/use-cases/mixed-model-stack.md) - [IA auto-hospedada dentro do Office](https://www.gatellm.io/pt-BR/use-cases/self-hosted-office-ai.md) - [Visibilidade e atribuição do uso de tokens](https://www.gatellm.io/pt-BR/use-cases/token-ops.md) - [Token FinOps: alocação e controle de custos de IA](https://www.gatellm.io/pt-BR/use-cases/token-finops.md) - [Governança de ferramentas MCP](https://www.gatellm.io/pt-BR/use-cases/mcp-tool-governance.md) - [Busca na web para todos os modelos](https://www.gatellm.io/pt-BR/use-cases/web-search-grounding.md) - [Rotação e standby de múltiplas chaves](https://www.gatellm.io/pt-BR/use-cases/multi-key-pooling.md) - [Controle de admissão de clientes](https://www.gatellm.io/pt-BR/use-cases/client-admission-control.md) - [Aplicar política de uso de modelos](https://www.gatellm.io/pt-BR/use-cases/enforce-model-policy.md) - [Sem escolha de modelo no cliente](https://www.gatellm.io/pt-BR/use-cases/automatic-model-tiering.md) - [Um protocolo, qualquer modelo](https://www.gatellm.io/pt-BR/use-cases/one-protocol-any-model.md) - [Suplemento Office / Microsoft 365](https://www.gatellm.io/pt-BR/office-addin.md) - [Glossário](https://www.gatellm.io/pt-BR/glossary.md) - [Catálogo de modelos](https://www.gatellm.io/pt-BR/models.md) - [Integrações de SDK e frameworks](https://www.gatellm.io/pt-BR/integrations.md) - [Agentes de código de IA e harnesses](https://www.gatellm.io/pt-BR/coding-agents.md) - [Segurança e conformidade](https://www.gatellm.io/pt-BR/security.md)