Kubernetes Agent v1.9.32

Java Agent v2.2.68 포함

2026년 10월 26일

주의

node helper를 포함한 node agent와 master agent 이미지를 함께 public.ecr.aws/whatap/kube_mon:1.9.32로 업데이트하세요. node agent만 업데이트하고 node helper를 구버전으로 남기면 안 됩니다. 별도 Operator 업그레이드나 RBAC 변경은 필요하지 않습니다.

• Feature 노드별 대상 프로세스 개수 수집

  • 노드별 대상 프로세스 개수를 kube_process_count의 count 필드로 수집
  • 대상 프로세스가 종료되어도 count=0을 계속 전송하므로 메트릭스 이벤트로 프로세스 중단 감지 가능
  • 수집 대상은 node helper의 collect_kube_node_process_metric_target_list로 지정하며, /proc/PID/status의 Name과 정확히 일치해야 함. Linux가 제공하는 최대 15바이트 이름 사용(예: kube-controller)
  • collect_kube_node_process_metric_enabled와 기존 수집·전송 주기 설정을 따르며, 기본 주기는 5초
  • 수집 실패와 오래된 데이터는 0으로 대신 전송하지 않음
  • 기존 kube_process 데이터 형식은 변경하지 않음
  노트

  1.9.32 node agent와 구버전 node helper를 함께 사용하면 프로세스 개수 메트릭스를 수집하지 않습니다.

• Changed APM 컨테이너에 컨테이너 ID 기록 실패 시 node helper가 재시도

  • 기존에는 컨테이너가 Running 상태가 된 직후 한 번만 컨테이너 ID(container.conf) 기록을 실행
  • 애플리케이션 기동이 늦어 에이전트 파일(예: Python의 /whatap-agent/whatap_python)이 아직 없거나 일시적인 실행 오류가 나면, 같은 Deployment에서도 해당 파드만 컨테이너 연계 정보가 빠지던 문제 개선
  • 실패하면 10초부터 간격을 두 배씩 늘려(최대 5분) 최대 6회까지 재시도
  • 각 실행은 30초 안에 끝나지 않으면 중단

업데이트 안내

• 업데이트로 node agent 파드가 다시 시작되면 node helper가 실행 중인 APM 파드를 다시 처리하므로, 이전 버전에서 연계가 빠진 파드에도 container.conf가 생성됩니다. 그래도 연계가 표시되지 않으면 해당 애플리케이션 파드를 재시작하세요.
• 실행이 계속 실패하는 컨테이너는 최대 6번 시도하므로 node helper 로그의 Failed to execute Whatap agent command 줄이 이전보다 늘어날 수 있습니다. 줄 끝의 (attempt n/6, retry in …) 또는 (attempt 6/6, giving up)으로 재시도 상태를 확인할 수 있습니다.

프로세스 중단 알림 설정

메트릭스 이벤트에 kube_process_count, cmd1과 감시할 노드 필터를 지정하고, count < 1을 위험 조건으로 설정하세요.

• 태그: onode, onodeName, cmd1, agentPcode, agentOid
• 필드: count

주의

원래 실행하지 않는 대상도 0으로 수집됩니다. 예를 들어 containerd 노드에 dockerd 알림을 일괄 적용하지 마세요.

실제 프로젝트에서 수신되는 값과 알림 발생·해소 여부는 적용 환경에서 확인하세요.

정보

Agent download: kube_mon_1.9.32.tar