Introdução ao Application Insights - Observabilidade do OpenTelemetry

O Azure Monitor Application Insights é um recurso do APM (monitoramento de desempenho de aplicativos) do Azure Monitor. Para cenários com suporte, você pode usar o OpenTelemetry (OTel), uma estrutura de observabilidade neutra do fornecedor, para instrumentar seus aplicativos e coletar dados de telemetria e, em seguida, analisar essa telemetria no Application Insights.

Experiências do Application Insights

O Application Insights dá suporte ao OpenTelemetry (OTel) para coletar dados de telemetria em um formato padronizado entre plataformas. A integração com os serviços do Azure permite monitoramento e diagnóstico eficientes, melhorando a observabilidade e o desempenho do aplicativo.

Investigar

Use essas ferramentas para diagnosticar problemas e entender o comportamento de runtime do aplicativo.

Painel de Aplicativo: uma avaliação rápida da saúde e do desempenho do aplicativo.
Mapa do aplicativo: uma visão geral visual das interações da arquitetura do aplicativo e dos componentes.
Métricas dinâmicas: um painel de análise em tempo real para obter informações sobre a atividade e o desempenho do aplicativo.
Exibição de pesquisa: rastreie e diagnostice transações para identificar problemas e otimizar o desempenho.
Exibição de disponibilidade: Monitoramento e teste proativo da disponibilidade e capacidade de resposta dos pontos terminais do aplicativo.
Exibição de falhas: identifique e analise falhas em seu aplicativo para minimizar o tempo de inatividade.
Exibição de desempenho: examine as métricas de desempenho do aplicativo e possíveis gargalos.
Detalhes dos agentes: uma visão unificada para monitorar agentes de IA no Microsoft Foundry, Copilot Studio e agentes de terceiros.

Monitoramento

Use essas ferramentas para acompanhar continuamente a integridade do aplicativo e configurar notificações proativas.

Alertas: monitore uma ampla variedade de aspectos do aplicativo e dispare várias ações.
Métricas: aprofunde-se nos dados de métricas para entender os padrões e tendências de uso.
Configurações de diagnóstico: configure a exportação contínua de logs e métricas da plataforma para o destino de sua escolha.
Logs: recupere, consolide e analise todos os dados coletados nos Logs de Monitoramento do Azure.
Workbooks: Crie relatórios interativos e painéis para visualizar dados de monitoramento de aplicativos.
Painéis com o Grafana: criar, personalizar e compartilhar painéis do Grafana para dados do Application Insights diretamente no portal do Azure.
Estatísticas do SDK: Visualize o sucesso dos exportadores, contagens de remoções, contagens de repetições e motivos de remoções dos SDKs e agentes do Application Insights.

Uso

Use essas ferramentas para entender como os usuários interagem com seu aplicativo.

Usuários, sessões e eventos: determine quando, onde e como os usuários interagem com seu aplicativo Web.
Funis: analise as taxas de conversão para identificar os pontos em que os usuários avançam ou saem no funil.
Fluxos: visualize os caminhos do usuário em seu site para identificar áreas de alta participação e pontos de saída.
Coortes: agrupe usuários por características compartilhadas para simplificar a identificação de tendências, a segmentação e a solução de problemas de desempenho.

Análise de código

Use essas ferramentas para criar o perfil e depurar o código do aplicativo.

.NET Profiler: capture, identifique e exiba rastreamentos de desempenho para seu aplicativo.
Otimizações de código: aproveite a IA para criar aplicativos melhores e mais eficientes.
Depurador de Instantâneos: coleta automaticamente instantâneos de depuração quando ocorrem exceções no aplicativo .NET

Modelo lógico

O diagrama do modelo lógico visualiza componentes do Application Insights e como eles interagem.

Observação

As configurações do firewall devem ser ajustadas para que os dados alcancem os pontos de entrada de ingestão. Para obter mais informações, consulte o acesso ao endpoint e a configuração do firewall do Azure Monitor.

Como começar

Esta seção aborda a introdução à coleta de dados baseada em OpenTelemetry no Azure Monitor Application Insights.

Os pontos de entrada incluem:

Aplicativos Web do lado do servidor
Aplicativos Web do lado do servidor hospedados em uma VM (Máquina Virtual)
Aplicativos JavaScript do lado do cliente
Azure Functions
Agentes de IA

Dica

Para a maioria dos cenários do lado do servidor baseados em código, a configuração recomendada usa a Distribuição OpenTelemetry do Azure Monitor.
Cenários em que o OpenTelemetry não está disponível são claramente identificados.

Escolha a aba que melhor corresponde à carga de trabalho ou ao modelo de hospedagem. Cada guia mostra o caminho de coleta de dados recomendado para esse cenário.

Configurar a coleta de dados

Utilize este caminho para aplicativos web lado servidor que você configura no código.

Crie um recurso do Application Insights.
Obtenha a cadeia de conexão do recurso.
Adicione o Azure Monitor OpenTelemetry Distro ao seu aplicativo.
Configure a cadeia de conexão.

Dica

Algumas plataformas habilitam a coleta de dados automaticamente por meio da instrumentação automática. Alterne para a instrumentação baseada em código com o Azure Monitor OpenTelemetry Distro se desejar mais opções de configuração e extensibilidade.

Use este caminho para Azure Functions. Comece com as configurações do aplicativo de funções e siga o artigo do Functions para as etapas específicas do idioma.

