Partilhar via


Carregar métricas no Azure Monitor

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

Com os serviços de dados do Azure Arc, você pode, opcionalmente, carregar suas métricas no Azure Monitor para poder agregar e analisar métricas, gerar alertas, enviar notificações ou acionar ações automatizadas.

Enviar seus dados para o Azure Monitor também permite armazenar dados de métricas fora do local e em grande escala, permitindo o armazenamento de longo prazo dos dados para análises avançadas.

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

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

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

Nota

Se o carregamento automático de métricas tiver sido desabilitado durante a implantação do controlador do Azure Arc Data, você deverá primeiro recuperar a identidade gerenciada da extensão do controlador de dados do Arc e conceder a função de 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.

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 parênteses.

(1) Recuperar a identidade gerenciada da extensão do controlador de dados 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 função à identidade gerenciada

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

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

O carregamento automático de métricas pode ser ativado da seguinte forma:

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 no 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 o controlador de dados do Azure Arc no modo indireto

No modo de conexão indireta, a entidade de serviço é usada para carregar métricas.

Pré-requisitos

Antes de continuar, certifique-se de ter criado a entidade de serviço necessária e atribuí-la a uma função apropriada. Para obter mais detalhes, consulte:

Definir variáveis de ambiente e confirmar

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

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

Verifique se todas as variáveis de ambiente necessárias estão definidas, se desejar:

$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 a Instância Gerenciada do SQL habilitada pelo Azure Arc e pelo PostgreSQL habilitado para Azure Arc, execute os seguintes comandos da CLI:

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

Nota

Exportar informações de uso/faturamento, métricas e logs usando o comando az arcdata dc export requer ignorar a verificação SSL por enquanto. Você será solicitado a ignorar a verificação SSL ou poderá definir a variável de AZDATA_VERIFY_SSL=no ambiente para evitar solicitar. Atualmente, 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 métricas no monitor do Azure:

    az arcdata dc upload --path metrics.json
    

    Nota

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

    Certifique-se de que upload as métricas imediatamente depois export , pois o Azure Monitor só aceita métricas dos últimos 30 minutos. Mais informações.

Se você vir algum erro indicando "Falha na obtenção de 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

Procure em "seção de segurança"

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

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

Ver as métricas no Portal

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

Nota

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

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

Você pode visualizar 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 esquerdo

Escolha sql server ou postgres como o namespace métrico.

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

Altere a frequência para durar 30 minutos.

Nota

Você só pode carregar métricas dos últimos 30 minutos. O Azure Monitor rejeita métricas com mais de 30 minutos.

Automatização de carregamentos (opcional)

Se quiser carregar métricas e logs de forma agendada, você pode criar um script e executá-lo em um temporizador a cada poucos minutos. Abaixo está um exemplo de automatização dos uploads usando um shell script Linux.

No seu editor de texto/código favorito, adicione o seguinte script ao arquivo e salve como um arquivo executável de script, como .sh (Linux/Mac), .cmd, .batou .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 tarefas como cron ou Windows Task Scheduler ou um orquestrador como Ansible, Puppet ou Chef.

Orientações gerais sobre exportação e upload de uso, métricas

As operações de criação, leitura, atualização e exclusão (CRUD) nos serviços de dados habilitados para ArcGIS do Azure são registradas para fins de cobrança e monitoramento. Existem serviços em segundo plano que monitoram essas operações CRUD e calculam o consumo adequadamente. O cálculo real do uso ou consumo acontece de forma programada e é feito em segundo plano.

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

Para carregar métricas, o monitor do Azure só aceita os últimos 30 minutos de dados (Saiba mais). A orientação para carregar métricas é carregar as métricas imediatamente após a criação do arquivo de exportação para que você possa exibir todo o conjunto de dados no portal do Azure. Por exemplo, se você exportou as métricas às 14:00 e executou o comando upload às 14:50. Como o Azure Monitor só aceita dados dos últimos 30 minutos, você pode não ver nenhum dado no portal.

Carregar logs no Azure Monitor

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

Carregue dados de cobrança no Azure e visualize-os no portal do Azure

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