본문으로 건너뛰기

오브젝트 매니페스트

홈 화면 > 프로젝트 선택 > 클러스터 > 오브젝트 매니페스트

노트

요구 사항

와탭 마스터 에이전트 1.5.5 버전 이상이 필요합니다. 1.5.5 버전 미만일 경우 기존 마스터 메타 정보 화면이 제공됩니다.

쿠버네티스 마스터 에이전트는 클러스터에 있는 Pod, 서비스, ReplicaSet 등의 오브젝트에 대한 매니페스트를 하루에 한 번씩 자동으로 수집합니다. 해당 데이터는 날짜별로 저장되어 사용자가 특정 날짜 기준의 클러스터 상태를 쉽게 확인할 수 있습니다. 수집한 데이터는 날짜별 비교가 가능해 시간에 따른 클러스터의 변화를 파악하기 용이합니다.

또한 사용자는 쿠버네티스 마스터 에이전트의 Deployment 배포 전 컨테이너 환경변수를 설정해 수집 시간의 타임존을 자유롭게 지정할 수 있습니다. 해당 설정 방법은 다음 컨테이너 환경변수 안내를 참조하세요.

컨테이너 환경변수

  • store_k8s_object_manifest_enabled

    기본값 true

    오브젝트 매니페스트 수집 기능을 활성화합니다. 기본값이 true이기 때문에 별도 설정 없이 수집 기능이 활성화됩니다.

  • store_k8s_object_manifest_timezone

    기본값 UTC

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

    • 지역 기반 타임존 또는 GMT 오프셋 형식으로 설정할 수 있습니다.

    • 분 단위의 정밀한 시간 지정을 지원합니다.

      예, GMT+0810과 같이 설정해 특정 지역의 비표준 시간대 지정 가능

  • store_k8s_object_manifest_max_fetch_limit

    기본값 50

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

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

Example
containers:
- name: whatap-master-agent
image: whatap/kube_mon
resources:
requests:
memory: 300Mi
cpu: 100m
limits:
memory: 350Mi
cpu: 200m
ports:
- containerPort: 6600
command: ['/bin/entrypoint.sh']
env:
- name: WHATAP_LICENSE
value: {PROJECT_LICENSE_VALUE}
- name: WHATAP_HOST
value: "13.124.11.223/13.209.172.35"
- name: WHATAP_PORT
value: "6600"
- name: WHATP_MEM_LIMIT
valueFrom:
resourceFieldRef:
containerName: whatap-master-agent
resource: limits.memory
# 추가된 환경 변수
- name: store_k8s_object_manifest_enabled
value: "true"
- name: store_k8s_object_manifest_timezone
value: "GMT+9"
- name: store_k8s_object_manifest_max_fetch_limit
value: "50"

기본 화면 안내

오브젝트 목록

오브젝트 종류 목록에서 원하는 오브젝트 선택 시 해당 오브젝트의 목록을 확인할 수 있습니다. Name, Namespace, Uid, CreatedTime 등의 오브젝트 정보가 표시됩니다. 다음 화면은 오브젝트 종류 목록에서 Deployment 선택 시 예시 화면입니다.

오브젝트 매니페스트

오브젝트 매니페스트 상세

오브젝트 목록에서 아이콘 상세 보기 버튼 선택 시 오브젝트 매니페스트 상세 창에서 선택한 오브젝트의 매니페스트를 조회할 수 있습니다.

오브젝트 매니페스트 상세

오브젝트 매니페스트 저장 시간 목록

  • 해당 오브젝트의 매니페스트가 저장된 시간 목록을 좌측에서 확인할 수 있습니다. 오브젝트 매니페스트는 매일 정해진 시간에 자동으로 저장됩니다.

  • 오브젝트 매니페스트 저장 시간은 마스터 에이전트의 컨테이너 환경변수 store_k8s_object_manifest_timezone 값을 수정해 변경할 수 있습니다.

  • 오브젝트 매니페스트는 매일 정해진 저장 시간에 저장될 뿐 아니라 경고 이벤트가 발생한 경우에도 추가로 저장됩니다.

노트

오브젝트 매니페스트가 저장되는 경고 이벤트는 Warning 타입의 쿠버네티스 이벤트 오브젝트를 의미합니다.

쿠버네티스 이벤트 연동

오브젝트 매니페스트 상세 창에서 Warning 아이콘 버튼 클릭 시 다음과 같이 쿠버네티스 이벤트를 확인할 수 있습니다.

쿠버네티스 이벤트 연동

노트

쿠버네티스 이벤트 연동 기능은 와탭 마스터 에이전트 버전 1.6.1 이상에서 지원합니다.

오브젝트 매니페스트 비교

아이콘 비교하기 토글 활성화 시 저장 시간 목록에서 선택해 다음과 같이 두 개의 오브젝트 매니페스트를 비교할 수 있습니다. 변경 사항이 있을 경우 하이라이팅됩니다.

오브젝트 매니페스트 비교하기

노트

컨테이너 맵에서 오브젝트 매니페스트 조회

컨테이너 맵에서 오브젝트 매니페스트를 확인할 수 있습니다.

컨테이너 맵에서 오브젝트 매니페스트 조회

  • 원하는 블록을 선택하세요.

  • 요약보기 창에서 대상 정보 탭을 선택해 Pod 또는 컨테이너 정보를 확인하세요.

  • Pod, Deployment, ReplicaSet, Node 태그의 오른쪽 더보기 아이콘더보기 아이콘을 클릭해 오브젝트 매니페스트를 선택하세요.