# Diagnostiquer par symptôme : z-request-id localise les 401 / 502 / flux cassés

> Dépannage de passerelle IA : z-request-id trace les 401 / 403 / 404 / 502 / 503 / expirations / flux cassés / OOM de bout en bout, normalisation des codes d’erreur, aucun tamponnage de flux. Trier par symptôme, pas à l’aveugle.

Canonique: https://www.gatellm.io/fr/use-cases/troubleshooting/

Tracez les 401 / 403 / 404 / 502 / 503 / expirations / flux cassés / OOM par z-request-id de bout en bout — fini les suppositions.

## Ce dont la communauté se plaint réellement
Questions StackOverflow très fréquentes : « la réponse en diffusion s’est transformée en un seul bloc après le proxy », « le JSON d’appel d’outils ne s’assemble pas », « est-ce un 429 de limitation de débit ou de quota dépassé », « ce 502 vient-il de la passerelle ou du fournisseur ».
Le dépannage des appels IA est difficile : chemins multi-sauts, diffusion, codes d’erreur incohérents — quand quelque chose casse, vous ne savez pas quel saut est en cause.

## Comment GateLLM procède
GateLLM attribue à chaque requête un z-request-id qui traverse tout le journal, ce qui permet de localiser par symptôme : 401 / 403 → authentification et Header ACL ; 404 → routage ; 502 / 503 → santé de l’amont ; expiration → limite de débit et transocéanique ; flux cassé → tamponnage et SSE ; OOM → configuration.
Les codes d’erreur sont normalisés (sémantique d’erreur inter-fournisseurs unifiée), la diffusion est transmise nativement sans tamponnage, et les journaux Token Ops sont interrogeables et exportables.

## 5 leviers qui portent réellement
- z-request-id traverse tout le journal — localisez par identifiant en une étape
- Triage par symptôme : 401 / 403 / 404 / 502 / 503 / expiration / flux cassé / OOM
- Normalisation des codes d’erreur : sémantique d’erreur inter-fournisseurs unifiée en un seul vocabulaire
- Transmission native des flux, sans tamponnage, sans casser SSE ni l’appel d’outils
- Journaux Token Ops interrogeables et exportables, reliés au dépannage et au rapprochement

## FAQ
### La réponse en diffusion d’une passerelle IA cesse de diffuser après le proxy ?
Un mauvais proxy tamponne le flux. GateLLM transmet les flux nativement sans tamponnage et assure la normalisation des capacités, sans jamais casser SSE ni l’appel d’outils.

### Comment distinguer un 429 de limitation de débit d’un 429 de quota dépassé ?
Le traçage de bout en bout par z-request-id et la normalisation des codes d’erreur distinguent le 429 de limitation de débit du 429 de quota dépassé — triez par symptôme au lieu de deviner.

- [Guide complet : diagnostiquer par symptôme (docs)](https://docs.gatellm.io/en/usecases/troubleshooting)

## Voir aussi
- [Accueil](https://www.gatellm.io/fr/index.md)
- [Tarifs](https://www.gatellm.io/fr/pricing.md)
- [Calculateur de coûts](https://www.gatellm.io/fr/calculator.md)
- [À propos](https://www.gatellm.io/fr/about.md)
- [Réserver une démo](https://www.gatellm.io/fr/demo.md)
- [FAQ](https://www.gatellm.io/fr/faq.md)
- [Comparer les passerelles IA](https://www.gatellm.io/fr/compare.md)
- [Comparer LiteLLM](https://www.gatellm.io/fr/compare/litellm.md)
- [Comparer OpenRouter](https://www.gatellm.io/fr/compare/openrouter.md)
- [Comparer Alibaba Cloud AI Gateway](https://www.gatellm.io/fr/compare/alibaba-cloud.md)
- [Comparer Azure API Management](https://www.gatellm.io/fr/compare/azure-apim.md)
- [Comparer Apigee](https://www.gatellm.io/fr/compare/apigee.md)
- [Comparer Cloudflare AI Gateway](https://www.gatellm.io/fr/compare/cloudflare.md)
- [Comparer Kong AI Gateway](https://www.gatellm.io/fr/compare/kong.md)
- [Comparer Portkey](https://www.gatellm.io/fr/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/fr/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/fr/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/fr/compare/litellm-vs-portkey.md)
- [Cas d’usage](https://www.gatellm.io/fr/use-cases.md)
- [Réduire le coût des LLM](https://www.gatellm.io/fr/use-cases/reduce-cost.md)
- [Haute disponibilité](https://www.gatellm.io/fr/use-cases/high-availability.md)
- [Isolation multi-tenant](https://www.gatellm.io/fr/use-cases/multi-tenant.md)
- [Conformité et audit](https://www.gatellm.io/fr/use-cases/compliance-audit.md)
- [Pile de modèles multi-fournisseurs](https://www.gatellm.io/fr/use-cases/mixed-model-stack.md)
- [Héberger l’IA en interne dans Office](https://www.gatellm.io/fr/use-cases/self-hosted-office-ai.md)
- [Visibilité et attribution des tokens](https://www.gatellm.io/fr/use-cases/token-ops.md)
- [Token FinOps : allocation et contrôle des coûts IA](https://www.gatellm.io/fr/use-cases/token-finops.md)
- [Gouvernance des outils MCP](https://www.gatellm.io/fr/use-cases/mcp-tool-governance.md)
- [Recherche web pour chaque modèle](https://www.gatellm.io/fr/use-cases/web-search-grounding.md)
- [Rotation et secours multi-clés](https://www.gatellm.io/fr/use-cases/multi-key-pooling.md)
- [Contrôle des clients connectés](https://www.gatellm.io/fr/use-cases/client-admission-control.md)
- [Imposer la politique d’usage des modèles](https://www.gatellm.io/fr/use-cases/enforce-model-policy.md)
- [Aucun choix de modèle côté client](https://www.gatellm.io/fr/use-cases/automatic-model-tiering.md)
- [Un protocole, n’importe quel modèle](https://www.gatellm.io/fr/use-cases/one-protocol-any-model.md)
- [Complément Office / Microsoft 365](https://www.gatellm.io/fr/office-addin.md)
- [Glossaire](https://www.gatellm.io/fr/glossary.md)
- [Catalogue de modèles](https://www.gatellm.io/fr/models.md)
- [Intégrations SDK et frameworks](https://www.gatellm.io/fr/integrations.md)
- [Agents de codage IA et harnais](https://www.gatellm.io/fr/coding-agents.md)
- [Sécurité et conformité](https://www.gatellm.io/fr/security.md)