Obter métricas do Load Balancer com a CLI do Azure Monitor

Neste artigo, você aprende alguns exemplos para listar métricas do Load Balancer usando a CLI do Azure Monitor.

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

Tabela de nomes de métrica via CLI

Quando você usa a CLI, as métricas do Load Balancer podem usar um nome de métrica diferente para o valor do parâmetro da CLI. Ao especificar o nome da métrica por meio do parâmetro --metric dimension, use o nome da métrica da CLI. Por exemplo, a métrica de Disponibilidade do caminho de dados seria usada especificando um parâmetro --metric VipAvaialbility.

Esta é uma tabela das métricas comuns do Load Balancer, o nome da métrica da CLI e os valores de agregação recomendados para consultas:

Para obter definições de métrica e detalhes adicionais, confira Referência de monitoramento de dados do balanceador de carga.

Exemplos da CLI para métricas do Load Balancer

O comando az monitor metrics é usado para exibir métricas de recursos do Azure. Para ver as definições de métrica disponíveis para um Standard Load Balancer, 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>

Para recuperar as métricas do Standard Load Balancer de um recurso, você pode usar o comando az monitor metrics list. Por exemplo, use a opção --metric DipAvailability para coletar a métrica de Status da Investigação de Integridade de um Standard Load Balancer.

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

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

Quando você executar o comando acima, a saída para o status da Investigação de Integridade será semelhante à seguinte:

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"
    }
  ]
}
...

Você pode especificar o tipo de agregação para uma métrica com o parâmetro –-aggregation. Para as agregações recomendadas, consulte a [Referência do monitoramento 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, use o parâmetro --interval e especifique um valor no formato ##h##m. O intervalo padrão é 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 padrão, az monitor metrics list retorna as métricas de agregação do recurso da última hora. Você pode consultar os dados da métrica durante um período usando --start-time e --end-time com o formato data (aaaa-mm-dd) hora (hh:mm:ss.xxxxx) fuso-horário (+/-hh:mm). Para listar o status médio da Investigação de Integridade agregado por dia de 5 de maio de 2022 a 10 de maio de 2022, use 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

Para dividir métricas em uma dimensão, como "BackendIPAddress", especifique a dimensão no sinalizador --filter. As dimensões de uma métrica são pares nome/valor que incluem mais dados para descrever o valor da métrica. Para saber mais sobre quais dimensões têm suporte para cada métrica, confira a Referência de monitoramento 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

Você 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 você precisa filtrar com base em vários valores de dimensão, especifique o valor --filter usando 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 

Próximas etapas

• Examinar as definições de métrica para entender melhor como cada uma é gerada
• Criar monitores de conexão para seu Load Balancer
• Criar suas próprias pastas de trabalho, você pode fazer a inspiração clicando no botão Editar em seu painel de métricas detalhado