본문으로 건너뛰기

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

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

노트

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

와탭 쿠버네티스 에이전트 이미지 리포지토리 추가 지원​

와탭 쿠버네티스 에이전트는 기존 DockerHub 외에 Public ECR을 추가로 지원합니다. 사용 환경에 따라 두 이미지 리포지토리 중 하나를 선택하여 설치할 수 있습니다.

Public ECR​

  • 리포지토리: public.ecr.aws/whatap/kube_mon 추천

ECR은 pull 제한 정책에 영향을 받지 않으므로, 빈번한 업데이트나 대규모 배포 환경에서 안정적으로 사용할 수 있어 권장합니다.

DockerHub​

  • 리포지토리: whatap/kube_mon

DockerHub는 인증되지 않은 클라이언트에 대해 pull 제한(policy)이 적용될 수 있습니다. 노드 수가 많거나 동시에 pull 요청이 발생하는 경우 rate limit에 걸려 설치가 실패할 가능성이 높습니다. 자세한 내용은 DockerHub 정책 안내 공식 문서를 참고해 주세요.

주의

pull 제한이 발생한 경우 다음 문서를 참고하세요.

추가 기능 적용​

와탭 쿠버네티스 모니터링은 다양한 추가 기능을 제공합니다.

추가 기능 선택

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

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

컨트롤 플레인 모니터링 활성화​

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

Custom Resource 모니터링 활성화​

와탭 쿠버네티스 에이전트 설치 YAML 파일에서 ClusterRole 리소스의 rules 하위의 resources 항목에 사용하려는 customResource를 추가하세요.

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  creationTimestamp: "2025-01-15T01:48:26Z"
  name: whatap
  resourceVersion: "125200773"
  uid: 54b0bcdb-1f12-4779-b0cb-e8de2f6be64a
rules:
- apiGroups:
  - '*'
  resources:
  - namespaces
  - pods
  - pods/log
  - configmaps
  - services
  - endpoints
  - daemonsets
  - ingresses
  - deployments
  - nodes
  - persistentvolumes
  - persistentvolumeclaims
  - events
  - replicasets
  - roles
  - rolebindings
  - clusterroles
  - clusterrolebindings
  - jobs
  - cronjobs
  - statefulsets
  - serviceaccounts
  - configmaps
  - storageclasses
  - horizontalpodautoscalers
  - replicationcontrollers
  - customresourcedefinitions # CRD 수집 권한 추가
  - samplecrds # 모니터링할 Custom Resource의 이름 추가
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - ""
  resources:
  - pods/exec
  verbs:
  - create
- apiGroups:
  - ""
  resources:
  - configmaps
  verbs:
  - '*'
- nonResourceURLs:
  - /metrics
  verbs:
  - '*'
노트

오브젝트 매니페스트 메뉴에서 Custom Resource 모니터링을 할 수 있습니다.

설치 파일 다운로드​

설치 파일 다운로드 전 사용자 쿠버네티스 환경에 알맞은 항목이 선택되었는지 확인하세요. 선택 항목 확인 후 설치 파일 다운로드 버튼을 클릭해 설치에 필요한 기본 설정 파일(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이라는 옵션을 추가합니다.

노트

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

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

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