본문으로 건너뛰기

마스터 및 노드 에이전트 설치

다음과 같이 마스터 및 노드 에이전트 설치 과정을 안내합니다. 설치 안내 화면과 동일한 과정입니다.

노트

EKS Fargate는 지원 예정입니다.

설치 방식 선택​

액세스 키 확인 후 설치 안내 화면에서 설치 방식 선택 탭을 선택하세요. 와탭 쿠버네티스 에이전트가 지원하는 Yaml 파일과 Helm 차트 설치 방식 중 원하는 설치 방식을 선택 후 사용자의 쿠버네티스 환경에 따라 알맞은 항목을 선택하세요.

설치 방식 선택

  1. 와탭 쿠버네티스 에이전트 이미지 버전을 권장하는 Stable 버전과 Preview 버전 중 선택하세요.

  2. YAML 파일과 Helm 차트 설치 방식 중 중 원하는 설치 방식을 선택하세요.

  3. 1.16 이상 버전 또는 1.16 미만 버전 중 해당하는 쿠버네티스 버전을 선택하세요.

  4. containerd, Docker Engine, CRI-O 중 컨테이너 런타임을 선택하세요.

  5. 사용자 쿠버네티스 환경(GKE, OpenShift, Istio, GPU Cluster) 중 해당하는 항목이 있을 경우 선택하세요.

  6. 설치 방식 관련 항목 선택을 마친 후 화면 오른쪽 아래의 다음 버튼을 클릭하거나 왼쪽 추가 기능 적용 탭을 선택해 다음 단계로 이동하세요.

추가 기능 적용​

와탭 쿠버네티스 모니터링은 현재 컨트롤 플레인 모니터링을 추가 기능으로 제공합니다. 추가 기능 적용을 원할 경우 Control Plane 체크 박스를 선택하세요.

추가 기능 선택

추가 적용한 기능이 많을 수록 수집되는 데이터의 양과 에이전트가 사용하는 리소스의 양이 증가할 수 있습니다. 설치 후 에이전트 설정을 통해 해당 기능을 활성화 또는 비활성화할 수 있습니다.

추가 기능 적용 여부를 선택 후 화면 오른쪽 아래의 다음 버튼을 클릭하거나 왼쪽 설치 파일 다운로드 탭을 선택해 다음 단계로 이동하세요.

노트

컨트롤 플레인 모니터링에 대한 자세한 내용은 다음 문서를 참조하세요.

설치 파일 다운로드​

설치 파일 다운로드 전 사용자 쿠버네티스 환경에 알맞은 항목이 선택되었는지 확인하세요. 선택 항목 확인 후 설치 파일 다운로드 버튼을 클릭해 설치에 필요한 기본 설정 파일(values.yaml)을 다운로드하세요.

설치 파일 다운로드

다운로드 후 화면 오른쪽 아래의 다음 버튼을 클릭하거나 실행 명령어 입력 탭을 선택해 다음 단계로 이동하세요.

실행 명령어 입력​

설치 방식 선택 탭에서 선택한 환경과 설치 방식 안내에 따라 실행 명령어를 입력해 설치를 진행하세요.

실행 명령어 입력

쿠버네티스 환경​

설치 방식 선택 탭에서 GKE 또는 OpenShift 환경을 선택한 경우 다음 안내를 참조하세요. 해당하지 않을 경우 다음의 쿠버네티스 에이전트 생성 단계로 넘어가세요.

설치 방식 선택 탭에서 Google Kubernetes Engine(GKE) 환경을 선택한 경우 사용자 클러스터 생성 후 권한 설정을 위해 다음 명령을 실행하세요.

ACCOUNT=$(gcloud info --format='value(config.account)')
kubectl create clusterrolebinding owner-cluster-admin-binding \
  --clusterrole cluster-admin \
  --user $ACCOUNT
노트

gcloud 명령 설치에 대한 자세한 내용은 구글 클라우드 문서를 참조하세요.

쿠버네티스 에이전트 생성​

와탭 쿠버네티스 에이전트 설치 시 Yaml 파일 기준 설치 방식 안내와 Helm 차트 기준 설치 방식 안내를 다음과 같이 제공합니다.

Yaml 파일 기준 설치​

설치 방식 선택 탭에서 YAML 파일 설치 방식을 선택한 경우 에이전트를 생성하기 위해 다음 명령어를 실행하세요.

kubectl apply -f whatap_kube_agent.yaml
노트

마스터 에이전트가 사용하는 자원량은 사용자 환경의 노드 수에 어느 정도 비례합니다. 즉 클러스터 내에 노드 수가 많을 경우 기본값으로 설정된 메모리 Limit(350MB) 이상의 자원을 사용해 OOM(Out Of Memory)이 발생할 수 있습니다. 마스터 에이전트에 할당된 메모리 Limit 수치는 에이전트 설치 YAML 파일을 통해 변경할 수 있습니다.

에이전트 설치 확인​

쿠버네티스 에이전트 설치가 정상적으로 완료되었을 경우 다음 명령어를 실행해 마스터 에이전트와 노드 에이전트의 상태를 확인할 수 있습니다.

kubectl get pod -n whatap-monitoring

Running 상태인 경우​

다음과 같이 STATUS 항목이 Running인 경우 설치를 완료한 상태입니다. 마스터 및 노드 에이전트의 설치를 완료하면 쿠버네티스 환경의 자원 모니터링을 시작합니다. 와탭 모니터링 서비스로 이동한 다음 프로젝트 목록과 대시보드 > 컨테이너 맵 메뉴에서 성능 정보를 수집하는 것을 확인하세요.

Running 상태가 아닌 경우​

다음과 같이 STATUS 항목이 Running이 아닌 경우 설치가 제대로 이루어지지 않은 상태입니다.

  1. 마스터 노드에서 다음 명령어를 실행해 Pod 생성의 실패 원인을 파악하세요.

    kubectl describe pod {POD_NAME} -n whatap-monitoring

  2. 실행 결과 하단에 Events: 항목을 확인하세요.

팁

kubectl 명령어 사용 시 -n {네임스페이스} 옵션을 사용하면 특정 네임스페이스를 대상으로 작업을 수행합니다. 와탭 에이전트는 기본적으로 whatap-monitoring이라는 네임스페이스에 설치되므로 -n whatap-monitoring이라는 옵션을 추가합니다.

노트

  • 화면 오른쪽 아래에 모니터링 시작 안내 버튼 선택 시 와탭 쿠버네티스 모니터링의 주요 메뉴에 대한 안내를 확인할 수 있습니다. 각 주요 메뉴 안내 하단의 버튼 클릭 시 해당 메뉴로 이동합니다.

  • 애플리케이션 에이전트를 설치를 진행하려면 화면 오른쪽 아래에 추가 모니터링 설치 버튼을 선택하세요. 자세한 내용은 다음 문서를 참조하세요.

  • 에이전트를 최신 버전으로 업데이트하려면 다음 문서를 참조하세요.