컨테이너 인사이트로 수집한 메트릭

컨테이너 인사이트는 AKS(Azure Kubernetes Service) 및 Azure Arc 지원 Kubernetes 클러스터 노드 및 Pod에서 사용자 지정 메트릭을 수집합니다. 사용자 지정 메트릭을 사용하면 다음을 수행할 수 있습니다.

  • 집계 계산(평균, 개수, 최댓값, 최솟값 및 합계)을 성능 차트에 적시에 표시합니다.
  • 성능 차트를 Azure Portal 대시보드에 고정합니다.
  • 메트릭 경고를 활용합니다.

Important

이러한 메트릭은 컨테이너 인사이트 권장 경고(사용자 지정 메트릭)(미리 보기) 2024년 5월 31일부터 사용 중지에 설명된 대로 2024년 5월 31일부터 더 이상 수집되지 않습니다. Prometheus 메트릭 수집을 사용하도록 설정하려면 Prometheus 및 Grafana 사용을 참조하세요.

사용자 지정 메트릭 사용

컨테이너 인사이트에서 수집한 사용자 지정 메트릭은 메트릭 탐색기메트릭 경고를 포함하여 다른 데이터 원본에서 수집한 사용자 지정 메트릭과 동일한 방법으로 액세스할 수 있습니다.

수집된 메트릭

다음 섹션에서는 클러스터에 대해 수집된 메트릭 값을 설명합니다.

노드 메트릭

네임스페이스:Insights.container/nodes
차원:host

메트릭 설명
cpuUsageMillicores 호스트별 관한 CPU 사용률(밀리코어)입니다.
cpuUsagePercentage, cpuUsageAllocatablePercentage(미리 보기) 노드별 CPU 사용량 백분율과 각각 할당 가능한 양입니다.
memoryRssBytes 호스트의 메모리 RSS 사용률 (바이트)입니다.
memoryRssPercentage, memoryRssAllocatablePercentage(미리 보기) 호스트별 메모리 RSS 사용량 백분율과 각각 할당 가능한 양입니다.
memoryWorkingSetBytes 호스트의 메모리 작업 집합 사용률 (바이트)입니다.
memoryWorkingSetPercentage, memoryRssAllocatablePercentage(미리 보기) 호스트별 메모리 작업 세트 사용량 백분율과 각각 할당 가능한 양입니다.
nodesCount 상태별 노드 수입니다.
diskUsedPercentage 장치에서 노드에 사용 된 디스크의 백분율입니다.

Pod 메트릭

네임스페이스:Insights.container/pods
차원:controllerName, Kubernetes namespace

메트릭 설명
podCount 컨트롤러, 네임 스페이스, 노드 및 단계의 pod 수입니다.
completedJobsCount 완료된 작업은 컨트롤러, Kubernetes 네임 스페이스별로 사용자가 구성할 수 있는 이전 임계값(기본값은 6시간)을 계산합니다.
restartingContainerCount 컨트롤러, Kubernetes 네임스페이스별로 컨테이너를 다시 시작하는 횟수입니다.
oomKilledContainerCount 컨트롤러, Kubernetes 네임스페이스별로 중지된 컨테이너 수입니다.
podReadyPercentage 컨트롤러, Kubernetes 네임스페이스에서 준비 상태에 있는 pod의 백분율입니다.

컨테이너 메트릭

네임스페이스:Insights.container/containers
차원:containerName, controllerName, Kubernetes namespace, podName

