Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use métricas dinâmicas do Application Insights para monitorar aplicativos Web. Selecione e filtre métricas e contadores de desempenho para observar em tempo real e inspecionar rastreamentos de pilha de solicitações e exceções com falha de exemplo. A experiência de métricas dinâmicas é uma ferramenta de diagnóstico poderosa quando combinada com o .NET Profiler e o Depurador de Instantâneos.
Com métricas dinâmicas, você pode:
- Valide uma correção enquanto ela é liberada, observando o desempenho e as contagens de falhas.
- Observe o efeito de cargas de teste e diagnostique problemas em tempo real.
- Concentre-se em sessões de teste específicas ou filtre os problemas conhecidos, selecionando e filtrando as métricas que deseja inspecionar.
- Obter rastreamentos de exceção quando eles ocorrerem.
- Experimente os filtros para localizar os KPIs mais relevantes.
- Monitore qualquer contador de desempenho do Windows em tempo real.
- Identifique com facilidade um servidor que está com problemas e filtre todo o KPI/feed em tempo real apenas desse servidor.
Introdução
- Habilite as métricas dinâmicas seguindo as diretrizes específicas do idioma:
- ASP.NET: sem suporte.
- ASP.NET Core: habilitado por padrão.
- Java: habilitado por padrão.
- Node.js: habilitado por padrão.
-
Python: passe
enable_live_metrics=Trueparaconfigure_azure_monitor. Consulte a documentação do Azure Monitor OpenTelemetry Distro para obter mais informações.
Abra o recurso Application Insights para o seu aplicativo no portal do Azure. Selecione as Métricas dinâmicas, que estão listadas em Investigar no menu à esquerda.
Proteja o canal de controle habilitando a Autenticação do Microsoft Entra, se você usar filtros personalizados.
Observação
Em 31 de março de 2025, o suporte à ingestão de chave de instrumentação foi encerrado. A ingestão de chave de instrumentação continuará funcionando, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar as novas funcionalidades.
Como as métricas dinâmicas diferem do Metrics Explorer e do Log Analytics?
| Capacidades | Live Stream | Metrics Explorer e Log Analytics |
|---|---|---|
| Latência | Dados exibidos em um segundo. | Agregados em minutos. |
| Nenhuma retenção | Os dados persistem enquanto estão no gráfico e depois são descartados. | Dados retidos por 90 dias. |
| Sob demanda | Os dados são transmitidos apenas enquanto o painel de métricas dinâmicas está aberto. | Os dados são enviados sempre que o SDK está instalado e habilitado. |
| Gratuito | Não há custo para dados do Live Stream. | Sujeito a preços. |
| Amostragem | Todas as métricas e os contadores selecionados são transmitidos. Há amostras de falhas e rastreamentos de pilha. | Os eventos podem ser amostrados. |
| Canal de controle | Os sinais de controle de filtro são enviados ao SDK. Recomendamos que você proteja este canal. | A comunicação é unidirecional com o portal. |
Selecionar e filtrar suas métricas
Essas funcionalidades estão disponíveis com ASP.NET, ASP.NET Core e Azure Functions (v2).
Você pode monitorar os indicadores de desempenho personalizados ao vivo, aplicando filtros arbitrários a qualquer telemetria do Application Insights no portal. Selecione o controle de filtro que é mostrado quando você passa o mouse sobre qualquer um dos gráficos. O gráfico a seguir plota um KPI personalizado de contagem de solicitações com filtros nos atributos de URL e Duração. Valide os filtros com a seção de pré-visualização do fluxo, que mostra um feed em tempo real da telemetria que corresponde aos critérios que você especificou a qualquer momento.
Você pode monitorar um valor diferente de Contagem. As opções dependem do tipo de fluxo, que poderia ser qualquer telemetria do Application Insights, como solicitações, dependências, exceções, rastreamentos, eventos ou métricas. A telemetria também pode ser sua própria medida personalizada.
Junto com a telemetria do Application Insights, você também pode monitorar qualquer contador de desempenho do Windows. Selecione-o nas opções de fluxo e forneça o nome do contador de desempenho.
As métricas dinâmicas são agregadas em dois pontos: localmente em cada servidor e em todos os servidores. Você pode alterar o padrão dos dois selecionando outras opções nas respectivas listas suspensas.
Telemetria de exemplo: eventos de diagnóstico em tempo real personalizados
Por padrão, o feed de eventos em tempo real mostra exemplos de solicitações com falha e chamadas de dependência, exceções, eventos e rastreamentos. Selecione o ícone do filtro para ver os critérios aplicados em qualquer ponto no tempo.
Assim como acontece com as métricas, você pode especificar qualquer critério arbitrário para qualquer um dos tipos de Application Insights Telemetry. Neste exemplo, estamos selecionando falhas de solicitações específicas e eventos.
Observação
No momento, para critérios baseados em mensagens de exceção, use a mensagem de exceção mais externa. No exemplo anterior, para filtrar a exceção benigna com a mensagem de exceção interna (após o delimitador "<--") "O cliente se desconectou", use um critério de que a mensagem não contém "Erro ao ler o conteúdo da solicitação".
Veja os detalhes de um item no feed em tempo real clicando nele. Você pode pausar o feed clicando em Pausar ou simplesmente rolando para baixo e clicando em um item. A transmissão ao vivo será retomada quando você rolar de volta para o topo ou selecionar o contador de itens coletados durante a pausa.
Filtrar por instância do servidor
Se você quiser monitorar uma instância de função de servidor específico, filtre por servidor. Para filtrar os resultados, selecione o nome do servidor em Servidores.
Proteger o canal de controle
Proteja o canal de controle de métricas dinâmicas habilitando a Autenticação do Microsoft Entra, que impede a divulgação não autorizada de informações potencialmente confidenciais inseridas em filtros personalizados.
Observação
Em 30 de setembro de 2025, as chaves de API usadas para transmitir a telemetria do Live Metrics para o Application Insights serão desativadas. Após essa data, os aplicativos que usam chaves de API não poderão enviar dados de métricas dinâmicas para o recurso do Application Insights. A ingestão de telemetria autenticada para transmissão de métricas ao vivo para o Application Insights precisará ser feita com a autenticação do Microsoft Entra para o Application Insights.
Tabela de recursos com suporte
| Linguagem | Métricas básicas | Métricas de desempenho | Filtragem personalizada | Exemplo de telemetria | Divisão de CPU por processo |
|---|---|---|---|---|---|
| .NET Framework | Com suporte (LTS) | Com suporte (LTS) | Com suporte (LTS) | Com suporte (LTS) | Com suporte (LTS) |
| .NET Core (destino = .NET Framework) | Com suporte (LTS) | Com suporte (LTS) | Com suporte (LTS) | Com suporte (LTS) | Com suporte (LTS) |
| .NET Core (destino = .NET Core) | Com suporte (LTS) | Com suporte* | Com suporte (LTS) | Com suporte (LTS) | Sem suporte |
| Azure Functions v2 | Com suporte | Com suporte | Com suporte | Com suporte | Sem suporte |
| Java | Com suporte (V2.0.0 e superior) | Com suporte (V2.0.0 e superior) | Sem suporte | Com suporte (V3.2.0+) | Sem suporte |
| Node.js | Com suporte (V1.3.0 e superior) | Com suporte (V1.3.0 e superior) | Sem suporte | Com suporte (V1.3.0 e superior) | Sem suporte |
| Python | Com suporte (Distro versão 1.6.0+) | Sem suporte | Sem suporte | Sem suporte | Sem suporte |
As métricas básicas incluem solicitação, dependência e taxa de exceção. As métricas de desempenho (contadores de desempenho) incluem memória e CPU. O exemplo de telemetria mostra um fluxo de informações detalhadas para solicitações e dependências com falha, exceções, eventos e rastreamentos.
O suporte a PerfCounters varia um pouco entre as versões do .NET Core que não são direcionadas ao .NET Framework:
- Há suporte para métricas de PerfCounters em execuções no Serviço de Aplicativo do Azure para Windows (SDK do ASP.NET Core versão 2.4.1 ou superior).
- PerfCounters têm suporte quando o aplicativo está sendo executado em qualquer computador do Windows para aplicativos direcionados ao .NET Core LTS ou superior.
- Há suporte para PerfCounters quando o aplicativo é executado em qualquer lugar (como Linux, Windows, Serviço de Aplicativo para Linux ou contêineres) nas últimas versões, mas somente para aplicativos direcionados ao .NET Core LTS ou posterior.
Solução de problemas
Confira o artigo de solução de problemas dedicado.