Alternar para usar visualizações gerenciadas do Prometheus para os Insights do Contêiner (versão prévia)

No momento, os Insights do Contêiner usa dados do Log Analytics para alimentar as visualizações no portal do Azure. No entanto, com o lançamento do Prometheus gerenciado, esse novo formato de coleta de métricas é mais barato e eficiente. Os Insights do Contêiner agora oferecem a capacidade de visualizar usando apenas dados gerenciados do Prometheus. Este artigo ajuda você com a configuração para começar a usar o Prometheus gerenciado como sua principal ferramenta de visualização dos Insights do Contêiner.

Observação

Esse recurso está atualmente em visualização pública. Para obter informações adicionais, leia os Termos de Uso Complementares para Visualizações do Microsoft Azure.

Pré-requisitos

Para exibir seus dados dos Insights do Contêiner usando o Prometheus, verifique se as etapas a seguir estão concluídas.

• AKS (Serviço de Kubernetes do Azure) configurado com o Prometheus gerenciado
• O usuário tem permissão Reader ou superior no workspace do Azure Monitor associado
• O bloco de anúncios está desabilitado ou definido para permitir o tráfego do monitor.azure.com
• Para clusters do Windows, habilite a coleção de métricas do Windows

Acessando os Insights do Contêiner baseados no Prometheus

Como o Azure Monitor dá suporte a vários níveis de personalização, o cluster pode ter logs baseados no Conteiner Insights, Prometheus gerenciado ou alguma outra combinação.

Observação

As visualizações gerenciadas do Prometheus para os Insights do Contêiner usam regras de gravação para melhorar o desempenho do gráfico, saiba mais sobre quais regras estão configuradas.

Nenhum Prometheus ou Insights de Contêiner baseado em Logs habilitado

1. Abra o portal do Azure e navegue até o cluster do AKS desejado.

2. Escolha o item de menu Insights no menu, exibindo uma tela inicial indicando que não há monitoramento habilitado.

3. Selecione o botão Configure monitoring para abrir a folha de configuração de monitoramento.

4. Abaixo da folha de configurações avançadas, escolha Logs and events na lista suspensa Predefinições de custo.

5. Para concluir a configuração, clique no botão Configure.

6. Depois que a implantação de integração for concluída, você poderá ver a experiência do Insights usando o Prometheus como a fonte de dados, indicada pela lista suspensa da barra de ferramentas que mostra Managed Prometheus visualizations (Preview).

Insights de Contêiner baseados em logs habilitados

1. Abra o portal do Azure e navegue até o cluster do AKS desejado.

2. Escolha o item de menu Insights no menu, que exibe uma faixa na parte superior para configurar o Prometheus gerenciado.

3. Usando a faixa, selecione o botão Configure para concluir a integração e gerenciar o Prometheus ou implantar as regras de gravação necessárias.

Se o banner tiver sido descartado anteriormente, você poderá usar a lista suspensa na barra de ferramentas que diz Log Analytics visualizations (Classic)e selecionar a opção Managed Prometheus visualizations (Preview), que abre um pop-up para concluir a integração.

4. Depois que a implantação de monitoramento for concluída, a folha do Insights deverá mudar para usar o Prometheus como a fonte de dados, indicada pela lista suspensa da barra de ferramentas que mostra Managed Prometheus visualizations (Preview).

Prometheus habilitado e logs baseados em Insights de Contêiner não habilitados ou com configurações personalizadas aplicadas

1. Abra o portal do Azure e navegue até o cluster do AKS desejado.

2. Escolha o item de menu Insights no menu, que exibe uma faixa para habilitar as regras de gravação do Prometheus.

3. Clique Enable para implantar as regras de gravação.

4. Depois que a implantação de monitoramento for concluída, a folha do Insights deverá mudar para usar o Prometheus como a fonte de dados, indicada pela lista suspensa da barra de ferramentas que mostra Managed Prometheus visualizations (Preview).

Observação

Alguns gráficos só terão dados parciais para o intervalo de tempo padrão até que o tempo suficiente tenha decorrido para que as regras de gravação coletem dados.

Etapas opcionais

Embora as etapas acima sejam suficientes, para a experiência de visualização completa, algumas etapas opcionais podem ser concluídas.

Coleção de rótulos de nó e pod

