Compartilhar via

Consultar métricas do Prometheus usando pastas de trabalho do Azure

Crie painéis alimentados pelo serviço gerenciado do Azure Monitor para Prometheus usando pastas de trabalho do Azure. Este artigo apresenta pastas de trabalho para workspaces do Azure Monitor e mostra como consultar métricas do Prometheus usando pastas de trabalho do Azure e Prometheus Query Language (PromQL).

Você também pode consultar as métricas do Prometheus usando o PromQL no gerenciador de métricas em um workspace do Azure Monitor. Para obter mais informações, consulte o gerenciador de métricas do Azure Monitor com o PromQL (versão prévia).

Pré-requisitos

Para consultar métricas do Prometheus em um espaço de trabalho do Azure Monitor:

Pasta de trabalho do Explorador do Prometheus

Os workspaces do Azure Monitor incluem uma pasta de trabalho de exploração para consultar suas métricas do Prometheus.

  1. Na página Visão geral do workspace do Azure Monitor, selecione Explorador do Prometheus.

    Captura de tela que mostra a seleção do menu do workspace do Azure Monitor.

  2. No item de menu Pastas de Trabalho e na galeria de espaços de trabalho do Azure Monitor, selecione o bloco da pasta de trabalho Explorador do Prometheus.

    Captura de tela que mostra a galeria de workspaces do Azure Monitor.

    Uma pasta de trabalho tem as seguintes opções de entrada:

    • Intervalo de Tempo: selecione o período de tempo que você deseja incluir em sua consulta. Selecione Personalizado para definir uma hora de início e de término.
    • PromQL: insira a consulta PromQL para recuperar seus dados. Para obter mais informações sobre o PromQL, consulte Query Prometheus.
    • Grafo, Grade, Dimensões: use as guias para alternar entre uma exibição gráfica, tabular e dimensional da saída da consulta.

    Captura de tela que mostra o Gerenciador do PromQL.

Criar uma pasta de trabalho do Prometheus

As pastas de trabalho dão suporte a muitas visualizações e integrações do Azure. Para obter mais informações sobre pastas de trabalho do Azure, consulte Criar uma pasta de trabalho do Azure.

  1. No seu workspace do Azure Monitor, selecione Pastas de Trabalho.

  2. Selecione Novo.

  3. Na nova pasta de trabalho, selecione Adicionar e, em seguida, selecione Adicionar consulta na lista suspensa.

    Captura de tela que mostra a lista suspensa Adicionar em um espaço de trabalho em branco.

  4. As pastas de trabalho do Azure usam fontes de dados para definir o escopo de origem dos dados apresentados. Para consultar as métricas do Prometheus, selecione a lista suspensa Fonte de dados e escolha Prometheus .

  5. Na lista suspensa Espaço de trabalho do Azure Monitor, selecione seu espaço de trabalho.

  6. Na lista suspensa do tipo de consulta Prometheus, selecione o tipo de consulta.

  7. Insira sua consulta PromQL no campo Consulta prometheus (versão prévia ).

  8. Selecione Executar Consulta.

  9. Selecione Edição Concluída e salve seu trabalho.

    Captura de tela que mostra uma consulta PromQL de exemplo.

Resolução de problemas

Se você receber a mensagem "No momento, você não tem dados do Prometheus carregados neste workspace do Azure Monitor", segue o procedimento:

  • Verifique se você ativou a coleção de métricas no painel clusters monitorados do workspace do Azure Monitor.

Se a consulta da pasta de trabalho não retornar dados e retornar com a mensagem "Você não tem acesso à consulta", então:

  • Verifique se você tem permissões suficientes para executar microsoft.monitor/accounts/read atribuídas por meio da opção de controle de acesso (IAM) no workspace do Azure Monitor.
  • Confirme se as configurações de rede dão suporte ao acesso à consulta. Talvez seja necessário habilitar o acesso privado através do seu ponto de extremidade privado ou alterar as configurações para permitir o acesso público.
  • Verifique se você tem um bloqueador de anúncios habilitado no navegador. Se você fizer isso, talvez seja necessário pausar ou desabilitar e atualizar a pasta de trabalho para exibir dados.

Perguntas frequentes

Esta seção fornece respostas para perguntas comuns.

Estou perdendo todas ou algumas das minhas métricas. Como posso solucionar problemas?

Use o guia de solução de problemas para saber como ingerir métricas do Prometheus do agente gerenciado.

Por que faltam métricas que têm dois rótulos com o mesmo nome, mas com maiúsculas e minúsculas diferentes?

O Azure Managed Prometheus é um sistema que não diferencia maiúsculas de minúsculas. Ele trata as cadeias de caracteres, como nomes de métricas, nomes de rótulos ou valores de rótulos, como a mesma série temporal se elas diferirem de outra série temporal apenas pelo caso da cadeia de caracteres. Para obter mais informações, consulte Visão geral das métricas do Prometheus.

Vejo algumas lacunas nos dados de métrica. Por que esse comportamento está ocorrendo?

Durante as atualizações de nó, você pode ver uma lacuna de um a dois minutos nos dados de métrica das métricas coletadas de nossos coletores de nível de cluster. Essa lacuna ocorre porque o nó em que os dados são executados está sendo atualizado como parte de um processo normal de atualização. Esse processo de atualização afeta destinos em todo o cluster, como kube-state-metrics e destinos de aplicativos personalizados especificados. Esse processo ocorre quando o cluster é atualizado manualmente ou por meio da atualização automática.

Esse comportamento é esperado e não afeta nenhuma das nossas regras de alerta recomendadas.

Conteúdo relacionado

  • Last updated on