Enviar métricas do Prometheus de Máquinas Virtuais para um workspace do Azure Monitor
O Prometheus não se limita ao monitoramento de clusters do Kubernetes. Use o Prometheus para monitorar aplicativos e serviços em execução em seus servidores, onde quer que eles estejam em execução. Por exemplo, você pode monitorar aplicativos em execução em Máquinas Virtuais, Conjuntos de Dimensionamento de Máquinas Virtuais ou até mesmo servidores locais. Instale o Prometheus em seus servidores e configure a gravação remota para enviar métricas para um workspace do Azure Monitor.
Este artigo explica como configurar a gravação remota para enviar dados de uma instância do Prometheus autogerenciado para um workspace do Azure Monitor.
Opções de gravação remota
O Prometheus autogerenciado pode ser executado em ambientes do Azure e ambientes que não sejam do Azure. Veja a seguir as opções de autenticação para gravação remota no workspace do Azure Monitor com base no ambiente em que o Prometheus está em execução.
Máquinas Virtuais gerenciadas do Azure e Conjuntos de Dimensionamento de Máquinas Virtuais
Use a autenticação de identidade gerenciada atribuída pelo usuário para serviços que executam o Prometheus autogerenciado em um ambiente do Azure. Os serviços gerenciados do Azure incluem:
- Máquinas Virtuais do Azure
- Conjuntos de dimensionamento de máquina virtual do Azure
- Máquinas Virtuais habilitadas para Azure Arc
Para configurar a gravação remota para recursos gerenciados do Azure, confira Gravação remota usando a identidade gerenciada atribuída pelo usuário.
Máquinas virtuais em execução em ambientes que não são do Azure.
A integração aos serviços habilitados para Azure Arc permite que você gerencie e configure máquinas virtuais que não são do Azure no Azure. Depois de integrado, configure a Gravação remota usando a autenticação de identidade gerenciada atribuída pelo usuário. Para obter mais informações sobre como integrar máquinas virtuais a servidores habilitados para Azure Arc, confira Servidores habilitados para Azure Arc.
Se você tiver máquinas virtuais em ambientes que não são do Azure e não quiser integrá-las ao Azure Arc, instale o Prometheus autogerenciado e configure a gravação remota usando a autenticação de aplicativo do Microsoft Entra ID. Para obter mais informações, confira Gravação remota usando a autenticação de aplicativo do Microsoft Entra ID.
Pré-requisitos
Versões suportadas
- Versões do Prometheus maiores que a v2.45 são necessárias para autenticação de identidade gerenciada.
- Versões do Prometheus maiores que a v2.48 são necessárias para autenticação de aplicativo do Microsoft Entra ID.
Workspace do Azure Monitor
Este artigo aborda o envio de métricas do Prometheus para um workspace do Azure Monitor. Para criar um workspace do Azure Monitor, confira Gerenciar um workspace do Azure Monitor.
Permissões
Permissões de administrador para o cluster ou recurso são necessárias para concluir as etapas neste artigo.
Configurar a autenticação para gravação remota
Dependendo do ambiente em que o Prometheus está em execução, você pode configurar a gravação remota para usar a identidade gerenciada atribuída pelo usuário ou a autenticação de aplicativo do Microsoft Entra ID para enviar dados para o workspace do Azure Monitor.
Use o portal do Azure ou a CLI para criar uma identidade gerenciada atribuída pelo usuário ou um aplicativo do Microsoft Entra ID.
- Gravação remota usando a identidade gerenciada atribuída pelo usuário
- Aplicativo do Microsoft Entra ID
- CLI
Gravação remota usando autenticação de identidade gerenciada atribuída pelo usuário
Para configurar uma identidade gerenciada atribuída pelo usuário para gravação remota no workspace do Azure Monitor, conclua as etapas a seguir.
Criar uma identidade gerenciada atribuída ao usuário
Para criar uma identidade gerenciada pelo usuário para usar em sua configuração de gravação remota, confira Gerenciar identidades gerenciadas atribuídas pelo usuário.
Observe o valor de clientId
da identidade gerenciada que você criou. Esta ID é usada na configuração de gravação remota do Prometheus.
Atribuir a função Editor de Métricas de Monitoramento ao aplicativo
Atribua a função Monitoring Metrics Publisher
na regra de coleta de dados do workspace à identidade gerenciada.
Na página Visão geral do workspace do Azure Monitor, selecione o link da Regra de coleta de dados.
Na página de regras de coleta de dados, selecione Controle de acesso (IAM).
Pesquise e selecione o Editor de Métricas de Monitoramento e selecione Avançar.
Selecione Identidade Gerenciada.
Selecione Selecionar membros.
Na lista suspensa Entidade gerenciada, Identidade gerenciada atribuída pelo usuário.
Selecione a identidade atribuída pelo usuário que você deseja usar e clique em Selecionar.
Clique em Revisar + atribuir para concluir a atribuição de função.
Atribua a identidade gerenciada a uma máquina virtual ou conjunto de dimensionamento de máquinas virtuais.
Importante
Para concluir as etapas nesta seção, você deve ter permissões de administrador de acesso de usuário ou proprietário para a Máquina Virtual ou Conjunto de Dimensionamento de Máquinas Virtuais.
No portal do Azure, vá para a página do cluster, Máquina Virtual ou Conjunto de Dimensionamento de Máquinas Virtuais.
Selecionar Identidade.
Selecione Atribuída pelo usuário.
Selecione Adicionar.
Selecione a identidade gerenciada atribuída pelo usuário que você criou e, em seguida, selecione Adicionar.
Configurar gravação remota
A gravação remota está configurada no arquivo de configuração do Prometheus prometheus.yml
.
Para obter mais informações sobre como configurar a gravação remota, confira o artigo do Prometheus.io: Configuração. Para obter mais informações sobre como ajustar a configuração de gravação remota, confira Ajuste de gravação remota.
Para enviar dados ao workspace do Azure Monitor, adicione a seção a seguir ao arquivo de configuração da instância do Prometheus autogerenciado.
remote_write:
- url: "<metrics ingestion endpoint for your Azure Monitor workspace>"
# AzureAD configuration.
# The Azure Cloud. Options are 'AzurePublic', 'AzureChina', or 'AzureGovernment'.
azuread:
cloud: 'AzurePublic'
managed_identity:
client_id: "<client-id of the managed identity>"
oauth:
client_id: "<client-id from the Entra app>"
client_secret: "<client secret from the Entra app>"
tenant_id: "<Azure subscription tenant Id>"
O parâmetro url
especifica o ponto de extremidade de ingestão de métricas do workspace do Azure Monitor. Ele pode ser encontrado na página de visão geral do workspace do Azure Monitor no portal do Azure.
Use a autenticação de aplicativo managed_identity
ou oauth
para o Microsoft Entra ID, dependendo da implementação. Remova o objeto que você não está usando.
Localize a ID do cliente para a identidade gerenciada usando o seguinte comando da CLI do Azure:
az identity list --resource-group <resource group name>
Para obter mais informações, confira az identity list.
Para localizar seu cliente para autenticação de identidade gerenciada no portal, acesse a página Identidades gerenciadas no portal do Azure e selecione o nome de identidade relevante. Copie o valor da ID do cliente da página de visão geral da identidade.
Para localizar a ID do cliente para o aplicativo Microsoft Entra ID, use a CLI a seguir ou veja a primeira etapa na seção Criar um aplicativo do Microsoft Entra ID usando o portal do Azure.
$ az ad app list --display-name < application name>
Para obter mais informações, confira az ad app list.
Observação
Depois de editar o arquivo de configuração, reinicie o Prometheus para que as alterações sejam aplicadas.
Verifique se os dados de gravação remota estão fluindo
Use os seguintes métodos para verificar se os dados do Prometheus estão sendo enviados ao workspace do Azure Monitor.
Gerenciador de métricas do Azure Monitor com PromQL
Para verificar se as métricas estão fluindo para o workspace do Azure Monitor, no workspace do Azure Monitor no portal do Azure, selecione Métricas. Use o gerenciador de métricas para consultar as métricas que você espera do ambiente do Prometheus autogerenciado. Para obter mais informações, confira Metrics Explorer.
Gerenciador do Prometheus no Workspace do Azure Monitor
O Prometheus Explorer fornece uma maneira conveniente de interagir com as métricas do Prometheus em seu ambiente do Azure, tornando o monitoramento e a solução de problemas mais eficientes. Para usar o Gerenciador do Prometheus, acesse o workspace do Azure Monitor no portal do Azure e selecione Prometheus Explorer para consultar as métricas que você espera do ambiente do Prometheus autogerenciado. Para obter mais informações, confira Prometheus Explorer.
Grafana
Use consultas PromQL no Grafana para verificar se os resultados retornam os dados esperados. Veja como configurar o Grafana com o Managed Prometheus para configurar o Grafana.
Solucionar problemas de gravação remota
Se os dados remotos não aparecerem no workspace do Azure Monitor, confira Solucionar problemas de gravação remota para ver problemas e soluções comuns.