쿠버네티스 에이전트 옵션 설정

• 와탭 쿠버네티스 에이전트 배포 시 컨테이너 env 필드를 통해 설정할 수 있습니다.

• 컨테이너 내부 whatap.conf 파일을 수정해 설정할 수 있습니다.

• whatap.conf 파일 내 옵션이 컨테이너 env 필드에 설정된 옵션보다 높은 우선순위를 가집니다.

• whatap.conf 또는 컨테이너 env에 설정된 값이 없는 경우 기본값이 사용됩니다.

노트

컨테이너 내 애플리케이션 에이전트 옵션 설정

컨테이너 내 Java, Python, Node.js 등 애플리케이션의 모니터링을 위해 필요 설정을 whatap.conf 파일에 작성합니다. whatap.conf 파일을 통해 설정할 수 있는 옵션에 대한 자세한 내용은 다음 링크를 참조하세요.

• Java - whatap.conf 설정하기

• Node.js - whatap.conf 설정하기

• Python - whatap.conf 설정하기

컨테이너별 옵션 설정

whatap-node-helper

---

• collect_volume_detail_enabled bool

  기본값 true

  노드 에이전트에서 모든 컨테이너에 대한 exec df 명령어를 이용해 컨테이너 볼륨 정보 조회를 활성화합니다. 노드에 실행 중인 모든 컨테이너의 스토리지 사용량 및 볼륨 정보를 수집하는 기능을 활성화합니다.

• inject_container_id_to_apm_agent_enabled bool

  기본값 true

  와탭 APM 컨테이너에 exec를 이용한 container ID 주입을 활성화합니다. 와탭 APM으로 식별되는 컨테이너의 ID를 자동으로 추출합니다. 이를 APM 도구에 주입해 성능 모니터링 데이터와 컨테이너를 연결할 수 있습니다.

• debug bool

  기본값 false

  디버그 모드의 활성화 여부를 설정합니다. 디버그 모드 활성화 시 로그 레벨을 DEBUG로, 그렇지 않을 경우 INFO로 설정합니다.

• kube_config_path string

  기본값 ~/.kube/config

  Kubernetes 설정 파일 경로를 지정합니다. 미설정 시~/.kube/config 를 사용합니다.

• log_sys_out bool

  기본값 true

  로그 시스템 출력을 설정합니다. 옵션 값을 true로 설정 시 표준 출력(stdOut)과 파일에 동시에 로깅을 남깁니다. 변경 시 로깅 시스템에 즉시 반영됩니다.

whatap-node-agent

---

• shutdown bool

  기본값 false

  수집 서버와 연결을 강제로 중단합니다. 통신 중지를 의미합니다.

• license string

  프로젝트에 발급된 라이센스를 사용해 에이전트를 식별합니다.

• whatap.server.host string

  기본값 13.124.11.223 혹은 13.209.172.35

  수집 서버의 IP를 설정합니다. delimiter의 경우 /:을 사용합니다.

• whatap.server.port number

  기본값 6600

  수집 서버의 데이터 수신 Port를 설정합니다.

• ONODE_NAME string

  기본값 NODE_NAME or NODE_IP 환경 변수값

  에이전트 노드 식별을 위한 이름을 설정합니다.

• tcp_connection_timeout number

  기본값 3000

  whatap-master-agent와 수집 서버 소켓 연결 시 타임아웃 시간을 설정합니다.

• tcp_so_timeout number

  기본값 60000

  소켓 연결 후 데이터 송수신 타임아웃 시간을 설정합니다.

• debug bool

  기본값 false

  디버그 모드의 활성화 여부를 설정합니다.

• gpuEnabled bool

  기본값 false

  GPU 모니터링의 활성화 여부를 설정합니다.

• count_interval number

  기본값 5000

  메트릭스(kube_pod, container)를 수집 서버에 전송하는 주기를 설정합니다. 기본값의 단위는 ms입니다.

  노트

  해당 옵션은 화면상 데이터 갱신 주기에 영향을 줄 수 있습니다. 자세한 내용은 다음 메트릭스별 영향을 받는 화면 구성요소를 참고하세요.

• collect_interval number

  기본값 5000

  에이전트가 apiserver에 요청해 메트릭스(kube_pod, container)를 수집하는 주기를 설정합니다.

  노트

  해당 옵션은 화면상 데이터 갱신 주기에 영향을 줄 수 있습니다. 자세한 내용은 다음 메트릭스별 영향을 받는 화면 구성요소를 참고하세요.

• collect_apiserver_metric_by_leader bool

  기본값 false

  해당 옵션이 활성화 된 경우 노드 에이전트는 메트릭 수집을 마스터 에이전트에 위임합니다. whatap-master-agent의 collect_apiserver_metric_by_leader 옵션 활성화 선행이 필요합니다. 메트릭 수집 위임을 통해 기존 whatap-node-agent가 발생시킨 apiserver 부하를 낮출 수 있습니다.

whatap-control-plane-helper

---

• port string

  기본값 9496

  whatap-control-plane-helper의 웹 서버 포트를 설정합니다.

• cycle number

  기본값 5

  control-plane-helper가 지표를 스크래핑하는 주기를 설정합니다. 기본값의 단위는 s입니다.

• collect_control_plane_monitoring_enabled bool

  기본값 false

  control-plane-monitoring 기능의 활성화 여부를 설정합니다.

