Kubernetes Agent v1.9.30

Java Agent v2.2.68 포함

2026년 10월 2일

주의

master agent와 node agent를 모두 1.9.30으로 업데이트해야 합니다. 추가 설정과 RBAC 변경은 없습니다.

Changed 파드의 컨테이너 집계를 실제 수집 대상과 같은 집합으로 맞춤
- 컨테이너 식별자, 이름, 개수, 상태를 실제 컨테이너 수집 대상과 동일한 집합으로 집계
- 일반 컨테이너와 Native Sidecar, 컨테이너가 없는 파드를 포함
Changed 수집 서버에 연결할 때 Yard 버전 확인 추가
- Yard 3.1.9 이상이 확인된 프로젝트에서만 새로운 파드 컨테이너 집계 형식 사용
- 구버전 Yard이거나 버전 조회를 지원하지 않거나 조회에 실패·시간 초과하면 기존 전송 형식 유지
- 재접속 시 대기 중인 데이터도 현재 연결의 서버 버전에 맞는 형식으로 전송
- 버전 조회는 node agent와 master agent 각각의 연결당 한 번 수행하며, 주기적으로 재시도하지 않음
Fixed 비정상 버전 응답 처리와 통신 장애 시 연결 복구의 안정성 개선

설치형 업그레이드 주의 사항: 구버전 Yard의 [Y106] 로그

Yard 3.1.8 계열 이하에서 Kubernetes Agent 1.9.30을 사용하면, 수집 서버 버전 조회 요청을 지원하지 않아 Yard 로그에 [Y106] 오류와 스택 트레이스가 남을 수 있습니다.

버전 조회 미지원으로 생긴 로그는 기존 데이터 수집에 영향을 주지 않으며, 에이전트는 기존 전송 형식을 유지합니다. 버전 조회 기능이 포함된 Yard 3.1.9 이상으로 업데이트하면 이 원인의 로그는 해소됩니다.

버전 조회는 연결당 한 번만 수행하므로, 새 연결이 생기면 로그가 다시 발생할 수 있습니다.

Proxy를 경유하는 환경에서 에이전트와 Proxy의 연결이 유지되면, Yard만 재시작해도 에이전트는 버전을 다시 조회하지 않습니다.

주의

[Y106]은 다른 예외에도 사용합니다. 모든 [Y106] 로그를 무시하지 말고, 함께 기록된 예외 내용이 버전 조회 미지원에 해당하는지 확인하세요.

master agent와 node agent를 모두 1.9.30으로 업데이트합니다. 추가 설정과 RBAC 변경은 없습니다.
새 파드 컨테이너 집계를 사용하려면 버전 조회 기능과 파드 집계 보존 처리가 포함된 Yard 3.1.9 이상이 먼저 준비되어야 합니다. Yard를 업데이트한 뒤 에이전트를 재접속하거나 재시작해 버전을 다시 확인하세요.
같은 Proxy 연결 뒤에서 Yard만 교체하면 에이전트는 버전 변경을 감지하지 못합니다. Yard 버전이 혼재하는 업그레이드는 별도 조율이 필요합니다.
버전이 별도로 확인되지 않은 namespace 또는 child 프로젝트에는 기존 전송 형식을 유지합니다.

노트

이 릴리스는 특정 고객 환경의 서버 업데이트와 실제 수집·화면 검증 완료를 뜻하지 않습니다.

정보