클러스터 메트릭 구성
사용자가 클러스터를 배포하면 표준 메트릭 집합이 컬렉션에 사용 설정됩니다. 메트릭 목록은 수집된 메트릭 목록을 참조하세요.
사용자는 여기에 포함된 표준 메트릭의 컬렉션에 대한 동작(사용 또는 사용 안 함)을 제어할 수 없습니다. 하지만 사용자는 목록에 대한 링크의 일부가 아닌 일부 선택적 메트릭의 컬렉션을 제어할 수 있습니다. 이 환경을 사용하려면 사용자는 클러스터에 대한 MetricsConfiguration 리소스를 만들고 업데이트해야 합니다. 기본적으로 이 MetricsConfiguration 리소스를 만들면 메트릭 컬렉션이 변경되지 않습니다. 사용자는 이러한 선택적 메트릭 컬렉션을 사용하거나 사용하지 않도록 설정하기 위해 리소스를 업데이트해야 합니다.
참고 항목
- 클러스터의 경우 최대 1개의 MetricsConfiguration 리소스만 만들 수 있습니다.
- 사용자는 제어할 수 있는 선택적 메트릭 목록을 확인하기 위해 MetricsConfiguration 리소스를 만들어야 합니다.
- MetricsConfiguration 리소스를 삭제하면 표준 메트릭 집합이 복원됩니다.
클러스터 메트릭 구성을 관리하는 방법
클러스터 메트릭 구성의 수명 주기를 지원하기 위해 다음 상호 작용을 통해 클러스터의 메트릭 구성을 만들고 관리할 수 있습니다.
메트릭 구성 만들기
az network cluster metricsconfiguration create 명령을 사용하여 클러스터에 대한 메트릭 구성을 만듭니다. Azure 구독이 여러 개 있는 경우 사용자는 --subscription <SUBSCRIPTION_ID> 플래그를 사용하여 구독 ID를 CLI 명령에 전달하거나 az account set 명령을 사용하여 적절한 구독 ID를 선택해야 합니다.
az networkcloud cluster metricsconfiguration create \
--cluster-name "<CLUSTER>" \
--extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
--location "<LOCATION>" \
--collection-interval <COLLECTION_INTERVAL (1-1440)> \
--enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
--tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
--resource-group "<RESOURCE_GROUP>"
<>내의 값을 특정 정보로 대체합니다.- 클러스터 리소스를 쿼리하고
properties.clusterExtendedLocation에서<CLUSTER-EXTENDED-LOCATION-ID>값을 찾습니다. collection-interval필드는 필수 필드이며enabled-metrics는 선택적 필드입니다.
아니면 연산자는 json 또는 yaml 파일을 통해 활성화된 메트릭 목록을 제공할 수 있습니다.
예: enabled-metrics.json 파일
[
"metric_1",
"metric_2"
]
예: enabled-metrics.yaml 파일
- "metric_1"
- "metric_2"
enabled-metrics json/yaml 파일을 사용하는 예제 명령:
az networkcloud cluster metricsconfiguration create \
--cluster-name "<CLUSTER>" \
--extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
--location "<LOCATION>" \
--collection-interval <COLLECTION_INTERVAL (1-1440)> \
--enabled-metrics <path-to-yaml-or-json-file> \
--tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
--resource-group "<RESOURCE_GROUP>"
여기에서 작업을 수행하기 전에 <path-to-yaml-or-json-file>은 ./enabled-metrics.json 또는 ./enabled-metrics.yaml(현재 작업 디렉터리 아래에 파일 배치)일 수 잇습니다.
사용 가능한 모든 매개 변수와 해당 설명을 보려면 다음 명령을 실행합니다.
az networkcloud cluster metricsconfiguration create --help
메트릭 구성 요소
| 매개 변수 이름 | 설명 |
|---|---|
| CLUSTER | 클러스터의 리소스 이름 |
| 위치 | 클러스터가 배포되는 Azure 지역 |
| CLUSTER_EXTENDED_LOCATION_ID | Azure Portal의 클러스터 확장 위치 |
| COLLECTION_INTERVAL | 기본 표준 메트릭의 수집 빈도 |
| RESOURCE_GROUP | 클러스터 리소스 그룹 이름 |
| TAG_KEY1 | MetricsConfiguration create에 전달할 선택적 tag1 |
| TAG_VALUE1 | MetricsConfiguration create에 전달할 선택적 tag1 값 |
| TAG_KEY2 | MetricsConfiguration create에 전달할 선택적 tag2 |
| TAG_VALUE2 | MetricsConfiguration create에 전달할 선택적 tag2 값 |
| METRIC_TO_ENABLE_1 | 기본 메트릭 외에 사용 설정된 선택적 메트릭 "METRIC_TO_ENABLE_1" |
| METRIC_TO_ENABLE_2 | 기본 메트릭 외에 사용 설정된 선택적 메트릭 "METRIC_TO_ENABLE_2" |
az 명령에서 --no-wait --debug 옵션을 지정하면 이 명령이 비동기적으로 실행됩니다. 자세한 내용은 비동기 작업 추적 방법을 참조하세요.
참고 항목
- 표준 메트릭 집합에 대한 기본 메트릭 수집 간격은 5분으로 설정됩니다.
collectionInterval을 변경하면 기본 표준 메트릭의 수집 빈도에도 영향을 줍니다. - 클러스터당 하나의 메트릭 구성 집합만 정의할 수 있습니다. 리소스는
default라는 이름으로 만들어집니다.
메트릭 구성 나열
az networkcloud cluster metricsconfiguration list 명령을 사용하여 특정 클러스터에 대한 메트릭 구성 리소스를 확인할 수 있습니다.
az networkcloud cluster metricsconfiguration list \
--cluster-name "<CLUSTER>" \
--resource-group "<RESOURCE_GROUP>"
메트릭 구성 검색
메트릭 구성을 만든 후 운영자는 az networkcloud cluster metricsconfiguration show 명령을 사용하여 리소스에 대한 세부 정보를 확인할 수 있습니다.
az networkcloud cluster metricsconfiguration show \
--cluster-name "<CLUSTER>" \
--resource-group "<RESOURCE_GROUP>"
이 명령은 메트릭 구성의 JSON 표현을 반환합니다. 이 명령에 대한 출력으로 수집 빈도 외에도 사용 및 사용 안 함 메트릭 목록을 확인할 수 있습니다.
메트릭 구성 업데이트
메트릭 구성을 만드는 것과 마찬가지로 운영자는 업데이트 작업을 수행하여 구성을 변경하거나 메트릭 구성에 할당된 태그를 업데이트할 수 있습니다.
az networkcloud cluster metricsconfiguration update \
--cluster-name "<CLUSTER>" \
--collection-interval <COLLECTION_INTERVAL (1-1440)> \
--enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
--tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
--resource-group "<RESOURCE_GROUP>"
연산자는 enabled-metrics 목록에 관계없이 collection-interval을 업데이트할 수 있습니다. 변경되지 않는 필드를 생략합니다.
az 명령에서 --no-wait --debug 옵션을 지정하면 이 명령이 비동기적으로 실행됩니다. 자세한 내용은 비동기 작업 추적 방법을 참조하세요.
메트릭 구성 삭제
메트릭 구성을 삭제하면 클러스터가 변경되지 않은 구성으로 반환됩니다. 메트릭 구성을 삭제하려면 다음 명령을 사용합니다.
az networkcloud cluster metricsconfiguration delete \
--cluster-name "<CLUSTER>" \
--resource-group "<RESOURCE_GROUP>"
az 명령에서 --no-wait --debug 옵션을 지정하면 이 명령이 비동기적으로 실행됩니다. 자세한 내용은 비동기 작업 추적 방법을 참조하세요.