본문으로 건너뛰기

에이전트 문제 해결

Helm 차트 기준 설치 문제 해결​

이름이 whatap 다른 Helm 리포지토리가 있을 경우​

"whatap" already exists with the same configuration, skipping

이미 동일한 이름의 다른 whatap 리포지토리가 존재할 경우 다음 명령어를 통해 기존 whatap 리포지토리 삭제 후 설치를 진행하세요.

helm repo remove whatap

이름이 whatap-monitoring인 다른 네임스페이스가 클러스터에 있을 경우​

Error: INSTALLATION FAILED: Unable to continue with install: Namespace "whatap-monitoring" in namespace "" exists and cannot be imported into the current release

클러스터에 whatap-monitoring 네임스페이스가 존재한다면 사용자가 yaml 파일 기준으로 이미 와탭 쿠버네티스 에이전트를 설치했기 때문입니다. 이 경우 다음 명령어를 통해 기존 whatap-monitoring 네임스페이스 및 관련 리소스를 삭제하세요.

kubectl delete namespace whatap-monitoring
kubectl delete clusterrolebinding whatap
kubectl delete clusterrole whatap

clusterrole, clusterrolebinding 리소스가 이미 클러스터에 있을 경우​

Error: INSTALLATION FAILED: Unable to continue with install: ClusterRole "whatap" in namespace "" exists and cannot be imported into the current release

클러스터에 clusterrole, clusterrolebinding 리소스가 이미 존재할 경우 다음 명령어를 통해 해당 리소스를 삭제하세요.

kubectl delete clusterrolebinding whatap
kubectl delete clusterrole whatap

에이전트 기동 시 발생하는 문제 해결​

구형 YAML 파일을 통해 와탭 쿠버네티스 모니터링 설치한 경우​

Unrecognized VM option 'UseCGroupMemoryLimitForHeap'
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

2022년 8월 24일 이전에 다운로드한 설치 YAML을 통해 와탭 쿠버네티스 모니터링을 설치한 경우 노드 에이전트(whatap-node-agent) 기동 시 오류 발생 및 기동에 실패하는 경우가 있습니다.

원인​

  • 2022년 8월 24일 이전에 다운로드한 설치 YAML 파일 내 UseCGroupMemoryLimitForHeap JVM 옵션을 사용한 노드 에이전트 실행 스크립트가 포함되어 있습니다.

  • 와탭 노드 에이전트 1.2.0(2022년 11월 21일 배포)이상 버전부터 에이전트 내부에서 사용하는 JDK가 업그레이드 되었으며 업그레이드된 JDK 버전은 더 이상 UseCGroupMemoryLimitForHeap 옵션을 제공하지 않습니다.

  • 2022년 8월 24일 이전에 다운로드한 YAML 파일로 와탭 쿠버네티스 모니터링을 설치한 상태로 노드 에이전트 1.2.0 이상 버전을 기동하는 경우 Unrecognized VM option 'UseCGroupMemoryLimitForHeap’ 메세지가 발생하며 기동에 실패하게 됩니다.

해결​

다음 단계를 통해 와탭 쿠버네티스 모니터링을 재설치하세요.

  1. 관리 > 에이전트 설치 화면에서 최신 YAML 파일을 다운로드하세요.

  2. 사용자 쿠버네티스 환경에서 다운로드한 YAML 파일을 사용하여 에이전트를 설치하세요.

  3. 사용자 쿠버네티스 환경에서 설치 과정 중 오류 출력 여부를 확인하세요.

  4. 와탭 모니터링 에이전트 Pod가 Running 상태인지 확인하세요.

    노트

    사용자 쿠버네티스 환경 및 워크로드 > Pod 목록 메뉴에서 확인하세요.

  5. 관리 > 쿠버네티스 에이전트 목록 메뉴에서 각 모니터링 에이전트에서 발생하는 로그를 확인하세요.