• kube_config_path string

  기본값 ~.kube/config

  Kubernetes 설정 파일 경로를 지정합니다. 미설정 시 ~/.kube/config 를 사용합니다.

• kube_master_url string

  기본값 ~/.kube/config

  스크래핑을 위해 요청할 control-plane 의 url을 설정합니다. 미설정 시 ~/.kube/config 를 사용합니다.

• debug bool

  기본값 false

  whatap-control-plane-helper의 디버깅(로깅)의 활성화 여부를 설정합니다.

whatap-master-agent

---

• shutdown bool

  기본값 false

  수집 서버와 연결을 강제로 중단합니다. 통신 중지를 의미합니다.

• license string

  프로젝트에 발급된 라이센스를 사용해 에이전트를 식별합니다.

• whatap.server.host string

  기본값 13.124.11.223 혹은 13.209.172.35

  수집 서버의 IP를 설정합니다. delimiter의 경우 /:을 사용합니다.

• whatap.server.port number

  기본값 6600

  수집 서버의 데이터 수신 Port를 설정합니다.

• tcp_connection_timeout number

  기본값 3000

  whatap-master-agent와 수집 서버 소켓 연결 시 타임아웃 시간을 설정합니다.

• tcp_so_timeout number

  기본값 60000

  whatap-master-agent와 수집 서버 소켓 통신 시 타임아웃 시간을 설정합니다.

• debug bool

  기본값 false

  whatap-master-agent에서 DEBUG 레벨 로깅 활성화 여부를 설정합니다.

• collect_apiserver_metric_by_leader bool

  기본값 false

  whatap-master-agent가 스크래퍼의 리더로 동작 활성화 여부를 설정합니다. 활성화 시 whatap-master-agent 단독으로 apiserver에 메트릭을 요청합니다.

• collect_control_plane_monitoring_enabled bool

  기본값 false

  컨트롤 플레인 모니터링 기능의 활성화 여부를 설정합니다.

• master_to_control_plane_connection_timeout number

  기본값 5000

  whatap-master-agent가 whatap-control-plane-helper와 통신 시 connection timeout이 발생할 때까지의 시간을 설정합니다. 기본값의 단위는 ms입니다.

• master_to_control_plane_read_timeout number

  기본값 20000

  whatap-master-agent가 whatap-control-plane-helper와 통신 시 read timeout이 발생할 때까지의 시간을 설정합니다. 기본값의 단위는 ms입니다.

• control_plane_debug bool

  기본값 false

  컨트롤 플레인 모니터링에 대한 whatap-master-agent에서의 모든 디버그 로그 기능의 활성화 여부를 설정합니다.

• store_k8s_object_manifest_enabled bool

  기본값 true

  오브젝트 매니페스트 수집 기능의 활성화 여부를 설정합니다. 활성화 시 하루에 한번 클러스터 오브젝트들의 매니페스트 정보를 수집합니다.

• store_k8s_object_manifest_timezone string

  기본값 UTC

  오브젝트 매니페스트 수집을 위한 타임존을 설정합니다. 별도 설정이 없을 경우 기본값 UTC 기준 자정에 수집을 시작합니다.

  예, 한국 시간 기준으로 자정에 실행하고 싶을 경우 GMT+9 혹은 Asia/Seoul과 같이 타임존 설정

• store_k8s_object_manifest_max_fetch_limit number

  기본값 50

  한 번에 수집할 오브젝트의 조회 개수를 설정합니다. 별도 설정이 없을 경우 기본값 50 기준으로 1회 요청당 50개씩 요청합니다.

  예, 전체 Pod 개수가 90개인 클러스터에서 해당 옵션 30 설정 시 Pod 정보를 30개씩 3회 요청

메트릭스별 영향을 받는 화면 구성요소

kube_pod

• 대시보드 > 컨테이너 맵

  다음 예시 이미지의 Pod 뷰 기준 데이터는 kube_pod 메트릭스 수집 주기 및 수집 서버 전송 주기에 영향을 받습니다.

  

• 워크로드 > Pod 목록

  다음 예시의 데이터는 kube_pod 메트릭스 수집 주기 및 수집 서버 전송 주기에 영향을 받습니다.

  

• 대시보드 > 퍼포먼스 요약

  kube_pod 메트릭스를 이용하는 에이전트 설치 노드에서 실행 중인 Pod 수 차트 갱신 주기에 영향을 받습니다.

container

• 대시보드 > 컨테이너 맵

  다음 예시의 컨테이너 뷰 기준 화면 데이터 갱신 주기는 container 메트릭스의 영향을 받습니다.

  

• 컨테이너 > 컨테이너 이미지

  다음 예시의 데이터는 container 메트릭스의 영향을 받습니다.

  

• 대시보드 > 퍼포먼스 요약

  container 메트릭스를 이용하는 다음 차트의 갱신 주기에 영향을 받습니다.

  • 에이전트 설치 노드에서 실행 중인 컨테이너 수

  • 에이전트 설치 노드 수

  • Total Container CPU Request

  • Total Container CPU Usage

  • Node CPU

  • Node Memory

  • Container CPU Usage by Request

  • Container CPU Usage by Node

  • Container Memory Working Set by Request

  • Container Memory Failure Count

  • Container CPU Throttling Time

  • Container Network Receive Byte

  • Container Network Transmit Byte

• 클러스터 > 노드 상세

  다음 예시의 노드 상세 화면에서 컨테이너 목록의 갱신 주기는 container 메트릭스의 영향을 받습니다.