Ative o OpenTelemetry no arquivo host.json do aplicativo de funções configurando "telemetryMode": "OpenTelemetry".
Adicione a APPLICATIONINSIGHTS_CONNECTION_STRINGconfiguração do aplicativo usando sua cadeia de conexão do Application Insights.
Conclua a instrumentação específica do idioma e as configurações de trabalho necessárias no Use OpenTelemetry com Azure Functions.

Observação

Atualmente, não há suporte para OpenTelemetry para aplicativos em processo C#.

Use esse caminho para agentes de IA. Escolha a configuração que corresponde ao seu modelo de hospedagem.

Hospedagem gerenciada
- Fábrica de IA do Azure: Para agentes e fluxos de trabalho gerenciados pelo Foundry, comece com configuração de rastreamento no Foundry. Para instrumentação no lado do aplicativo, você também pode usar o Azure Monitor OpenTelemetry Distro com o Foundry SDK.
Hospedagem própria
- Microsoft Agent Framework: Se estiver criando um agente do zero e auto-hospedando, use o Microsoft Agent Framework para orquestrar seu agente e emitir telemetria para o Azure Monitor.
- Third-party agents: Se você tiver criado um agente em outro lugar, use o Azure AI OpenTelemetry Tracer para emitir telemetria para Azure Monitor. Esses agentes também podem ser registrados no Fábrica de IA do Azure. Para obter diretrizes específicas do framework, consulte Habilitar rastreamento para agentes criados no LangChain & LangGraph e Habilitar rastreamento para agentes criados no SDK de Agentes OpenAI.

Depois que a telemetria estiver fluindo, você estará pronto para explorar a exibição de detalhes do agente do Application Insights.

Se você optar por coletar informações completas do prompt, por exemplo, usando o EnableSensitiveData sinalizador no Agent Framework, poderá pesquisar por meio de prompts na visualização Pesquisa e revisar conversas, incluindo mensagens de assistente, prompts do sistema e uso de ferramentas, na visualização Detalhes da Transação.

Dê a cada agente um nome distinto para que você possa diferenciá-los na exibição de detalhes do Agente. Se os componentes agente fizerem parte de um aplicativo maior, considere enviá-los para um recurso existente do Application Insights.

Se você também quiser ver seus agentes no Fábrica de IA do Azure além de Azure Monitor, conectar um recurso do Application Insights ao seu projeto do Foundry.

Você também pode configurar avaliações destas maneiras:

Avaliações em lote
- Avaliações locais com o SDK de Avaliação de IA do Azure:Executar avaliações em seu computador de desenvolvimento durante o teste.
- avaliações na nuvem com o Foundry SDK: Execute as avaliações em Azure para conjuntos de dados maiores ou colaboração em equipe.
- Avaliações baseadas no portal do Foundry:use o portal do Foundry para fluxos de trabalho de avaliação sem código.
Avaliações contínuas:configurar avaliações automatizadas que são executadas no tráfego de produção para detectar regressões de qualidade.

Depois de concluir a configuração do seu cenário, execute seu aplicativo e aguarde alguns minutos para que a telemetria apareça no Application Insights. Em seguida, explore as experiências do Application Insights.

Importante

Se você estiver migrando de SDKs mais antigos do Application Insights, consulte Migrate para Azure Monitor OpenTelemetry.

Outras integrações do OpenTelemetry no Azure

Azure Monitor Application Insights integra-se a outros serviços Azure que usam o OpenTelemetry. Use os seguintes recursos para serviços do Azure, kits de desenvolvimento de software (SDKs) e ferramentas que usam o OpenTelemetry:

Integration	Descrição
Convenções semânticas do SDK do Azure	Convenções de nomenclatura de atributos do OpenTelemetry usadas em todos os SDKs do Azure.
Rastreamento em Java no SDK do Azure	Suporte de rastreamento distribuído para SDK do Azure para clientes Java.
Observabilidade do SDK do Azure Cosmos DB	Rastros e métricas do OpenTelemetry emitidos pelo SDK do Azure Cosmos DB.
.NET observabilidade com OpenTelemetry	Diretrizes de instrumentação OpenTelemetry para aplicativos .NET.
Pipeline do Azure Monitor na borda e em multinuvem	Colete e encaminhe dados do OpenTelemetry de ambientes de borda e multinuvem para o Azure Monitor.
Ingestão de OpenTelemetry no Azure Data Explorer	Ingerir dados do OpenTelemetry no Azure Data Explorer, no Synapse Data Explorer e no Real-Time Intelligence.
Agente OpenTelemetry para Aplicativos de Contêiner do Azure	Agente OpenTelemetry integrado para Aplicativos de Contêiner do Azure.
Painel do Aspire	Painel de desenvolvimento local para visualizar rastreamentos e métricas do OpenTelemetry de aplicativos .NET Aspire.

Resolução de problemas

Para obter assistência com a solução de problemas do Application Insights, consulte nossa documentação dedicada de solução de problemas.

Ajuda e suporte

Suporte técnico 24 horas por dia, 7 dias por semana.

Se você tiver problemas com o Suporte do Azure, abra um tíquete de suporte do Azure.

Perguntas Gerais

Publique perguntas gerais no fórum Perguntas e Respostas da Microsoft.

Perguntas de codificação

Poste perguntas de codificação no Stack Overflow usando uma marcação azure-application-insights.

Comentários da Comunidade

Deixe comentários sobre o produto para a equipe de engenharia nos Comentários da Comunidade.

Comentários

Esta página foi útil?

Last updated on 2026-05-19