Share via

Obter métricas de Balanceador de Carga com a CLI do Azure Monitor

  • Artigo

Neste artigo, irá aprender alguns exemplos para listar Balanceador de Carga métricas com a CLI do Azure Monitor.

A documentação de referência completa e outros exemplos para obter métricas com a CLI do Azure Monitor estão disponíveis na referência de métricas do az monitor.

Tabela de nomes de métricas através da CLI

Quando utiliza a CLI, Balanceador de Carga métricas podem utilizar um nome de métrica diferente para o valor do parâmetro da CLI. Ao especificar o nome da métrica através do --metric dimension parâmetro, utilize o nome da métrica da CLI. Por exemplo, a métrica Disponibilidade do caminho de dados seria utilizada ao especificar um parâmetro de --metric VipAvaialbility.

Eis uma tabela de métricas de Balanceador de Carga comuns, o nome da métrica da CLI e os valores de agregação recomendados para consultas:

Metric Nome da métrica da CLI Agregação recomendada
Disponibilidade do caminho dos dados VipAvailability Média
Estado da sonda de estado de funcionamento DipAvailability Média
Contagem de SYN (sincronização) SYNCount Média
Contagem de ligações SNAT SnatConnectionCount Soma
Portas SNAT alocadas AllocatedSnatPorts Média
Portas SNAT utilizadas UsedSnatPorts Média
Contagem de bytes ByteCount Soma
Contagem de pacotes PacketCount Soma

Para obter definições de métricas e detalhes adicionais, veja Monitorizar a referência de dados do balanceador de carga.

Exemplos da CLI para métricas de Balanceador de Carga

O comando az monitor metrics é utilizado para ver as métricas de recursos do Azure. Para ver as definições de métricas disponíveis para um Balanceador de Carga Standard, execute o comando az monitor metrics list-definitions.

# Display available metric definitions for a Standard Load Balancer resource

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

Nota

Em todos os exemplos seguintes, substitua <resource_id> pelo ID de recurso exclusivo do seu Balanceador de Carga Standard.

Para obter Balanceador de Carga Standard métricas de um recurso, pode utilizar o comando az monitor metrics list. Por exemplo, utilize a opção --metric DipAvailability para recolher a métrica Estado da Sonda de Estado de Funcionamento de um Balanceador de Carga Standard.


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

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

Quando executar o comando acima, o resultado do estado da Sonda de Estado de Funcionamento será semelhante ao seguinte resultado:

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/6a5f35e9-6951-499d-a36b-83c6c6eed44a/resourceGroups/myResourceGroup2/providers/Microsoft.Network/loadBalancers/myLoadBalancer/providers/Microsoft.Insights/metrics/DipAvailability",
      "name": {
        "localizedValue": "Health Probe Status",
        "value": "DipAvailability"
      },
      "resourceGroup": "myResourceGroup2",
      "timeseries": [],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    }
  ]
}
...

Pode especificar o tipo de agregação de uma métrica com o –-aggregation parâmetro . Para obter as agregações recomendadas, veja Monitorizar a referência de dados do balanceador de carga](./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

Para especificar o intervalo para as métricas, utilize o --interval parâmetro e especifique um valor no formato ##h##m. O intervalo predefinido é de 1 m.


# 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

Por predefinição, a lista de métricas do az monitor devolve as métricas agregadas do recurso da última hora. Pode consultar dados de métricas durante um período de tempo utilizando --start-time e --end-time com o formato de data (aaaa-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm). Para listar o Estado médio da Sonda de Estado de Funcionamento agregado por dia a partir de 5 de maio de 2022 e 10 de maio de 2022, utilize o seguinte comando:

# 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

Nota

As horas de início e de fim são representadas com um formato de yyyy-mm-dd. Por exemplo, todos os dias, entre 5 de maio de 2022 e 10 de maio de 2022, seriam representados como 2022-05-01 e 2022-05-10.

Para dividir métricas numa dimensão, como "BackendIPAddress", especifique a dimensão no --filter sinalizador. As dimensões de uma métrica são pares de nomes/valores que incluem mais dados para descrever o valor da métrica. Para saber mais sobre que dimensões são suportadas para cada métrica, veja Monitorizar a referência de dados do balanceador de carga.

# 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

Também pode especificar um valor de dimensão específico.

# 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

Nos casos em que precisa de filtrar vários valores de dimensão, especifique o --filter valor que utiliza and entre os valores.

# 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

Passos seguintes