# Fehlerbehebung nach Symptom: z-request-id lokalisiert 401 / 502 / abgebrochene Streams

> KI-Gateway-Fehlerbehebung: z-request-id verfolgt 401 / 403 / 404 / 502 / 503 / Timeout / abgebrochenen Stream / OOM Ende-zu-Ende, Fehlercode-Normalisierung, keine Stream-Pufferung. Triage nach Symptom, nicht nach Vermutung.

Kanonisch: https://www.gatellm.io/de/use-cases/troubleshooting/

Verfolgen Sie 401 / 403 / 404 / 502 / 503 / Timeout / abgebrochenen Stream / OOM Ende-zu-Ende per z-request-id — kein Raten mehr.

## Worüber die Community tatsächlich klagt
Häufige StackOverflow-Fragen: „Streaming-Antwort wurde nach dem Proxy zu einem Klumpen“, „Tool-Calling-JSON lässt sich nicht zusammensetzen“, „ist dieses 429 ein Ratenlimit oder ein überschrittenes Kontingent“, „ist dieses 502 das Gateway oder der Anbieter“.
Fehlerbehebung bei KI-Aufrufen ist schwierig: Multi-Hop-Pfade, Streaming, inkonsistente Fehlercodes — wenn etwas bricht, wissen Sie nicht, welcher Hop.

## Wie GateLLM es macht
GateLLM vergibt jeder Anfrage eine z-request-id, die sich durch das gesamte Log zieht, sodass Sie nach Symptom lokalisieren: 401 / 403 → Auth und Header ACL; 404 → Routing; 502 / 503 → Upstream-Zustand; Timeout → Ratenlimit und Ozean-übergreifend; abgebrochener Stream → Pufferung und SSE; OOM → Konfiguration.
Fehlercodes werden normalisiert (anbieterübergreifende Fehlersemantik vereinheitlicht), Streaming läuft nativ ohne Pufferung durch, und Token-Ops-Logs sind abfragbar und exportierbar.

## 5 Hebel, die tatsächlich wirken
- z-request-id zieht sich durch das gesamte Log — Lokalisierung per ID in einem Schritt
- Triage nach Symptom: 401 / 403 / 404 / 502 / 503 / Timeout / abgebrochener Stream / OOM
- Normalisierung von Fehlercodes: anbieterübergreifende Fehlersemantik auf ein Vokabular vereinheitlicht
- Nativer Stream-Durchlauf, keine Pufferung, kein Brechen von SSE oder Tool-Aufrufen
- Token-Ops-Logs abfragbar und exportierbar, an Fehlerbehebung und Abstimmung angebunden

## FAQ
### Streaming-Antwort eines KI-Gateways streamt nach dem Proxy nicht mehr?
Ein schlechter Proxy puffert den Stream. GateLLM reicht Streams nativ ohne Pufferung durch und betreibt Capability-Normalisierung, ohne SSE oder Tool-Aufrufe zu brechen.

### Wie unterscheide ich einen Ratenlimit-429 von einem Kontingent-429?
z-request-id-Tracing Ende-zu-Ende plus Fehlercode-Normalisierung unterscheiden Ratenlimit-429 von Kontingent-429 — Triage nach Symptom statt Raten.

- [Vollständige Anleitung: Fehlerbehebung nach Symptom (Dokumentation)](https://docs.gatellm.io/en/usecases/troubleshooting)

## Verwandt
- [Startseite](https://www.gatellm.io/de/index.md)
- [Preise](https://www.gatellm.io/de/pricing.md)
- [Kostenrechner](https://www.gatellm.io/de/calculator.md)
- [Über uns](https://www.gatellm.io/de/about.md)
- [Demo buchen](https://www.gatellm.io/de/demo.md)
- [FAQ](https://www.gatellm.io/de/faq.md)
- [AI-Gateways vergleichen](https://www.gatellm.io/de/compare.md)
- [LiteLLM vergleichen](https://www.gatellm.io/de/compare/litellm.md)
- [OpenRouter vergleichen](https://www.gatellm.io/de/compare/openrouter.md)
- [Alibaba Cloud AI Gateway vergleichen](https://www.gatellm.io/de/compare/alibaba-cloud.md)
- [Azure API Management vergleichen](https://www.gatellm.io/de/compare/azure-apim.md)
- [Apigee vergleichen](https://www.gatellm.io/de/compare/apigee.md)
- [Cloudflare AI Gateway vergleichen](https://www.gatellm.io/de/compare/cloudflare.md)
- [Kong AI Gateway vergleichen](https://www.gatellm.io/de/compare/kong.md)
- [Portkey vergleichen](https://www.gatellm.io/de/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/de/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/de/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/de/compare/litellm-vs-portkey.md)
- [Anwendungsfälle](https://www.gatellm.io/de/use-cases.md)
- [LLM-Kosten senken](https://www.gatellm.io/de/use-cases/reduce-cost.md)
- [Hochverfügbarkeit](https://www.gatellm.io/de/use-cases/high-availability.md)
- [Multi-Tenant-Isolation](https://www.gatellm.io/de/use-cases/multi-tenant.md)
- [Compliance & Audit](https://www.gatellm.io/de/use-cases/compliance-audit.md)
- [Gemischter Multi-Vendor-Modellstack](https://www.gatellm.io/de/use-cases/mixed-model-stack.md)
- [KI im Office selbst hosten](https://www.gatellm.io/de/use-cases/self-hosted-office-ai.md)
- [Token-Nutzung: Transparenz & Zuordnung](https://www.gatellm.io/de/use-cases/token-ops.md)
- [Token-FinOps: KI-Kosten zuordnen & steuern](https://www.gatellm.io/de/use-cases/token-finops.md)
- [MCP-Tool-Governance](https://www.gatellm.io/de/use-cases/mcp-tool-governance.md)
- [Websuche für jedes Modell](https://www.gatellm.io/de/use-cases/web-search-grounding.md)
- [Multi-Key-Rotation & Standby](https://www.gatellm.io/de/use-cases/multi-key-pooling.md)
- [Zugangskontrolle für verbundene Clients](https://www.gatellm.io/de/use-cases/client-admission-control.md)
- [Modellrichtlinie durchsetzen](https://www.gatellm.io/de/use-cases/enforce-model-policy.md)
- [Keine Modellwahl im Client](https://www.gatellm.io/de/use-cases/automatic-model-tiering.md)
- [Ein Protokoll, jedes Modell](https://www.gatellm.io/de/use-cases/one-protocol-any-model.md)
- [Office / Microsoft 365 Add-in](https://www.gatellm.io/de/office-addin.md)
- [Glossar](https://www.gatellm.io/de/glossary.md)
- [Modellkatalog](https://www.gatellm.io/de/models.md)
- [SDK- & Framework-Integrationen](https://www.gatellm.io/de/integrations.md)
- [KI-Coding-Agents & Harnesses](https://www.gatellm.io/de/coding-agents.md)
- [Sicherheit & Compliance](https://www.gatellm.io/de/security.md)