Kubernetes 1.35가 z-pages 디버깅 엔드포인트에 versioned JSON 응답을 추가해 기계가 파싱 가능한 구조화된 진단 데이터 제공

Context

Kubernetes 제어 평면 컴포넌트의 런타임 상태를 디버깅할 때 z-pages 엔드포인트는 일반 텍스트 응답만 반환했다. 일반 텍스트 형식은 인간 운영자에겐 유용하지만 자동화된 모니터링 도구나 프로그래매틱 파싱이 매우 어려웠다.

Technical Solution

• /statusz와 /flagz 엔드포인트에 Accept 헤더 기반의 versioned JSON 응답 추가: 기존 plain text 호환성을 유지하면서 Accept: application/json;v=v1alpha1;g=config.k8s.io;as=Statusz 헤더로 구조화된 응답 수신
• Statusz 응답에 startTime, uptimeSeconds, goVersion, binaryVersion, emulationVersion, paths 필드를 구조화된 JSON 객체로 제공
• Flagz 응답에 command-line 인자 전체를 구조화된 flags 필드의 key-value 객체로 제공
• ComponentStatusz와 ComponentFlagz 피처 게이트를 별도로 활성화하여 점진적 도입 지원
• v1alpha1부터 시작하는 API 버전 관리 체계 도입: 향후 v1beta1과 v1 단계별 진화 계획

Key Takeaway

Kubernetes 제어 평면 디버깅 엔드포인트에 버전 관리된 구조화된 응답을 추가함으로써 자동화된 헬스 체크, 설정 검증, 모니터링 도구 개발이 가능해졌으며, 이는 backward compatibility를 유지하면서 진화 가능한 API 설계 원칙을 보여준다.