Envoy 요청 라우팅은 listener→route→cluster→endpoint 체인을 따르며 istioctl proxy-config로 각 단계를 짚어 오설정을 찾는다

Sun, 07 Jun 2026 00:00:00 +0000

이 문서가 다루는 것

Envoy가 요청 하나를 처리하는 경로는 항상 Listener → Route → Cluster → Endpoint (+ mTLS면 Secret) 라는 고정된 체인이다. 그래서 장애 진단은 자유로운 추리가 아니라 “이 고정 체인의 어느 단계에서 끊겼는가” 하나만 묻는 결정적 절차가 된다. 그 답을 단계별로 dump해 주는 도구가 istioctl proxy-config {listener,route,cluster,endpoint,secret}, 시작점을 바로 가리켜 주는 단서가 access log의 response flag다. 이 note는 그 체인 멘탈모델과 단계별 디버깅 절차에 집중하고, flag 전체 표·xDS 계층 내부·cluster 필드 매핑 같은 깊은 detail은 각 src 문서로 위임한다.

Proxy-Config on homelab89

Envoy 요청 라우팅은 listener→route→cluster→endpoint 체인을 따르며 istioctl proxy-config로 각 단계를 짚어 오설정을 찾는다