Introdução ao Application Insights - Observabilidade OpenTelemetry

O Azure Monitor Application Insights é uma funcionalidade de monitorização do desempenho de aplicações (APM) do Azure Monitor. Para cenários suportados, pode usar o OpenTelemetry (OTel), um framework de observabilidade neutro em relação ao fornecedor, para instrumentar as suas aplicações e recolher dados de telemetria, depois analisar essa telemetria no Application Insights.

Experiências do Application Insights

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

Investigar

Use estas ferramentas para diagnosticar problemas e compreender o comportamento em tempo de execução da sua aplicação.

Painel do aplicativo: uma avaliação rápida da integridade e do desempenho do seu aplicativo.
Mapa de aplicativos: uma visão geral visual da arquitetura do aplicativo e das interações dos componentes.
Métricas em tempo real: um painel de análise em tempo real para obter informações sobre a atividade e o desempenho do aplicativo.
Vista de pesquisa: Rastrear e diagnosticar transações para identificar problemas e otimizar o desempenho.
Visualização de disponibilidade: monitore e teste proativamente a disponibilidade e a capacidade de resposta dos pontos de extremidade do aplicativo.
Visualização de falhas: identifique e analise falhas em seu aplicativo para minimizar o tempo de inatividade.
Visão de desempenho: analise as métricas de desempenho do aplicativo e possíveis gargalos.
Detalhes dos agentes: Uma visão unificada para monitorizar agentes de IA na Microsoft Foundry, Copilot Studio e agentes de terceiros.

Monitorização

Use estas ferramentas para monitorizar continuamente a saúde da sua aplicação e configurar notificações proativas.

Alertas: monitore uma ampla gama de aspetos do seu aplicativo e acione várias ações.
Métricas: aprofunde-se nos dados de métricas para entender 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 recolhidos em Azure Registos de Monitorização.
Workbooks: Crie relatórios e painéis interativos que visualizem dados de monitorização de aplicações.
Dashboards com Grafana: Crie, personalize e partilhe dashboards Grafana para dados Application Insights diretamente no portal Azure.
Estatísticas do SDK: Explore o sucesso do exportador, contagens de dados rejeitados, contagens de tentativas e razões de rejeição nos SDKs e agentes do Application Insights.

Utilização

Use estas ferramentas para compreender como os utilizadores interagem com a sua aplicação.

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 onde os utilizadores avançam ou desistem no funil.
Fluxos: Visualize os caminhos do usuário em seu site para identificar áreas de alto engajamento 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 estas ferramentas para perfilar e depurar o código da sua aplicação.

.NET Profiler: Capture, identifique e visualize os traços de desempenho da sua aplicação.
Otimizações de código: aproveite a IA para criar aplicativos melhores e mais eficientes.
Snapshot Debugger: Recolhe automaticamente imagens de depuração quando surgem exceções na aplicação .NET

Modelo lógico

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

Nota

As configurações do firewall precisam ser ajustadas para que os dados atinjam os pontos finais de ingestão de dados. Para mais informações, consulte acesso ao ponto final do Azure Monitor e a configuração do firewall.

Como Começar

Esta secção aborda o início da recolha de dados baseada em OpenTelemetry no Azure Monitor Application Insights.

Os pontos de entrada incluem:

Aplicações web do lado do servidor
Aplicações web do lado do servidor alojadas numa Máquina Virtual (VM)
Aplicações JavaScript do lado do cliente
Funções do Azure
Agentes de IA

Sugestão

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

Escolha o separador que melhor se adequa à sua carga de trabalho ou modelo de alojamento. Cada separador mostra o caminho recomendado para a recolha de dados nesse cenário.

Configurar a recolha de dados

Use este caminho para aplicações web do lado do servidor que você instrumenta no código.

Crie um recurso de Application Insights.
Obtenha a cadeia de conexão do recurso.
Adiciona a distribuição Azure Monitor OpenTelemetry à tua aplicação.
Configura a cadeia de ligação.

Sugestão

Algumas plataformas permitem a recolha automática de dados através de instrumentação automática. Mude para instrumentação baseada em código com a Azure Monitor OpenTelemetry Distro se quiser mais opções de configuração e extensibilidade.

Use este caminho para Funções do Azure. Comece pelas definições da aplicação de funções e depois siga o artigo Funções para os passos específicos da língua.

Ative o OpenTelemetry na sua aplicação de funções no ficheiro host.json definindo "telemetryMode": "OpenTelemetry".
Adicione a APPLICATIONINSIGHTS_CONNECTION_STRINGconfiguração da aplicação usando a sua cadeia de conexão do Application Insights.
Conclua a instrumentação específica da linguagem e quaisquer configurações do trabalhador necessárias em Use OpenTelemetry com Funções do Azure.

