# 증상별 문제 해결: z-request-id로 401 / 502 / 끊긴 스트림 추적 > AI 게이트웨이 문제 해결: z-request-id가 401 / 403 / 404 / 502 / 503 / 시간 초과 / 끊긴 스트림 / OOM을 종단 간 추적하고, 오류 코드 정규화, 스트림 버퍼링 없음. 추측이 아니라 증상으로 분류하세요. 표준 링크: https://www.gatellm.io/ko/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 → 업스트림 상태, 시간 초과 → 속도 제한 및 대양 간, 끊긴 스트림 → 버퍼링 및 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/ko/index.md) - [요금](https://www.gatellm.io/ko/pricing.md) - [비용 계산기](https://www.gatellm.io/ko/calculator.md) - [소개](https://www.gatellm.io/ko/about.md) - [데모 예약](https://www.gatellm.io/ko/demo.md) - [FAQ](https://www.gatellm.io/ko/faq.md) - [AI 게이트웨이 비교](https://www.gatellm.io/ko/compare.md) - [LiteLLM 비교](https://www.gatellm.io/ko/compare/litellm.md) - [OpenRouter 비교](https://www.gatellm.io/ko/compare/openrouter.md) - [Alibaba Cloud AI Gateway 비교](https://www.gatellm.io/ko/compare/alibaba-cloud.md) - [Azure API Management 비교](https://www.gatellm.io/ko/compare/azure-apim.md) - [Apigee 비교](https://www.gatellm.io/ko/compare/apigee.md) - [Cloudflare AI Gateway 비교](https://www.gatellm.io/ko/compare/cloudflare.md) - [Kong AI Gateway 비교](https://www.gatellm.io/ko/compare/kong.md) - [Portkey 비교](https://www.gatellm.io/ko/compare/portkey.md) - [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/ko/compare/litellm-vs-kong.md) - [LiteLLM vs OpenRouter](https://www.gatellm.io/ko/compare/litellm-vs-openrouter.md) - [LiteLLM vs Portkey](https://www.gatellm.io/ko/compare/litellm-vs-portkey.md) - [사용 사례](https://www.gatellm.io/ko/use-cases.md) - [LLM 비용 절감](https://www.gatellm.io/ko/use-cases/reduce-cost.md) - [고가용성](https://www.gatellm.io/ko/use-cases/high-availability.md) - [멀티테넌트 격리](https://www.gatellm.io/ko/use-cases/multi-tenant.md) - [컴플라이언스 및 감사](https://www.gatellm.io/ko/use-cases/compliance-audit.md) - [다중 벤더 혼합 모델 스택](https://www.gatellm.io/ko/use-cases/mixed-model-stack.md) - [Office 내 AI 셀프 호스팅](https://www.gatellm.io/ko/use-cases/self-hosted-office-ai.md) - [Token 사용량 가시성 및 귀속](https://www.gatellm.io/ko/use-cases/token-ops.md) - [Token FinOps: AI 비용 배분 및 통제](https://www.gatellm.io/ko/use-cases/token-finops.md) - [MCP 도구 거버넌스](https://www.gatellm.io/ko/use-cases/mcp-tool-governance.md) - [모든 모델에 웹 검색 추가](https://www.gatellm.io/ko/use-cases/web-search-grounding.md) - [다중 키 로테이션 및 대기](https://www.gatellm.io/ko/use-cases/multi-key-pooling.md) - [연결 클라이언트 접근 제어](https://www.gatellm.io/ko/use-cases/client-admission-control.md) - [모델 사용 정책 강제](https://www.gatellm.io/ko/use-cases/enforce-model-policy.md) - [클라이언트에 모델 선택 비노출](https://www.gatellm.io/ko/use-cases/automatic-model-tiering.md) - [하나의 프로토콜, 어떤 모델이든](https://www.gatellm.io/ko/use-cases/one-protocol-any-model.md) - [Office / Microsoft 365 추가 기능](https://www.gatellm.io/ko/office-addin.md) - [용어집](https://www.gatellm.io/ko/glossary.md) - [모델 카탈로그](https://www.gatellm.io/ko/models.md) - [SDK 및 프레임워크 통합](https://www.gatellm.io/ko/integrations.md) - [AI 코딩 에이전트 및 하네스](https://www.gatellm.io/ko/coding-agents.md) - [보안 및 컴플라이언스](https://www.gatellm.io/ko/security.md)