# Diagnosticar por síntoma: z-request-id localiza 401 / 502 / flujos rotos

> Diagnóstico de gateways de IA: z-request-id rastrea 401 / 403 / 404 / 502 / 503 / tiempos de espera / flujos rotos / OOM de extremo a extremo, normalización de códigos de error y sin almacenamiento en búfer de flujos. Triaje por síntoma, no por conjeturas.

Canonical: https://www.gatellm.io/es/use-cases/troubleshooting/

Rastree 401 / 403 / 404 / 502 / 503 / tiempos de espera / flujos rotos / OOM con z-request-id de extremo a extremo: deje de adivinar.

## De qué se queja realmente la comunidad
Preguntas frecuentes en StackOverflow: "la respuesta en streaming se convirtió en un solo bloque después del proxy", "el JSON de llamada a herramientas no se ensambla", "¿este 429 es límite de velocidad o cuota excedida?", "¿este 502 es del gateway o del proveedor?".
Diagnosticar llamadas de IA es difícil: rutas con varios saltos, streaming y códigos de error inconsistentes; cuando algo se rompe, no sabe en qué salto.

## Cómo lo hace GateLLM
GateLLM asigna a cada solicitud un z-request-id que atraviesa todo el log, así que localiza por síntoma: 401 / 403 → autenticación y Header ACL; 404 → enrutamiento; 502 / 503 → salud del upstream; tiempo de espera → límite de velocidad y ruta transoceánica; flujo roto → almacenamiento en búfer y SSE; OOM → configuración.
Los códigos de error se normalizan (semántica de errores entre proveedores unificada), el streaming pasa de forma nativa sin almacenamiento en búfer y los logs de Token Ops son consultables y exportables.

## 5 palancas que realmente funcionan
- z-request-id atraviesa todo el log: localice por id en un solo paso
- Triaje por síntoma: 401 / 403 / 404 / 502 / 503 / tiempo de espera / flujo roto / OOM
- Normalización de códigos de error: semántica de errores entre proveedores unificada en un solo vocabulario
- Paso nativo de flujos, sin almacenamiento en búfer y sin romper SSE ni las llamadas a herramientas
- Logs de Token Ops consultables y exportables, conectados al diagnóstico y a la conciliación

## Preguntas frecuentes
### ¿La respuesta en streaming de un gateway de IA deja de transmitirse después del proxy?
Un proxy deficiente almacena el flujo en búfer. GateLLM reenvía los flujos de forma nativa sin almacenarlos y hace normalización de capacidades, sin romper nunca SSE ni las llamadas a herramientas.

### ¿Cómo distingo un 429 de límite de velocidad de un 429 de cuota excedida?
El trazado de extremo a extremo con z-request-id más la normalización de códigos de error distinguen el 429 de límite de velocidad del 429 de cuota excedida: haga triaje por síntoma en lugar de adivinar.

- [Guía completa: diagnosticar por síntoma (docs)](https://docs.gatellm.io/en/usecases/troubleshooting)

## Relacionado
- [Inicio](https://www.gatellm.io/es/index.md)
- [Precios](https://www.gatellm.io/es/pricing.md)
- [Calculadora de costos](https://www.gatellm.io/es/calculator.md)
- [Acerca de](https://www.gatellm.io/es/about.md)
- [Reservar una demo](https://www.gatellm.io/es/demo.md)
- [FAQ](https://www.gatellm.io/es/faq.md)
- [Comparar gateways de IA](https://www.gatellm.io/es/compare.md)
- [Comparar LiteLLM](https://www.gatellm.io/es/compare/litellm.md)
- [Comparar OpenRouter](https://www.gatellm.io/es/compare/openrouter.md)
- [Comparar Alibaba Cloud AI Gateway](https://www.gatellm.io/es/compare/alibaba-cloud.md)
- [Comparar Azure API Management](https://www.gatellm.io/es/compare/azure-apim.md)
- [Comparar Apigee](https://www.gatellm.io/es/compare/apigee.md)
- [Comparar Cloudflare AI Gateway](https://www.gatellm.io/es/compare/cloudflare.md)
- [Comparar Kong AI Gateway](https://www.gatellm.io/es/compare/kong.md)
- [Comparar Portkey](https://www.gatellm.io/es/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/es/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/es/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/es/compare/litellm-vs-portkey.md)
- [Casos de uso](https://www.gatellm.io/es/use-cases.md)
- [Reducir el costo de LLM](https://www.gatellm.io/es/use-cases/reduce-cost.md)
- [Alta disponibilidad](https://www.gatellm.io/es/use-cases/high-availability.md)
- [Aislamiento multiusuario](https://www.gatellm.io/es/use-cases/multi-tenant.md)
- [Cumplimiento y auditoría](https://www.gatellm.io/es/use-cases/compliance-audit.md)
- [Stack de modelos multivendor](https://www.gatellm.io/es/use-cases/mixed-model-stack.md)
- [IA autoalojada dentro de Office](https://www.gatellm.io/es/use-cases/self-hosted-office-ai.md)
- [Visibilidad y atribución del uso de tokens](https://www.gatellm.io/es/use-cases/token-ops.md)
- [Token FinOps: asignación y control del costo de IA](https://www.gatellm.io/es/use-cases/token-finops.md)
- [Gobernanza de herramientas MCP](https://www.gatellm.io/es/use-cases/mcp-tool-governance.md)
- [Búsqueda web para todos los modelos](https://www.gatellm.io/es/use-cases/web-search-grounding.md)
- [Rotación y respaldo multi-clave](https://www.gatellm.io/es/use-cases/multi-key-pooling.md)
- [Control de admisión de clientes](https://www.gatellm.io/es/use-cases/client-admission-control.md)
- [Aplicar la política de uso de modelos](https://www.gatellm.io/es/use-cases/enforce-model-policy.md)
- [Sin elección de modelo en el cliente](https://www.gatellm.io/es/use-cases/automatic-model-tiering.md)
- [Un protocolo, cualquier modelo](https://www.gatellm.io/es/use-cases/one-protocol-any-model.md)
- [Complemento para Office / Microsoft 365](https://www.gatellm.io/es/office-addin.md)
- [Glosario](https://www.gatellm.io/es/glossary.md)
- [Catálogo de modelos](https://www.gatellm.io/es/models.md)
- [Integraciones de SDK y frameworks](https://www.gatellm.io/es/integrations.md)
- [Agentes de código IA y harnesses](https://www.gatellm.io/es/coding-agents.md)
- [Seguridad y cumplimiento](https://www.gatellm.io/es/security.md)