Nota

O OpenTelemetry não é atualmente suportado para aplicações C# em processo.

Use este caminho para agentes de IA. Escolha a configuração que corresponda ao seu modelo de alojamento.

Hospedagem gerenciada
- Azure AI Foundry: Para agentes e fluxos de trabalho geridos pela Foundry, comece com a configuração tracing no Foundry. Para instrumentação do lado da aplicação, também pode usar a Azure Monitor OpenTelemetry Distro com o SDK Foundry.
Hospedagem própria
- Microsoft Agent Framework: Se está a construir um agente do zero e a fazer auto-hospedagem, use o Microsoft Agent Framework para orquestrar o seu agente e emitir telemetria ao Azure Monitor.
- Agentes terceiros: Se construiu um agente noutro local, use o Azure AI OpenTelemetry Tracer para emitir telemetria para Azure Monitor. Estes agentes também podem ser registados no Azure AI Foundry. Para orientações específicas do framework, consulte Permitir o rastreamento para agentes construídos em LangChain & LangGraph e Permitir o rastreamento para agentes construídos no OpenAI Agents SDK.

Depois de a telemetria começar a fluir, está pronto para explorar a vista detalhada do agente do Application Insights.

Se optar por recolher informação detalhada sobre os prompts, por exemplo, usando o indicador EnableSensitiveData no Agent Framework, pode pesquisar por prompts na visualização Pesquisa e rever conversas, incluindo mensagens do assistente, prompts do sistema e utilização de ferramentas, na visualização Detalhes da Transação.

Dê a cada agente um nome distinto para os distinguir na vista de detalhes do agente. Se os seus componentes agenticos fazem parte de uma aplicação maior, considere enviá-los para um recurso existente do Application Insights.

Se também quiser ver os seus agentes em Azure AI Foundry além de Azure Monitor, liga um recurso de Insights de Aplicação ao teu projeto Foundry.

Também pode configurar avaliações da seguinte forma:

Avaliações em lote
- Avaliações locais com o SDK de Avaliação de IA do Azure:Execute avaliações em sua máquina de desenvolvimento durante o teste.
- Avaliações Cloud com o SDK Foundry:Realizar avaliações na Azure para conjuntos de dados maiores ou para colaboração em equipe.
- Avaliações baseadas em portais da Foundry:Use o portal da Foundry para fluxos de trabalho de avaliação sem código.
Avaliações contínuas:Configure avaliações automatizadas que são executadas em relação ao tráfego de produção para detetar regressões de qualidade.

Depois de concluir a configuração do seu cenário, execute a sua aplicação e espere alguns minutos até que a telemetria apareça no Application Insights. Depois, explore experiências com o Application Insights.

Importante

Se estiver a migrar a partir de SDKs antigos do Application Insights, veja Migrar para Azure Monitor OpenTelemetry.

Outras integrações OpenTelemetry no Azure

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

Integration	Description
Convenções semânticas do SDK do Azure	Convenções de nomenclatura de atributos OpenTelemetry usadas em todos os SDKs do Azure.
Traçado Java no SDK do Azure	Suporte de traçado distribuído para SDK do Azure para clientes Java.
Observabilidade do SDK do Azure Cosmos DB	Rastreios e métricas do OpenTelemetry emitidos pelo SDK do Azure Cosmos DB.
.NET observabilidade com OpenTelemetry	Orientação de instrumentação OpenTelemetry para aplicações .NET.
Pipeline do Azure Monitor na periferia e em multinuvem	Recolha e encaminhe dados da OpenTelemetry de ambientes edge e multicloud para o Azure Monitor.
Ingestão do OpenTelemetry no Azure Data Explorer	Ingerir dados do OpenTelemetry no Azure Data Explorer, Synapse Data Explorer e Real-Time Intelligence.
Azure Container Apps OpenTelemetry agent	Agente OpenTelemetry incorporado para o Azure Container Apps.
Painel de instrumentos Aspire	Painel de desenvolvimento local para visualizar rastreios e métricas do OpenTelemetry das aplicações .NET Aspire.

Solução de problemas

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

Ajuda e suporte

Suporte técnico do Azure

Para questões de suporte do Azure, abra um ticket de suporte do Azure.

Perguntas Gerais

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

Perguntas sobre codificação

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

Comunidade de comentários

Deixe comentários sobre o produto para a equipe de engenharia na Comunidade de feedback.

Comentários

Esta página foi útil?

Last updated on 2026-05-19