본문으로 건너뛰기

에이전트 설치

와탭 쿠버네티스 모니터링 에이전트의 구조와 두 가지 설치 방식을 소개합니다. 사전 준비와 아키텍처를 먼저 확인한 후, 운영 환경에 맞는 방식으로 설치를 진행하세요.

사전 준비

에이전트를 설치하기 전에 시작하기 문서에서 다음 단계를 먼저 완료하세요.

  • 와탭 회원 가입
  • 클러스터 프로젝트 생성
  • 액세스 키 발급

쿠버네티스 에이전트 아키텍처​

와탭 쿠버네티스 에이전트는 마스터 에이전트 파드와 노드 에이전트 파드로 구성됩니다.

쿠버네티스 에이전트 아키텍처

노드 에이전트 파드​

whatap-node-agent 파드는 DaemonSet 형태로 배포되며, 노드당 1개씩 실행됩니다. 파드 내부에는 다음 두 컨테이너가 있습니다.

  • whatap-node-agent

    kube-apiserver와 통신하여 노드 워크로드의 메트릭을 수집합니다. kube_pod, container, kube_pod_volume 등의 메트릭에 영향을 줍니다.

  • whatap-node-helper

    Runtime-socket과 루트 볼륨을 마운트하여 노드와 컨테이너의 자원 사용량을 수집합니다.

마스터 에이전트 파드​

whatap-master-agent 파드는 Deployment 형태로 배포되며, 클러스터당 1개가 실행됩니다. 파드에는 다음 컨테이너가 포함됩니다.

  • whatap-master-agent (필수)

    클러스터 전반의 메트릭을 수집합니다. 네임스페이스 프로젝트 정보처럼 모든 노드 에이전트가 공유해야 하는 데이터를 각 노드 에이전트로 전달하고 동기화합니다.

  • whatap-control-plane (선택)

    쿠버네티스 컨트롤 플레인 노드의 지표를 수집합니다. 현재는 apiserver의 상태와 요청 횟수를 수집합니다. 컨트롤 플레인 모니터링을 사용하려면 추가 기능 적용이 필요합니다. 자세한 내용은 컨트롤 플레인 대시보드 문서를 참조하세요.

노트

향후 여러 개의 마스터 에이전트 파드가 동시에 동작할 수 있도록 다중화 기능을 제공할 예정입니다.

설치 방식 선택하기​

와탭 쿠버네티스 모니터링은 다음 두 가지 방식으로 에이전트를 설치할 수 있습니다. 운영 환경과 관리 방식에 맞는 방법을 선택하세요.

와탭 오퍼레이터로 설치하기​

와탭 오퍼레이터는 단일 커스텀 리소스(CR)로 마스터·노드 에이전트, 애플리케이션 자동 계측, OpenAgent를 통합 관리하는 쿠버네티스 오퍼레이터입니다. CR 상태를 지속적으로 감시하여 변경 사항을 자동으로 조정합니다.

다음 페이지에서 설치와 구성 방법을 확인하세요.

마스터·노드 에이전트 직접 설치하기​

콘솔의 설치 안내 페이지를 따라 YAML 또는 Helm 차트로 마스터·노드 에이전트를 직접 배포하는 방식입니다. 컨테이너 런타임, 쿠버네티스 버전, GKE/OpenShift 등 환경별 옵션을 단계별로 선택할 수 있습니다.

애플리케이션 에이전트 추가 설치​

앞서 소개한 두 방식 중 어떤 것을 선택하더라도, 컨테이너 안에서 실행되는 Java/Node.js/Python/PHP/Go 애플리케이션을 모니터링하려면 애플리케이션 에이전트를 추가로 설치해야 합니다.

설치 영상 보기​

최종 수정: