Azure Monitor CLI를 사용하여 Load Balancer 메트릭 가져오기

이 문서에서는 Azure Monitor CLI를 사용하여 Load Balancer 메트릭을 나열하는 몇 가지 예제를 알아봅니다.

Azure Monitor CLI를 사용하여 메트릭을 검색하기 위한 전체 참조 설명서 및 기타 샘플은 az monitor metrics 참조에서 볼 수 있습니다.

CLI를 통한 메트릭 이름 표

CLI를 사용하는 경우 Load Balancer 메트릭은 CLI 매개 변수 값에 다른 메트릭 이름을 사용할 수 있습니다. --metric dimension 매개 변수를 통해 메트릭 이름을 지정할 때는 CLI 메트릭 이름을 대신 사용합니다. 예를 들어 메트릭 데이터 경로 가용성은 --metric VipAvaialbility 매개 변수를 지정하여 사용합니다.

다음은 일반적인 Load Balancer 메트릭, CLI 메트릭 이름 및 쿼리에 대한 권장 집계 값의 표입니다.

메트릭 정의 및 자세한 내용은 부하 분산 장치 모니터링 데이터 참조를 참조하세요.

Load Balancer 메트릭에 대한 CLI 예제

az monitor metrics 명령은 Azure 리소스 메트릭을 보는 데 사용됩니다. 표준 Load Balancer에 사용할 수 있는 메트릭 정의를 보려면 az monitor metrics list-definitions 명령을 실행합니다.

# Display available metric definitions for a Standard Load Balancer resource

az monitor metrics list-definitions --resource <resource_id>

리소스에 대한 표준 Load Balancer 메트릭을 검색하려면 az monitor metrics list 명령을 사용할 수 있습니다. 예를 들어 --metric DipAvailability 옵션을 사용하여 표준 Load Balancer의 상태 프로브 상태 메트릭을 수집합니다.

# List the Health Probe Status metric from a Standard Load Balancer

az monitor metrics list --resource <resource_id> --metric DipAvailability 

위의 명령을 실행하면 상태 프로브 상태에 대한 출력이 다음과 같이 표시됩니다.

user@Azure:~$ az monitor metrics list --resource <resource_id> --metric DipAvailability
{
  "cost": 59,
  "interval": "0:01:00",
  "namespace": "Microsoft.Network/loadBalancers",
  "resourceregion": "eastus2",
  "timespan": "2022-06-30T15:22:39Z/2022-06-30T16:22:39Z",
  "value": [
    {
      "displayDescription": "Average Load Balancer health probe status per time duration",
      "errorCode": "Success",
      "errorMessage": null,
      "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLoadBalancer/providers/Microsoft.Insights/metrics/DipAvailability",
      "name": {
        "localizedValue": "Health Probe Status",
        "value": "DipAvailability"
      },
      "resourceGroup": "myResourceGroup",
      "timeseries": [],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    }
  ]
}
...

–-aggregation 매개 변수를 사용하여 메트릭의 집계 유형을 지정할 수 있습니다. 권장 집계는 부하 분산 장치 모니터링 데이터 참조](./monitor-load-balancer-reference.md)를 참조하세요.

# List the average Health Probe Status metric from a Standard Load Balancer

az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average 

메트릭에 간격을 지정하려면 --interval 매개 변수를 사용하고 ##h##m 형식의 값을 지정합니다. 기본 간격은 1m입니다.

# List the average List the average Health Probe Status metric from a Standard Load Balancer in 5 minute intervals

az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average --interval 5m

기본적으로 az monitor metrics 목록은 지난 1시간 동안의 리소스 집계 메트릭을 반환합니다. --start-time 및 --end-time을 사용하여 날짜 형식(yyyy-mm-dd) 시간(hh:mm:ss.xxxxx) 표준 시간대(+/-hh:mm)로 일정 기간의 메트릭 데이터를 쿼리할 수 있습니다. 2022년 5월 5일부터 2022년 5월 10일까지 매일 집계된 평균 상태 프로브 상태를 나열하려면 다음 명령을 사용합니다.

# List average Health Probe Status metric aggregated per day from May 5, 2022 and May 10, 2022. 

az monitor metrics list --resource <resource_id> --metric DipAvailability --start-time 2022-05-01T00:00:00Z --end-time 2022-05-10T00:00:00Z --interval PT24H --aggregation Average

"BackendIPAddress"와 같은 차원의 메트릭을 분할하려면 --filter 플래그에 차원을 지정합니다. 메트릭의 차원은 메트릭 값을 설명하기 위해 더 많은 데이터를 포함하는 이름/값 쌍입니다. 각 메트릭에 대해 지원되는 차원에 대한 자세한 내용은 부하 분산 장치 모니터링 데이터 참조를 참조하세요.

# List average Health Probe Status metric and filter for all BackendIPAddress dimensions

az monitor metrics list --resource $res --metric DipAvailability --filter "BackendIPAddress eq '*'" --aggregation Average

특정 차원 값을 지정할 수도 있습니다.

# List average Health Probe Status metric and filter for the 10.1.0.4 BackendIPAddress dimension

az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '10.1.0.4'" --aggregation Average 

여러 차원 값을 필터링해야 하는 경우 and를 사용하여 값 간에 --filter 값을 지정합니다.

# List average Health Probe Status metric and filter for all BackendIPAddress and BackendPort dimensions

az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '*' and BackendPort eq '*'" --aggregation Average 

다음 단계

• 각 항목이 생성되는 방식을 더 잘 이해하기 위해 메트릭 정의 검토
• Load Balancer에 대한 연결 모니터를 만듭니다.
• 사용자 고유의 통합 문서를 만듭니다. 자세한 메트릭 대시보드에서 편집 단추를 클릭하여 이를 수행할 수 있습니다.