장애 대응(triage) 중에 원시 리버스 프록시 로그를 눈으로 직접 훑어보면 클라이언트 속도 제한(429)이나 조기 연결 종료(499)의 급증을 실제 업스트림 크래시(502 및 504)와 구분하기 어렵습니다. 내장된 로그 추출기는 붙여넣은 텍스트나 드롭한 .log 파일을 브라우저에서 로컬로 스캔하여, 따옴표로 묶인 요청 라인 뒤의 HTTP 응답 상태 토큰이나 JSON 상태 키를 분리하고 정확한 빈도 분석 결과를 계산합니다.
지연 시간 스파이크를 겪고 있는 API 게이트웨이의 Nginx Combined Log Format 샘플을 살펴보겠습니다.
198.51.100.42 - - [01/Nov/2026:14:22:01 +0000] "GET /v2/orders?limit=50 HTTP/2.0" 200 4812 "-" "curl/8.7.1"
198.51.100.42 - - [01/Nov/2026:14:22:02 +0000] "POST /v2/orders HTTP/2.0" 308 0 "-" "curl/8.7.1"
203.0.113.19 - - [01/Nov/2026:14:22:03 +0000] "POST /v2/orders/ HTTP/2.0" 429 118 "-" "python-httpx/0.27.0"
192.0.2.88 - - [01/Nov/2026:14:22:05 +0000] "GET /v2/reports/export HTTP/2.0" 499 0 "-" "Mozilla/5.0"
192.0.2.88 - - [01/Nov/2026:14:22:09 +0000] "GET /v2/reports/export HTTP/2.0" 504 569 "-" "Mozilla/5.0"
203.0.113.55 - - [01/Nov/2026:14:22:10 +0000] "GET /v2/inventory HTTP/2.0" 200 1940 "-" "Go-http-client/2.0"
추출기는 개별 코드와 RFC 9110 응답 클래스를 모두 집계하므로 SLI 에러 버짓(error budget)을 즉시 평가할 수 있습니다.
{
"totalResponses": 6,
"byClass": {
"2xx": { "count": 2, "share": "33.33%" },
"3xx": { "count": 1, "share": "16.67%" },
"4xx": { "count": 2, "share": "33.33%" },
"5xx": { "count": 1, "share": "16.67%" }
},
"byCode": [
{ "code": 200, "phrase": "OK", "count": 2, "standard": "RFC 9110" },
{ "code": 308, "phrase": "Permanent Redirect", "count": 1, "standard": "RFC 9110" },
{ "code": 429, "phrase": "Too Many Requests", "count": 1, "standard": "RFC 6585" },
{ "code": 499, "phrase": "Client Closed Request", "count": 1, "standard": "Nginx Extension" },
{ "code": 504, "phrase": "Gateway Timeout", "count": 1, "standard": "RFC 9110" }
]
}
/v2/reports/export 경로에서 발생한 499와 504를 나란히 비교하면 장애 패턴이 즉시 드러납니다. 응답을 기다리지 못한 클라이언트가 업스트림 워커가 응답하기 전에 연결을 중단하고(499), proxy_read_timeout을 초과하여 열려 있던 연결은 504 Gateway Timeout으로 종료된 것입니다.