메트릭 설명
(Old)cpuExceededPercentage 컨테이너 이름, 컨트롤러 이름, Kubernetes 네임 스페이스, pod 이름에 의해 사용자 구성 가능 임계값 (기본값은 95.0)을 초과하는 컨테이너에 대한 CPU 사용률입니다.
수집됨
(New)cpuThresholdViolated 컨테이너의 CPU 사용률이 컨테이너 이름, 컨트롤러 이름, Kubernetes 네임스페이스, Pod 이름별로 사용자가 구성 가능한 임계값(기본값은 95.0)을 초과하는 경우에 트리거되는 메트릭입니다.
수집됨
(Old)memoryRssExceededPercentage 컨테이너 이름, 컨트롤러 이름, Kubernetes 네임 스페이스, 포드 이름별로 사용자 구성 가능한 임계값(기본값은 95.0)을 초과하는 컨테이너에 대한 메모리 RSS 백분율입니다.
(New)memoryRssThresholdViolated 컨테이너의 메모리 RSS 백분율이 컨테이너 이름, 컨트롤러 이름, Kubernetes 네임스페이스, Pod 이름별로 사용자가 구성 가능한 임계값(기본값은 95.0)을 초과하는 경우에 트리거되는 메트릭입니다.
(Old)memoryWorkingSetExceededPercentage 컨테이너 이름, 컨트롤러 이름, Kubernetes 네임 스페이스, pod 이름에 의해 사용자 구성 가능 임계값 (기본값은 95.0)을 초과 하는 컨테이너에 대한 메모리 작업 집합 비율입니다.
(New)memoryWorkingSetThresholdViolated 컨테이너의 메모리 작업 세트 백분율이 컨테이너 이름, 컨트롤러 이름, Kubernetes 네임스페이스, Pod 이름별로 사용자가 구성 가능한 임계값(기본값은 95.0)을 초과하는 경우에 트리거되는 메트릭입니다.

영구 볼륨 메트릭

네임스페이스:Insights.container/persistentvolumes
차원:kubernetesNamespace, node, podName, volumeName

메트릭 설명
(Old)pvUsageExceededPercentage 클레임 이름, Kubernetes 네임 스페이스, 볼륨 이름, pod 이름 및 노드 이름에 의해 사용자 구성 가능 임계값 (기본값은 60.0)을 초과 하는 영구 볼륨에 대한 PV(영구 볼륨) 사용률 비율입니다.
(New)pvUsageThresholdViolated 영구 볼륨의 PV 사용률 비율이 클레임 이름, Kubernetes 네임 스페이스, 볼륨 이름, Pod 이름 및 노드 이름별로 사용자가 구성 가능한 임계값(기본값은 60.0)을 초과하는 경우에 트리거되는 메트릭입니다.

사용자 지정 메트릭 사용

클러스터가 컨테이너 인사이트에 대해 관리 ID 인증을 사용하는 경우 사용자 지정 메트릭이 사용하도록 설정됩니다. 그렇지 않은 경우 다음 방법 중 하나를 사용하여 사용자 지정 메트릭을 사용하도록 설정해야 합니다.

이 프로세스는 모니터링 메트릭 게시자 역할을 클러스터의 서비스 주체에 할당합니다. 모니터링 메트릭 게시자는 리소스에 메트릭을 푸시할 수 있는 권한만 있습니다. 상태를 변경하거나 리소스를 업데이트하거나 데이터를 읽을 수 없습니다. 자세한 내용은 모니터링 메트릭 게시자 역할을 참조하세요. 모니터링 메트릭 게시자 역할 요구 사항은 Azure Arc 지원 Kubernetes 클러스터에 적용되지 않습니다.

필수 조건

클러스터를 업데이트하기 전에 노드 및 Pod에 대한 사용자 지정 성능 메트릭을 수집할 수 있도록 AKS 클러스터 리소스에 대한 소유자 역할의 멤버인지 확인합니다. 이 요구 사항은 Azure Arc 사용 Kubernetes 클러스터에 적용되지 않습니다.

사용 옵션

다음 방법 중 하나를 사용하여 단일 클러스터 또는 구독의 모든 클러스터에 대한 사용자 지정 메트릭을 사용하도록 설정합니다.

  1. Azure Portal에서 클러스터에 대한 Insights 메뉴를 선택합니다.

  2. 창 상단에 표시되는 배너에서 사용을 선택하여 업데이트를 시작합니다.

    Screenshot that shows the Azure portal with the banner for upgrading an AKS cluster.

    프로세스를 마치는 데 몇 초 정도 걸릴 수 있습니다. 메뉴의 알림에서 진행 상황을 추적할 수 있습니다.

업데이트 확인

사용자 지정 메트릭이 사용하도록 설정되어 있는지 확인하려면 메트릭 탐색기를 열어 사용자 지정 메트릭이 사용하도록 설정되어 있는지 확인하고 인사이트가 나열되어 있는지 메트릭 네임스페이스에서 확인합니다.

다음 단계