본문으로 건너뛰기

Kubernetes Agent v1.9.31

Java Agent v2.2.68 포함

2026년 10월 6일

주의

node helper를 포함한 node agent와 master agent 이미지를 함께 1.9.31로 업데이트하세요. node agent만 업데이트하고 node helper를 구버전으로 남기면 안 됩니다. 이 개선을 위한 별도 Operator 업그레이드나 RBAC 변경은 필요하지 않습니다.

  • Changed ConfigMap으로 지정한 WHATAP_JAVA_AGENT_PATH도 Java APM과 컨테이너 ID 연계

    • 애플리케이션 컨테이너의 WHATAP_JAVA_AGENT_PATH를 env[].valueFrom.configMapKeyRef로 지정한 경우에도 node helper가 Java APM과 컨테이너 ID를 연계
    • 컨테이너가 시작할 때 해석된 환경변수를 사용하므로, 실행 이후 변경된 ConfigMap 값과 혼동하지 않음
    • value 직접 지정과 경로 자동 탐지 등 기존 대체 경로는 그대로 유지
    • ConfigMap과 Secret 조회 권한은 추가하지 않음
    노트

    지원 범위는 개별 env[].valueFrom.configMapKeyRef입니다. envFrom.configMapRef 일괄 가져오기와 그 밖의 valueFrom 형식은 포함하지 않으며, Java APM 자동 설치 기능과는 별개입니다.

적용 안내​

ConfigMap 값에는 애플리케이션 컨테이너 안의 실제 Java 에이전트 JAR 절대경로를 지정합니다.

env:
  - name: WHATAP_JAVA_AGENT_PATH
    valueFrom:
      configMapKeyRef:
        name: whatap-configmap
        key: WHATAP_JAVA_AGENT_PATH
  • 기존 POD_NAME 등 연동 설정과 JAR·Java 실행 권한, 디렉터리 쓰기 권한 조건은 그대로 유지해야 합니다.
  • 이미 올바른 ConfigMap 참조값으로 실행 중인 애플리케이션은 환경변수를 value 직접 지정으로 바꿀 필요가 없습니다.
  • ConfigMap 값을 변경했다면 해당 애플리케이션 파드를 재생성해야 환경변수에 반영됩니다.
  • 적용한 뒤 실제 APM 컨테이너 ID 매핑과 컨테이너 CPU 지표를 확인하세요.

설치형 주의 사항​

이 기능 자체에는 Yard 업데이트가 필요하지 않습니다. 다만 1.9.30부터 적용된 Yard 버전 조회 동작은 그대로 유지됩니다.

구버전 Yard가 버전 조회를 지원하지 않아 발생하는 [Y106]은 기존 수집을 중단하지 않지만, 다른 원인의 [Y106]과 구분해야 합니다. 버전 조회를 지원하는 Yard 3.1.9 이상으로 업데이트한 뒤 에이전트가 새 연결을 맺으면 해당 원인의 로그는 해소됩니다.

정보

Agent download: kube_mon_1.9.31.tar

최종 수정: