Carregar métricas no Azure Monitor

  • Artigo

Periodicamente, você pode exportar as métricas de monitoramento e carregá-las no Azure. A exportação e o upload dessas informações também criam e atualizam o controlador de dados, a instância gerenciada de SQL e os recursos do servidor PostgreSQL no Azure.

Com os serviços de dados do Azure Arc, como opção, você pode carregar as métricas no Azure Monitor para que possa agregar e analisar métricas, gerar alertas, enviar notificações ou disparar ações automatizadas.

Enviar os dados para o Azure Monitor também permite que você armazene dados de métricas fora do local e em grande escala, habilitando o armazenamento de longo prazo dos dados para análise avançada.

Se você tiver vários sites que têm os serviços de dados do Azure Arc, poderá usar o Azure Monitor como um local central para coletar todos os logs e métricas nos seus sites.

Carregar métricas para controlador de dados do Azure Arc no modo direto

No modo conectado direto, o carregamento de métricas só pode ser configurado no modo automático. Esse upload automático de métricas pode ser configurado durante a implantação do controlador de dados do Azure Arc ou pós-implantação. A identidade gerenciada da extensão de serviços de dados do Arc é usada para carregar métricas. A identidade gerenciada precisa ter a função Editor de Métricas de monitoramento atribuída a ela.

Observação

Se o carregamento automático de métricas foi desabilitado durante a implantação do controlador de Dados do Azure Arc, você deve primeiro recuperar a identidade gerenciada da extensão do controlador de dados do Arc e conceder a função Editor de Métricas de Monitoramento antes de habilitar o carregamento automático. Siga as etapas abaixo para recuperar a identidade gerenciada e conceder as funções necessárias.

Os exemplos neste artigo usam colchetes angulares < ... > para identificar valores que você precisa substituir antes de executar o script. Substitua os colchetes e os valores dentro dos colchetes.

(1) Recuperar a identidade gerenciada da extensão do controlador de dados do Arc

$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group <resource group>  --cluster-name <connectedclustername> --cluster-type connectedClusters --name <name of extension> | convertFrom-json).identity.principalId
#Example
$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group myresourcegroup  --cluster-name myconnectedcluster --cluster-type connectedClusters --name ads-extension | convertFrom-json).identity.principalId

(2) Atribuir uma função à identidade gerenciada

Execute o comando abaixo para atribuir a função Monitoramento de Métricas do Publicador:

az role assignment create --assignee $Env:MSI_OBJECT_ID --role 'Monitoring Metrics Publisher' --scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME"

O upload automático de métricas pode ser habilitado da seguinte maneira:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics true

Para desabilitar o carregamento automático de métricas para o Azure Monitor, execute o seguinte comando:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics false

Carregar métricas para controlador de dados do Azure Arc no modo indireto

No modo conectado indireto, a entidade de serviço é usada para carregar métricas.

Pré-requisitos

Antes de prosseguir, você precisa ter criado a entidade de serviço principal e atribuído a função apropriada a ela. Para obter detalhes, confira:

Definir as variáveis de ambiente e confirmar

Defina a URL da autoridade de SPN em uma variável de ambiente:

$Env:SPN_AUTHORITY='https://login.microsoftonline.com'

Se você quiser, verifique se todas as variáveis de ambiente necessárias estão definidas:

$Env:SPN_TENANT_ID
$Env:SPN_CLIENT_ID
$Env:SPN_CLIENT_SECRET
$Env:SPN_AUTHORITY

Carregar métricas no Azure Monitor

Para carregar métricas para as Instâncias Gerenciadas de SQL habilitadas para Azure Arc e PostgreSQL habilitado para Azure Arc, execute os seguintes comandos da CLI:

  1. Exporte todas as métricas para o arquivo especificado:

Observação

Para exportar métricas, logs e informações de uso/faturamento, o uso do comando az arcdata dc export requer bypass da verificação SSL por enquanto. Será solicitado o bypass da verificação SSL, ou é possível definir a variável de ambiente AZDATA_VERIFY_SSL=no para evitar a solicitação. No momento, não é possível configurar um certificado SSL para a API de exportação do controlador de dados.

az arcdata dc export --type metrics --path metrics.json --k8s-namespace arc

  1. Carregue as métricas no Azure Monitor:

    az arcdata dc upload --path metrics.json

    Observação

    Aguarde pelo menos 30 minutos depois que as instâncias de dados habilitadas para o Azure Arc forem criadas para o primeiro carregamento.

    Verifique se as métricas upload estão imediatamente após export, já que o Azure Monitor aceita apenas as métricas dos últimos 30 minutos. Saiba mais.

Se você vir algum erro indicando “Falha ao obter as métricas” durante a exportação, verifique se a coleta de dados está definida como true executando o seguinte comando:

az arcdata dc config show  --k8s-namespace arc --use-k8s

Procurar na “seção de segurança”

 "security": {
      "allowDumps": true,
      "allowNodeMetricsCollection": true,
      "allowPodMetricsCollection": true,
    },

Verifique se as propriedades allowNodeMetricsCollection e allowPodMetricsCollection estão definidas como true.

Exibir as métricas no portal

Depois que as métricas forem carregadas, você poderá visualizá-las no portal do Azure.

Observação

Observe que pode levar alguns minutos para que os dados carregados sejam processados antes que você possa exibir as métricas no portal.

Para exibir suas métricas, navegue até o portal do Azure. Em seguida, pesquise sua instância de banco de dados por nome na barra de pesquisa:

Você pode exibir a utilização da CPU na página Visão geral ou se quiser métricas mais detalhadas, clique nas métricas no painel de navegação à esquerda

Escolha o SQL Server ou Postgres como o namespace de métrica.

Selecione a métrica que você deseja visualizar (também é possível selecionar várias).

Altere a frequência para os últimos 30 minutos.

Observação

Só é possível carregar métricas para os últimos 30 minutos. O Azure Monitor rejeita as métricas com mais de 30 minutos.

Automatizar carregamentos (opcional)

Se você quiser carregar as métricas e os logs de maneira agendada, crie um script e execute-o em um temporizador a cada poucos minutos. Confira abaixo um exemplo de como automatizar os uploads usando um script de shell do Linux.

No seu editor de texto/código favorito, adicione o script a seguir ao arquivo e salve como um arquivo executável de script, como .sh (Linux/Mac), .cmd, .bat ou .ps1.

az arcdata dc export --type metrics --path metrics.json --force  --k8s-namespace arc
az arcdata dc upload --path metrics.json

Tornar o arquivo de script executável

chmod +x myuploadscript.sh

Execute o script a cada 20 minutos:

watch -n 1200 ./myuploadscript.sh

Você também pode usar um Agendador de trabalho como cron ou Agendador de Tarefas do Windows ou um orquestrador como Ansible, Puppet ou Chef.

Diretrizes gerais sobre como exportar e carregar o uso, métricas

As operações CRUD (criar, ler, atualizar e excluir) nos serviços de dados habilitados para Azure Arc são registradas para fins de cobrança e monitoramento. Há serviços em segundo plano que monitoram essas operações CRUD e calculam o consumo adequadamente. O cálculo real do uso ou do consumo ocorre de forma programada e é feito em segundo plano.

Carregar o uso apenas uma vez por dia. Quando as informações de uso são exportadas e carregadas várias vezes no mesmo período de 24 horas, somente o inventário de recursos é atualizado no portal do Azure, mas não no uso do recurso.

Para carregar métricas, o Azure Monitor só aceita os últimos 30 minutos de dados (Saiba mais). As diretrizes para carregar métricas são para carregar as métricas imediatamente após criar o arquivo de exportação para que você possa exibir o conjunto de dados inteiro no portal do Azure. Por exemplo, se você exportou as métricas às 14:00 e executou o comando upload às 14:50. Como Azure Monitor só aceita dados nos últimos 30 minutos, talvez você não veja nenhum dado no portal.

Conteúdo relacionado

Carregar logs para o Azure Monitor

Carregar dados de uso, métricas e logs no Azure Monitor

Carregar dados de cobrança no Azure e exibi-los no portal do Azure

Exibir recurso do controlador de dados do Azure Arc no portal do Azure