Por padrão, os rótulos para nós e pods não estão disponíveis, mas podem ser coletados por meio da reabilitação do complemento. Rótulos de nó são necessários para filtrar dados por pools de nós.

1. Se o suplemento do Prometheus gerenciado estiver implantado no momento, devemos desabilitá-lo primeiro

az aks update --disable-azure-monitor-metrics -n <clusterName> -g <resourceGroup>

2. Em seguida, habilite novamente o complemento com o sinalizador --ksm-metric-labels-allow-list

az aks update -n <clusterName> -g <resourceGroup> --enable-azure-monitor-metrics --ksm-metric-labels-allow-list "nodes=[*], pods=[*]" --azure-monitor-workspace-resource-id <amw-id

Coleta de dados do Log Analytics

Se você estiver usando atualmente a experiência dos Insights do Contêiner baseada em logs, poderá optar por parar de ingerir métricas no Log Analytics para economizar na cobrança. Depois de confirmar que a experiência do Insights de Contêiner com suporte do Prometheus é suficiente para suas finalidades, conclua as etapas para interromper a ingestão de métricas no Log Analytics.

1. Navegue até as configurações de monitoramento para seus clusters seguindo as instruções sobre como configurar sua regra de coleta de dados dos Insights do Contêiner

2. Na lista suspensa Predefinições de custo, selecione "Logs e Eventos" e salve para configurar.

Observação

Desabilitar as métricas do Log Analytics também desabilita a lista suspensa de visualização na barra de ferramentas. Reverta para usar uma das predefinições de custo padrão na folha Monitoring Settings e habilitar novamente as visualizações do Log Analytics.

Limitações e problemas conhecidos

Como esse recurso está atualmente em versão prévia, há várias limitações conhecidas, não há suporte para os seguintes recursos

• Detalhes da variável de ambiente
• Filtrando dados por serviços individuais
• Exibição de dados ao vivo na guia Cluster
• Pastas de trabalho relatam dados
• Conjunto de trabalho de memória do nó e métricas RSS
• Dados parciais ou não disponíveis na exibição de vários clusters com base nas configurações de DCR dos Insights do Contêiner

Solução de problemas

Ao usar a experiência do Insights de Contêiner baseado em Prometheus, você pode encontrar os erros a seguir.

Os gráficos estão presos em um estado de carregamento

Esse problema ocorrerá se o tráfego de rede do workspace do Azure Monitor estiver bloqueado. A causa raiz disso normalmente está relacionada a políticas de rede, como o software de bloqueio de anúncios. Para resolver esse problema, desabilite o tráfego do bloco de anúncios ou da lista de permissões monitor.azure.com e recarregue a página.

Não é possível acessar a Regra de Coleta de Dados

Esse erro ocorre quando o usuário não tem permissões para exibir a regra de coleta de dados do Prometheus associada ao cluster ou a regra de coleta de dados pode ter sido excluída. Para resolver esse erro, conceda acesso à regra de coleta de dados do Prometheus ou reconfigure o Prometheus gerenciado usando o botão Monitoring Settings na barra de ferramentas.

Não é possível acessar o workspace do Azure Monitor

Esse erro ocorre quando o usuário não tem permissões para exibir o workspace do Azure Monitor associado ao cluster ou o workspace do Azure Monitor pode ter sido excluído. Para resolver esse erro, conceda acesso ao workspace do Azure Monitor ou reconfigure o Prometheus gerenciado excluindo e reimplantando o complemento.

Os dados não puderam ser recuperados

Esse erro normalmente ocorre ao consultar grandes volumes de dados e pode ser resolvido reduzindo o intervalo de tempo para uma janela mais curta ou filtrando para menos objetos.

Erro de configuração de dados

Esse erro ocorre quando as regras de gravação podem ter sido modificadas ou excluídas. Use o botão Reconfigure para corrigir as regras de gravação e tente novamente.

Acesso negado

Isso ocorre quando o token do portal do usuário expira ou não tem permissões para exibir o workspace do Azure Monitor associado ao cluster. Isso normalmente pode ser resolvido atualizando a sessão do navegador ou fazendo logon novamente.

Ocorreu um erro desconhecido

Se essa mensagem de erro persistir, entre em contato com o suporte para abrir um tíquete.