Habilitar o monitoramento de aplicativos no Serviço de Aplicativo do Azure para aplicativos .NET, Node.js, Python e Java
Artigo
A autoinstrumentação, também conhecida como monitoramento de runtime, é a maneira mais fácil de habilitar o Application Insights para o Serviço de Aplicativo do Azure sem a necessidade de alterações de código ou configurações avançadas. Com base em seu cenário específico, avalie se o monitoramento mais avançado por meio de instrumentação manual é necessário.
Observação
Em 31 de março de 31, 2025, o suporte à ingestão de chave de instrumentação será 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.
Se o monitoramento de instrumentação automática e a instrumentação baseada em SDK manual forem detectados, somente as configurações de instrumentação manual serão respeitadas. Essa disposição impede que dados duplicados sejam enviados. Para saber mais, confira Solução de problemas.
Selecione Application Insights no menu de navegação à esquerda do serviço de aplicativo e selecione Habilitar.
Crie um recurso ou selecione um recurso do Application Insights existente para o aplicativo.
Observação
Ao selecionar OK para criar um recurso, você será solicitado a Aplicar configurações de monitoramento. A opção Continuar vincula seu novo recurso do Application Insights ao serviço de aplicativo. Em seguida, o serviço de aplicativo é reiniciado.
Depois de especificar qual recurso usar, você poderá escolher como deseja que o Application Insights colete dados por plataforma para seu aplicativo. As opções de coleção do ASP.NET Core são Recomendado ou Desabilitado.
Importante
Se o monitoramento de instrumentação automática e a instrumentação baseada em SDK manual forem detectados, somente as configurações de instrumentação manual serão respeitadas. Essa disposição impede que dados duplicados sejam enviados. Para saber mais, confira Solução de problemas.
Observação
Não há suporte à combinação de APPINSIGHTS_JAVASCRIPT_ENABLED e urlCompression. Para saber mais, consulte a Solução de problemas.
Autoinstrumentação no portal do Azure
Selecione Application Insights no menu de navegação à esquerda do serviço de aplicativo e selecione Habilitar.
Crie um recurso ou selecione um recurso do Application Insights existente para o aplicativo.
Observação
Ao selecionar OK para criar um recurso, você será solicitado a Aplicar configurações de monitoramento. A opção Continuar vincula seu novo recurso do Application Insights ao serviço de aplicativo. Em seguida, o serviço de aplicativo é reiniciado.
Depois de especificar qual recurso usar, você poderá escolher como deseja que o Application Insights colete dados por plataforma para seu aplicativo. O monitoramento de aplicativos ASP.NET é ativado por padrão com dois níveis diferentes de coleção, Recomendado e Básico.
A tabela a seguir resume os dados coletados para cada rota.
Dados
Recomendadas
Basic
Adiciona as tendências de uso de CPU, memória e E/S
Sim
Não
Coleta as tendências de uso e permite a correlação entre resultados de disponibilidade e transações
Sim
Sim
Coleta as exceções não tratadas pelo processo de host
Sim
Sim
Aumenta a precisão de métricas de APM com carga quando a amostragem é usada
Sim
Sim
Correlaciona microsserviços entre limites de solicitação/dependência
Selecione Application Insights no menu de navegação à esquerda do serviço de aplicativo e selecione Habilitar.
Crie um recurso ou selecione um recurso do Application Insights existente para o aplicativo.
Observação
Ao selecionar OK para criar um recurso, você será solicitado a Aplicar configurações de monitoramento. A opção Continuar vincula seu novo recurso do Application Insights ao serviço de aplicativo. Em seguida, o serviço de aplicativo é reiniciado.
Importante
Se o monitoramento de instrumentação automática e a instrumentação baseada em SDK manual forem detectados, somente as configurações de instrumentação manual serão respeitadas. Essa disposição impede que dados duplicados sejam enviados. Para saber mais, confira a seção Solução de problemas.
Observação
Você pode configurar o agente anexado automaticamente usando a variável de ambiente APPLICATIONINSIGHTS_CONFIGURATION_CONTENT na folha variável de Ambiente do Serviço de Aplicativo. Para obter detalhes sobre as opções de configuração que podem ser passadas por meio dessa variável de ambiente, consulte Configuração de Node.js.
O Application Insights para Node.js está integrado com o Serviço de Aplicativo no Linux: contêineres personalizados e baseados em código, e com o Serviço de Aplicativo no Windows para aplicativos baseados em código. A integração está em versão prévia pública.
Autoinstrumentação no portal do Azure
Selecione Application Insights no menu de navegação à esquerda do serviço de aplicativo e selecione Habilitar.
Crie um recurso ou selecione um recurso do Application Insights existente para o aplicativo.
Observação
Ao selecionar OK para criar um recurso, você será solicitado a Aplicar configurações de monitoramento. A opção Continuar vincula seu novo recurso do Application Insights ao serviço de aplicativo. Em seguida, o serviço de aplicativo é reiniciado.
Depois de especificar qual recurso usar, você estará pronto.
O Application Insights para Python integra-se ao Serviço de Aplicativo do Azure para Linux baseado em código. A integração está em versão prévia pública e adiciona o SDK do Python, que está em GA. Ela instrumenta bibliotecas populares do Python em seu código, permitindo coletar e correlacionar automaticamente as dependências, os logs e as métricas. Para ver quais chamadas e métricas são coletadas, confira bibliotecas do Python
A telemetria de log é coletada no nível do agente raiz. Para saber mais sobre a hierarquia de registro em log nativa do Python, acesse a Documentação de registro em log do Python.
Pré-requisitos
Python versão 3.11 ou anterior.
O Serviço de Aplicativo deve ser implantado como código. Não há suporte para os contêineres personalizados.
Autoinstrumentação no portal do Azure
Selecione Application Insights no menu de navegação à esquerda do serviço de aplicativo e selecione Habilitar.
Crie um recurso ou selecione um recurso do Application Insights existente para o aplicativo.
Observação
Ao selecionar OK para criar um recurso, você será solicitado a Aplicar configurações de monitoramento. A opção Continuar vincula seu novo recurso do Application Insights ao serviço de aplicativo. Em seguida, o serviço de aplicativo é reiniciado.
Especifique o recurso, e ele está pronto para uso.
Bibliotecas do Python
Após a instrumentação, colete chamadas e métricas dessas bibliotecas do Python:
Para usar a Instrumentação do Django do OpenTelemetry, você precisa definir a variável de ambiente DJANGO_SETTINGS_MODULE nas configurações do Serviço de Aplicativo para apontar da pasta do aplicativo para o módulo de configurações.
Adicionar uma biblioteca de instrumentação da comunidade
Você pode coletar mais dados automaticamente quando incluir as bibliotecas de instrumentação da comunidade OpenTelemetry.
Cuidado
Não damos suporte nem garantimos a qualidade das bibliotecas de instrumentação da comunidade. Para sugerir uma para nossa distribuição, faça uma postagem ou vote a favor em nossa comunidade de comentários. Lembre-se de que algumas são baseadas em especificações experimentais do OpenTelemetry e podem introduzir futuras alterações interruptivas.
Para adicionar a Biblioteca de Instrumentação do OpenTelemetry da comunidade, instale-a por meio do arquivo requirements.txt do aplicativo. A instrumentação automática do OpenTelemetry seleciona e instrumenta todas as bibliotecas instaladas. Localize a lista de bibliotecas da comunidade aqui.
Atualizar manualmente o agente/extensão de monitoramento
A atualização da versão 2.8.9 ocorre automaticamente, sem nenhuma ação adicional. Os novos bits de monitoramento são entregues em segundo plano ao serviço de aplicativo de destino e são coletados na reinicialização do aplicativo.
Para verificar qual versão da extensão você está executando, acesse https://yoursitename.scm.azurewebsites.net/ApplicationInsights.
Atualização das versões 1.0.0-2.6.5
A partir da versão 2.8.9, a extensão de site pré-instalada é usada. Se você estiver com uma versão anterior, poderá fazer a atualização por meio de uma das duas maneiras:
Atualizar por meio da habilitação no portal do Azure: mesmo se você tiver a extensão do Application Insights para Serviço de Aplicativo instalada, a interface do usuário mostrará apenas o botão Habilitar. Nos bastidores, a extensão de site particular antigo é removida.
Defina as configurações do aplicativo para habilitar a extensão de site ApplicationInsightsAgent pré-instalada. Para obter mais informações, confira Habilitar por meio do PowerShell.
Remova manualmente a extensão de site particular chamada extensão do Application Insights para Serviço de Aplicativo do Azure.
Se a atualização for feita de uma versão anterior à 2.5.1, verifique se as DLLs ApplicationInsights foram removidas da pasta bin do aplicativo. Para saber mais, consulte a Solução de problemas.
Atualização das versões 2.8.9 e superiores
A atualização da versão 2.8.9 ocorre automaticamente, sem nenhuma ação adicional. Os novos bits de monitoramento são entregues em segundo plano ao serviço de aplicativo de destino e são coletados na reinicialização do aplicativo.
Para verificar qual versão da extensão você está executando, acesse https://yoursitename.scm.azurewebsites.net/ApplicationInsights.
Atualização das versões 1.0.0-2.6.5
A partir da versão 2.8.9, a extensão de site pré-instalada é usada. Se você estiver com uma versão anterior, poderá fazer a atualização por meio de uma das duas maneiras:
Atualizar por meio da habilitação no portal do Azure: mesmo se você tiver a extensão do Application Insights para Serviço de Aplicativo instalada, a interface do usuário mostrará apenas o botão Habilitar. Nos bastidores, a extensão de site particular antigo é removida.
Defina as configurações do aplicativo para habilitar a extensão de site ApplicationInsightsAgent pré-instalada. Para obter mais informações, confira Habilitar por meio do PowerShell.
Remova manualmente a extensão de site particular chamada extensão do Application Insights para Serviço de Aplicativo do Azure.
Se a atualização for feita de uma versão anterior à 2.5.1, verifique se as DLLs ApplicationInsights foram removidas da pasta bin do aplicativo. Para saber mais, consulte a Solução de problemas.
A versão Java do Application Insights é atualizada automaticamente como parte das atualizações do Serviço de Aplicativo. Se você encontrar um problema que foi corrigido na versão mais recente do agente Java do Application Insights, atualize-o manualmente.
Carregue o arquivo JAR do agente Java para o Serviço de Aplicativo.
a. Primeiro, obtenha a versão mais recente da CLI do Azure seguindo estas instruções.
b. Em seguida, obtenha a versão mais recente do agente Java do Application Insights seguindo estas instruções.
c. Em seguida, implante o arquivo jar do agente do Java do Serviço de Aplicativo usando o seguinte comando: az webapp deploy --src-path applicationinsights-agent-{VERSION_NUMBER}.jar --target-path java/applicationinsights-agent-{VERSION_NUMBER}.jar --type static --resource-group {YOUR_RESOURCE_GROUP} --name {YOUR_APP_SVC_NAME}. Você também pode usar este guia para implantar o agente por meio do plug-in do Maven.
Desabilite o Application Insights por meio da guia Application Insights no portal do Azure.
Depois que o arquivo jar do agente for carregado, acesse as configurações do Serviço de Aplicativo. Se precisar usar o Comando de Inicialização para o Linux, inclua argumentos JVM:
O Comando de Inicialização não é válido JAVA_OPTS para o JavaSE ou CATALINA_OPTS para o Tomcat.
Se você não usar o Comando de Inicialização, crie uma nova variável de ambiente, JAVA_OPTS para JavaSE ou CATALINA_OPTS para Tomcat, com o valor -javaagent:{PATH_TO_THE_AGENT_JAR}/applicationinsights-agent-{VERSION_NUMBER}.jar.
Para aplicar as alterações, reinicie o aplicativo.
Observação
Se você definir a variável de ambiente JAVA_OPTS para JavaSE ou CATALINA_OPTS para Tomcat, você precisará desabilitar o Application Insights no portal do Azure. Como alternativa, se você preferir habilitar o Application Insights no portal do Azure, não defina a variável JAVA_OPTS para JavaSE ou CATALINA_OPTS para Tomcat nas definições de configurações do Serviço de Aplicativo.
A versão Node.js do Application Insights é atualizada automaticamente como parte das atualizações do Serviço de Aplicativo e não pode ser atualizada manualmente.
Se você encontrar um problema corrigido na versão mais recente do SDK do Application Insights, poderá remover a autoinstrumentação e instrumentar manualmente seu aplicativo com a versão mais recente do SDK.
A versão do Python do Application Insights é atualizada automaticamente como parte das atualizações do Serviço de Aplicativo e não pode ser atualizada manualmente.
Se você encontrar um problema corrigido na versão mais recente do SDK do Application Insights, poderá remover a autoinstrumentação e instrumentar manualmente seu aplicativo com a versão mais recente do SDK.
No momento, não oferecemos opções para configurar a extensão de monitoramento do ASP.NET Core.
Para definir configurações de amostragem, que antes você podia controlar por meio do arquivo applicationinsights.config, agora é possível usar as configurações de aplicativo com o prefixo MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor correspondente.
Por exemplo, para alterar a porcentagem de amostragem inicial, crie uma configuração de aplicativo de: MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor_InitialSamplingPercentage e um valor de 100.
Para desabilitar a amostragem, defina MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor_MinSamplingPercentage como um valor de 100.
Para ver a lista de configurações e definições de processador de telemetria de amostragem adaptável com suporte, consulte o código e a documentação de amostragem.
Depois de especificar qual recurso usar, você pode configurar o agente Java. Se você não configurar o agente Java, as configurações padrão serão aplicadas.
O conjunto de configurações completo está disponível. Você só precisa colar um arquivo json válido. Exclua a cadeia de conexão e as configurações que estão na versão prévia – você pode adicionar itens que estejam em versão prévia à medida que entrarem em disponibilidade geral.
Depois de modificar as configurações por meio do portal do Azure, a variável de ambiente APPLICATIONINSIGHTS_CONFIGURATION_FILE será preenchida automaticamente e aparecerá no painel de configurações do Serviço de Aplicativo. Essa variável contém o conteúdo JSON completo que você colou na caixa de texto de configuração do portal do Azure para o seu aplicativo Java.
O agente Node.js pode ser configurado usando JSON. Defina a variável de ambiente APPLICATIONINSIGHTS_CONFIGURATION_CONTENT para a cadeia de caracteres JSON ou defina a variável de ambiente APPLICATIONINSIGHTS_CONFIGURATION_FILE como o caminho do arquivo que contém o JSON.
Se definido como None, desabilita a coleta e a exportação de telemetria de registro em log.
OTEL_METRICS_EXPORTER
Se definido como None, desabilita a coleta e a exportação de telemetria de métrica.
OTEL_TRACES_EXPORTER
Se definido como None, desabilita a coleta e a exportação de telemetria de rastreamento distribuído.
OTEL_BLRP_SCHEDULE_DELAY
Especifica o intervalo de exportação de registro em log em milissegundos. Usa 5.000 como padrão.
OTEL_BSP_SCHEDULE_DELAY
Especifica o intervalo de exportação de rastreamento distribuído em milissegundos. Usa 5.000 como padrão.
OTEL_TRACES_SAMPLER_ARG
Especifica a proporção de telemetria de rastreamento distribuído a ser amostrada. Os valores aceitos variam de 0 a 1. O padrão é 1.0, o que significa que nenhuma telemetria é amostrada.
OTEL_PYTHON_DISABLED_INSTRUMENTATIONS
Especifica quais instrumentações do OpenTelemetry devem ser desabilitadas. Quando desabilitadas, as instrumentações não são executadas como parte da instrumentação automática. Aceita uma lista separada por vírgulas de nomes de biblioteca em letras minúsculas. Por exemplo, defina-o como "psycopg2,fastapi" para desabilitar as instrumentações Psycopg2 e FastAPI. Ele usa como padrão uma lista vazia, habilitando todas as instrumentações compatíveis.
O monitoramento do lado do cliente está habilitado por padrão em aplicativos ASP.NET Core com coleção Recomendada, independentemente da configuração do aplicativo APPINSIGHTS_JAVASCRIPT_ENABLED estar presente.
Se quiser desabilitar o monitoramento do lado do cliente:
Selecione Configurações>Configuração.
Em Configurações do aplicativo, crie uma Nova configuração de aplicativo com as seguintes informações:
Nome: APPINSIGHTS_JAVASCRIPT_ENABLED
Valor: false
Salve as configurações. Reinicie o aplicativo.
O monitoramento no lado do cliente é um opcional para ASP.NET. Habilitar monitoramento do lado do cliente:
Selecione Configurações>Configuração.
Em Configurações do aplicativo, crie uma nova configuração de aplicativo:
Nome: insira APPINSIGHTS_JAVASCRIPT_ENABLED.
Valor: insira true.
Salve as configurações e reinicie seu aplicativo.
Para desabilitar o monitoramento do lado do cliente, remova o par de valor de chave associado das Configurações do aplicativo ou defina o valor como false.
Para habilitar o monitoramento do lado do cliente, o agente Java pode injetar o Carregador do SDK do Navegador (versão prévia) nas páginas HTML do aplicativo, incluindo a configuração da cadeia de conexão apropriada.
Extensão principal, que controla o monitoramento do tempo de execução.
~2 para Windows ou ~3 para Linux
XDT_MicrosoftApplicationInsights_Mode
No modo padrão, somente os recursos essenciais são habilitados para garantir um desempenho ideal.
disabled ou recommended.
XDT_MicrosoftApplicationInsights_PreemptSdk
Somente para aplicativos ASP.NET Core. Habilita a interoperabilidade (interoperação) com o SDK do Application Insights. Carrega a extensão lado a lado com o SDK e a usa para enviar telemetria. (Desabilita o SDK do Application Insights.)
1
Definições de configurações do aplicativo
Nome da configuração do aplicativo
Definição
Valor
ApplicationInsightsAgent_EXTENSION_VERSION
Extensão principal, que controla o monitoramento do tempo de execução.
~2
XDT_MicrosoftApplicationInsights_Mode
No modo padrão, somente os recursos essenciais são habilitados para garantir um desempenho ideal.
default ou recommended
InstrumentationEngine_EXTENSION_VERSION
Controla se o mecanismo de regravação binária InstrumentationEngine é ativado. Essa configuração tem implicações de desempenho e afeta o tempo de início/inicialização frio.
~1
XDT_MicrosoftApplicationInsights_BaseExtensions
Controla se o SQL e o texto da tabela do Azure é capturado junto com as chamadas de dependência. Aviso de desempenho: o tempo de inicialização a frio do aplicativo é afetado. Essa configuração requer o InstrumentationEngine.
~1
Definições de configurações do aplicativo
Nome da configuração do aplicativo
Definição
Valor
ApplicationInsightsAgent_EXTENSION_VERSION
Extensão principal, que controla o monitoramento do tempo de execução.
~2 no Windows ou ~3 no Linux.
XDT_MicrosoftApplicationInsights_Java
Sinalizador para controlar se o agente Java está incluído.
0 ou 1 (aplicável somente no Windows).
Observação
O Depurador de Instantâneos não está disponível para aplicativos Java.
Definições de configurações do aplicativo
Nome da configuração do aplicativo
Definição
Valor
ApplicationInsightsAgent_EXTENSION_VERSION
Extensão principal, que controla o monitoramento do tempo de execução.
~2 no Windows ou ~3 no Linux.
XDT_MicrosoftApplicationInsights_NodeJS
Sinalizador para controlar se o agente Node.js está incluído.
0 ou 1 (aplicável somente no Windows).
Observação
O Depurador de Instantâneos não está disponível para aplicativos Node.js.
Definições de configurações do aplicativo
Nome da configuração do aplicativo
Definição
Valor
APPLICATIONINSIGHTS_CONNECTION_STRING
Cadeia de conexões do seu recurso do Application Insights.
Exemplo: abcd1234-ab12-cd34-abcd1234abcd
ApplicationInsightsAgent_EXTENSION_VERSION
Extensão principal, que controla o monitoramento do tempo de execução.
~3
Observação
O Depurador de Instantâneos não está disponível para aplicativos Python.
Configurações de aplicativo do Serviço de Aplicativo com o Azure Resource Manager
As configurações de aplicativo do Serviço de Aplicativo do Azure podem ser gerenciadas e configuradas com os modelos do Azure Resource Manager. Você pode usar esse método ao implantar novos recursos de Serviço de Aplicativo com a automação do Resource Manager ou modificar as configurações dos recursos existentes.
A estrutura básica das configurações do aplicativo JSON para um recurso do Serviço de Aplicativo:
Para ver um exemplo de um modelo do Resource Manager com configurações de aplicativo definidas para o Application Insights, esse modelo pode ser útil. Especificamente, confira a seção que começa na linha 238.
Automatize a criação de um recurso do Application Insights e vincule ao recurso do Serviço de Aplicativo recém-criado
Para criar um modelo do Resource Manager com as configurações do Application Insights padrão, inicie o processo como se estivesse criando um novo aplicativo Web com o Application Insights habilitado.
Crie um novo recurso do Serviço de Aplicativo com as informações desejadas do aplicativo Web. Habilite o Application Insights na guia Monitoramento.
Selecione Examinar + criar. Em seguida, selecione Baixar um modelo para automação.
Essa opção gera o modelo do Resource Manager mais recente com todas as configurações necessárias definidas.
No exemplo a seguir, substitua todas as instâncias de AppMonitoredSite pelo nome do seu site:
Observação
Se estiver usando o Windows, defina ApplicationInsightsAgent_EXTENSION_VERSION como ~2. Se estiver usando o Linux, defina ApplicationInsightsAgent_EXTENSION_VERSION como ~3.
Para habilitar o monitoramento de aplicativos por meio do PowerShell, somente as configurações de aplicativo subjacentes devem ser alteradas. O exemplo a seguir habilita o monitoramento de aplicativos para um site chamado AppMonitoredSite no grupo de recursos AppMonitoredRG. Ele configura os dados a serem enviados para a chave de instrumentação 012345678-abcd-ef01-2345-6789abcd.
Se estiver usando o Windows, defina ApplicationInsightsAgent_EXTENSION_VERSION como ~2. Se estiver usando o Linux, defina ApplicationInsightsAgent_EXTENSION_VERSION como ~3.
Esta seção fornece respostas para perguntas comuns.
O que o Application Insights modifica no meu projeto?
Os detalhes dependem do tipo de projeto. A lista a seguir é um exemplo para um aplicativo Web.
Adiciona arquivos ao seu projeto:
ApplicationInsights.config
ai.js
Instala os pacotes NuGet:
API do Application Insights: a API principal
API do Application Insights para Aplicativos Web: usada para enviar telemetria do servidor
API do Application Insights para Aplicativos JavaScript: usada para enviar telemetria do cliente
Inclui assemblies em pacotes:
Microsoft.ApplicationInsights
Microsoft.ApplicationInsights.Platform
Insere itens em:
Web.config
packages.config
Insere snippets no código do cliente e do servidor para inicializá-los com a ID de recurso do Application Insights. Por exemplo, em um aplicativo MVC, o código é inserido na página principal Views/Shared/_Layout.cshtml. Somente para novos projetos, você adicionará manualmente o Application Insights a um projeto existente.
Qual a diferença entre as métricas padrão das métricas do serviço Application Insights vs Aplicativo do Azure?
O Application Insights coleta a telemetria das solicitações que chegaram no aplicativo. Se a falha ocorreu no WebApps/WebServer e a solicitação não chegou ao aplicativo do usuário, o Application Insights não terá telemetrias sobre ele.
A duração da serverresponsetime calculada pelo Application Insights não corresponderá necessariamente ao tempo de resposta do servidor observado pelos aplicativos Web. Esse comportamento ocorre porque o Application Insights só conta a duração quando a solicitação realmente chega ao aplicativo do usuário. Se a solicitação estiver presa ou enfileirada no WebServer, o tempo de espera será incluído nas métricas dos aplicativos Web, mas não nas métricas do Application Insights.
Solução de problemas
Testar a conectividade entre o host do aplicativo e o serviço de ingestão
Os SDKs e agentes do Application Insights enviam telemetria para serem ingeridos como chamadas REST para nossos pontos de extremidade de ingestão. Você pode testar a conectividade do servidor Web ou do computador host do aplicativo para os pontos de extremidade do serviço de ingestão usando clientes REST brutos do PowerShell ou comandos curl. Confira Solucionar problemas de telemetria de aplicativo ausente no Application Insights do Azure Monitor.
Quando você cria um aplicativo Web com os tempos de execução do ASP.NET Core no Serviço de Aplicativo, ele implanta uma única página HTML estática como um site inicial. Não recomendamos que você solucione um problema com o modelo padrão. Implante um aplicativo antes de solucionar um problema.
Telemetria ausente
Windows
Verifique se a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION está definida em um valor de ~2.
Navegue até https://yoursitename.scm.azurewebsites.net/ApplicationInsights.
Confirme se o Status da Extensão do Application Insights é Pre-Installed Site Extension, version 2.8.x.xxxx, is running.
Confirme se a origem do status existe e se parece com Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.json.
Se um valor semelhante não estiver presente, significa que o aplicativo não está em execução no momento ou não tem suporte. Para garantir que o aplicativo esteja em execução, tente visitar manualmente os pontos de extremidade do aplicativo/URL do aplicativo, o que permitirá que as informações de tempo de execução fiquem disponíveis.
Confirme se IKeyExists é True. Se está False, adicione APPINSIGHTS_INSTRUMENTATIONKEY e APPLICATIONINSIGHTS_CONNECTION_STRING com seu GUID iKey às configurações do aplicativo.
Caso seu aplicativo se refira a qualquer pacote do Application Insights, a habilitação da integração do Serviço de Aplicativo pode não ter efeito e os dados podem não aparecer no Application Insights. Um exemplo seria se você já tivesse instrumentado – ou tentado instrumentar – seu aplicativo com o SDK do ASP.NET Core. Para corrigir o problema, no portal do Azure, ative Interoperabilidade com o SDK do Application Insights.
Importante
Essa funcionalidade está em versão prévia.
Os dados são enviados usando uma abordagem sem código, mesmo se o SDK do Application Insights foi originalmente usado ou se houve uma tentativa de usá-lo.
Importante
Se o aplicativo usou o SDK do Application Insights para enviar alguma telemetria, a telemetria será desabilitada. Em outras palavras, a telemetria personalizada (por exemplo, um método Track*()) e as configurações personalizadas (por exemplo, amostragem) serão desabilitadas.
Linux
Verifique se a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION está definida em um valor de ~3.
Navegue até https://your site name.scm.azurewebsites.net/ApplicationInsights.
Neste site, confirme:
A origem do status existe e se parece com Status source /var/log/applicationinsights/status_abcde1234567_89_0.json.
O valor Auto-Instrumentation enabled successfully é exibido. Se não houver um valor semelhante presente, significa que o aplicativo não está em execução ou não tem suporte. Para garantir que o aplicativo esteja em execução, tente visitar manualmente os pontos de extremidade do aplicativo/URL do aplicativo, o que permitirá que as informações de tempo de execução fiquem disponíveis.
IKeyExists é True. Se está False, adicione APPINSIGHTS_INSTRUMENTATIONKEY e APPLICATIONINSIGHTS_CONNECTION_STRING com seu GUID iKey às configurações do aplicativo.
O site padrão implantado com aplicativos Web não dá suporte ao monitoramento automático do lado do cliente
Quando você cria um aplicativo Web com os tempos de execução do ASP.NET Core no Serviço de Aplicativo do Azure, ele implanta uma única página HTML estática como um site inicial. A página da Web estática também carrega um site ASP.NET gerenciado no IIS. Esse comportamento permite o teste do monitoramento do lado do servidor sem código, mas não dá suporte ao monitoramento automático do lado do cliente.
Se você quiser testar o servidor sem código e o monitoramento do lado do cliente para ASP.NET Core em um aplicativo Web do Serviço de Aplicativo, recomendamos seguir os guias oficiais para criar um aplicativo Web ASP.NET Core. Em seguida, use as instruções no artigo atual para habilitar o monitoramento.
Não há suporte para PHP, nem para WordPress
Não há suporte para sites em PHP e WordPress. Atualmente, não há um SDK/agente com suporte oficial para o monitoramento do lado do servidor dessas cargas de trabalho. Para acompanhar transações do lado do cliente em um site PHP ou WordPress, adicione JavaScript do lado do cliente às suas páginas usando o SDK do JavaScript.
A tabela a seguir fornece uma explicação do que esses valores significam, de suas causas subjacentes e das correções recomendadas.
Valor do problema
Explicação
Fix
AppAlreadyInstrumented:true
Esse valor indica que a extensão detectou que algum aspecto do SDK já está presente no aplicativo e ela volta atrás. Uma referência a Microsoft.ApplicationInsights.AspNetCore ou Microsoft.ApplicationInsights pode causar esse valor.
Remova as referências. Algumas dessas referências são adicionadas por padrão de determinados modelos do Visual Studio. As versões mais antigas do Visual Studio referenciam Microsoft.ApplicationInsights.
AppAlreadyInstrumented:true
A presença da DLL Microsoft.ApplicationsInsights na pasta do aplicativo de uma implantação anterior também pode causar este valor.
Limpe a pasta do aplicativo para garantir que essas DLLs sejam removidas. Verifique o diretório bin do seu aplicativo local e o diretório wwwroot no Serviço de Aplicativo. (Para verificar o diretório wwwroot do aplicativo Web do Serviço de Aplicativo, selecione Ferramentas Avançadas (Kudu) >Console de depuração>CMD>home\site\wwwroot).
IKeyExists:false
Esse valor indica que a chave de instrumentação não está presente na configuração do aplicativo APPINSIGHTS_INSTRUMENTATIONKEY. As causas possíveis incluem remover acidentalmente os valores ou esquecer de definir os valores no script de automação.
Verifique se a configuração está presente nas configurações do aplicativo do serviço de aplicativo.
Observação
Quando você cria um aplicativo Web com os tempos de execução do ASP.NET no Serviço de Aplicativo, ele implanta uma única página HTML estática como um site inicial. Não recomendamos que você solucione um problema com um modelo padrão. Implante um aplicativo antes de solucionar um problema.
Telemetria ausente
Verifique se a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION está definida em um valor de ~2.
Navegue até https://yoursitename.scm.azurewebsites.net/ApplicationInsights.
Confirme se Application Insights Extension Status é Pre-Installed Site Extension, version 2.8.x.xxxx e está em execução.
Confirme se a origem do status existe e se parece com Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.json.
Se um valor semelhante não estiver presente, significa que o aplicativo não está em execução no momento ou não tem suporte. Para garantir que o aplicativo esteja em execução, tente visitar manualmente os pontos de extremidade do aplicativo/URL do aplicativo, o que permitirá que as informações de tempo de execução fiquem disponíveis.
Confirme se IKeyExists está true.
Caso contrário, adicione APPINSIGHTS_INSTRUMENTATIONKEY e APPLICATIONINSIGHTS_CONNECTION_STRING com o GUID da chave de instrumentação às configurações do aplicativo.
Confirme se não há entradas para AppAlreadyInstrumented, AppContainsDiagnosticSourceAssembly e AppContainsAspNetTelemetryCorrelationAssembly.
Se qualquer uma dessas entradas existir, remova os seguintes pacotes do seu aplicativo: Microsoft.ApplicationInsights, System.Diagnostics.DiagnosticSource e Microsoft.AspNet.TelemetryCorrelation.
O site padrão implantado com aplicativos Web não dá suporte ao monitoramento automático do lado do cliente
Quando você cria um aplicativo Web com os tempos de execução do ASP.NET no Serviço de Aplicativo do Azure, ele implanta uma única página HTML estática como um site inicial. A página da Web estática também carrega um site ASP.NET gerenciado no IIS. Esta página permite testar o monitoramento do lado do servidor sem código, mas não dá suporte ao monitoramento automático do lado do cliente.
Se você quiser testar o servidor sem código e o monitoramento do lado do cliente para ASP.NET em um aplicativo Web do Serviço de Aplicativo, recomendamos seguir os guias oficiais para criar um aplicativo Web do ASP.NET Framework. Em seguida, use as instruções no artigo atual para habilitar o monitoramento.
Não há suporte para a combinação de APPINSIGHTS_JAVASCRIPT_ENABLED e urlCompression
Se você usar APPINSIGHTS_JAVASCRIPT_ENABLED=true nos casos em que o conteúdo é codificado, poderá obter erros como:
Erro de regravação de URL 500.
Erro 500.53 de módulo de regravação de URL com a mensagem: "As regras de regravação de saída não podem ser aplicadas quando o conteúdo da resposta HTTP está codificado (' gzip ')."
Ocorre um erro porque a configuração do APPINSIGHTS_JAVASCRIPT_ENABLED aplicativo está definida como true e a codificação de conteúdo está presente ao mesmo tempo. Ainda não há suporte para esse cenário. A solução alternativa é remover APPINSIGHTS_JAVASCRIPT_ENABLED as configurações do aplicativo. Infelizmente, se a instrumentação de JavaScript do lado do cliente/navegador ainda for necessária, as referências manuais do SDK serão necessárias para suas páginas da Web. Siga as instruções para realizar a instrumentação manual com o SDK do JavaScript.
Para as informações mais recentes sobre a extensão/agente de Application Insights, confira as notas de versão.
Não há suporte para PHP, nem para WordPress
Não há suporte para sites em PHP e WordPress. Atualmente, não há um SDK/agente com suporte oficial para o monitoramento do lado do servidor dessas cargas de trabalho. Para acompanhar transações do lado do cliente em um site PHP ou WordPress, adicione JavaScript do lado do cliente às suas páginas usando o SDK do JavaScript.
A tabela a seguir fornece uma explicação do que esses valores significam, de suas causas subjacentes e das correções recomendadas.
Valor do problema
Explicação
Fix
AppAlreadyInstrumented:true
Esse valor indica que a extensão detectou que algum aspecto do SDK já está presente no aplicativo e ela volta atrás. Uma referência a System.Diagnostics.DiagnosticSource, Microsoft.AspNet.TelemetryCorrelation ou Microsoft.ApplicationInsights pode causar esse valor.
Remova as referências. Algumas dessas referências são adicionadas por padrão de determinados modelos do Visual Studio. Versões mais antigas do Visual Studio podem adicionar referências a Microsoft.ApplicationInsights.
AppAlreadyInstrumented:true
Esse valor também pode ser causado pela presença das DLLs anteriores na pasta do aplicativo de uma implantação anterior.
Limpe a pasta do aplicativo para garantir que essas DLLs sejam removidas. Verifique o diretório bin do seu aplicativo local e o diretório wwwroot no recurso do Serviço de Aplicativo. Para verificar o diretório wwwroot do aplicativo Web do Serviço de Aplicativo, selecione Ferramentas Avançadas (Kudu)>Console de depuração>CMD>home\site\wwwroot.
Esse valor indica que a extensão detectou referências a Microsoft.AspNet.TelemetryCorrelation no aplicativo e volta atrás.
Remova a referência.
AppContainsDiagnosticSourceAssembly**:true
Esse valor indica que a extensão detectou referências a System.Diagnostics.DiagnosticSource no aplicativo e volta atrás.
Para o ASP.NET, remova a referência.
IKeyExists:false
Esse valor indica que a chave de instrumentação não está presente na configuração do aplicativo APPINSIGHTS_INSTRUMENTATIONKEY. As causas possíveis podem ser que os valores foram removidos acidentalmente ou você esqueceu de definir os valores no script de automação.
Verifique se a configuração está presente nas configurações do aplicativo do serviço de aplicativo.
System.IO.FileNotFoundException após a atualização 2.8.44
A versão 2.8.44 da instrumentação automática atualiza o SDK do Application Insights para o 2.20.0. O SDK do Application Insights tem uma referência indireta a System.Runtime.CompilerServices.Unsafe.dll por meio de System.Diagnostics.DiagnosticSource.dll. Se o aplicativo tiver redirecionamento de associação para System.Runtime.CompilerServices.Unsafe.dll e se essa biblioteca não estiver presente na pasta do aplicativo, ele poderá gerar System.IO.FileNotFoundException.
Para resolver esse problema, remova a entrada do redirecionamento de associação para System.Runtime.CompilerServices.Unsafe.dll do arquivo web.config. Se o aplicativo quiser usar System.Runtime.CompilerServices.Unsafe.dll, defina o redirecionamento de associação, conforme mostrado aqui:
Como solução temporária, defina a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION para um valor de 2.8.37. Essa configuração aciona o Serviço de Aplicativo para usar a extensão antiga do Application Insights. Mitigações temporárias só devem ser usadas por períodos breves.
Telemetria ausente
Verifique se a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION está definida em um valor de ~2 no Windows ou ~3 no Linux
Examine o arquivo de log para ver se o agente foi iniciado com êxito: navegue até `https://yoursitename.scm.azurewebsites.net/ e, em SSH, acesse o diretório raiz. O arquivo de log está localizado em LogFiles/ApplicationInsights.
Depois de habilitar o monitoramento de aplicativos em seu aplicativo Java, valide se o agente está funcionando por meio da observação das métricas ao vivo – mesmo antes de implantar um aplicativo no Serviço de Aplicativo, você verá algumas solicitações do ambiente. Lembre-se de que o conjunto completo de telemetria só fica disponível quando o aplicativo está implantado e em execução.
Defina a variável de ambiente APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL para debug se você não vir nenhum erro e não houver telemetria.
Telemetria ausente
Windows
Verifique se a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION está definida em um valor de ~2.
Navegue até https://yoursitename.scm.azurewebsites.net/ApplicationInsights.
Confirme que o Pre-Installed Site Extension, version 2.8.x.xxxx, is running. está Application Insights Extension Status
Usar a instrumentação automática por cima da instrumentação manual pode causar telemetria duplicada e aumentar seu custo. Para usar a instrumentação automática do OpenTelemetry do Serviço de Aplicativo, primeiro remova a instrumentação manual do OpenTelemetry do seu código.
Telemetria ausente
Se você não tiver telemetria, siga estas etapas para confirmar se a instrumentação automática está habilitada corretamente.
Confirme se a instrumentação automática está habilitada na experiência do Application Insights em seu Recurso do Serviço de Aplicativo.
Confirme se a configuração do aplicativo ApplicationInsightsAgent_EXTENSION_VERSION está definida como um valor de ~3 e se APPLICATIONINSIGHTS_CONNECTION_STRING aponta para o recurso apropriado do Application Insights.
Verifique o diagnóstico da instrumentação automática e os logs de status.
a. Navegue até /var/log/applicationinsights/ e abra status_*.json.
b. Confirme se AgentInitializedSuccessfully está definido como true e se IKey tem um iKey válido.
O arquivo applicationinsights-extension.log na mesma pasta pode mostrar outros diagnósticos úteis.
Aplicativos do Django
Se o aplicativo usa o Django e não está conseguindo iniciar ou está usando configurações incorretas, defina a variável de ambiente DJANGO_SETTINGS_MODULE. Consulte a seção Instrumentação Django para obter detalhes.
Esta seção contém as notas sobre a versão do Serviço de Aplicativo do Azure com base na versão do ANT para instrumentação de runtime com o Application Insights.
Para descobrir qual versão da extensão você está usando no momento, vá para https://<yoursitename>.scm.azurewebsites.net/ApplicationInsights.
Separe o pacote .NET/.NET Core, Java e Node.js em diferentes extensão de site do Windows do Serviço de Aplicativo.
2.8.42
Implantações autocontidas adicionadas e suporte de .NET 6.0 ao .NET Startup Hook.
2.8.41
Versões sem suporte (2.1) removidas. As versões com suporte são 3.1 e 5.0.
2.8.39
Suporte adicionado ao .NET Core 5.0.
2.8.38
.NET Core: remoção das versões fora de suporte (2.0, 2.2 e 3.0). As versões com suporte são 2.1 e 3.1.
2.8.37
Extensão do Windows AppSvc: funcionamento do .NET Core com qualquer versão do System.Diagnostics.DiagnosticSource.dll.
2.8.36
Extensão do Windows AppSvc: habilitação da interoperabilidade com SDK de IA no .NET Core.
2.8.35
Extensão do Windows AppSvc: adição de suporte a .NET Core 3.1.
2.8.33
Agentes .NET, .NET Core, Java e Node.js e a Extensão do Windows: suporte para nuvens soberanas. As cadeias de conexão podem ser usadas para enviar dados para as nuvens soberanas.
2.8.31
O agente ASP.NET Core corrigiu um problema com o SDK do Application Insights. Se o runtime carregar a versão incorreta do System.Diagnostics.DiagnosticSource.dll, a extensão sem código não travará o aplicativo e recuará. Para corrigir o problema, os clientes precisam remover System.Diagnostics.DiagnosticSource.dll da pasta de compartimento ou usar a versão mais antiga da extensão definindo ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24. Se não o fizerem, o monitoramento de aplicativos não será habilitado.
2.8.26
Corrigido o problema relacionado ao SDK atualizado do Application Insights. O agente não tentará carregar AiHostingStartup se ApplicationInsights.dll já estiver presente na pasta de compartimento. Ele resolve problemas relacionados à reflexão por meio do Assembly<AiHostingStartup>.GetTypes().
Problemas conhecidos: a exceção System.IO.FileLoadException: Could not load file or assembly 'System.Diagnostics.DiagnosticSource, Version=4.0.4.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' pode ser lançada, se outra versão do DiagnosticSource dll for carregada. Isso pode acontecer, por exemplo, se System.Diagnostics.DiagnosticSource.dll estiver presente na pasta publicar. Como atenuante, use a versão anterior da extensão definindo as configurações do aplicativo nos serviços de aplicativos: ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24.
2.8.24
Recriação de pacote da versão 2.8.21.
2.8.23
Adição do suporte a monitoramento sem código ASP.NET Core 3.0.
Atualização do SDK do ASP.NET Core para 2.8.0 nas versões de runtime 2.1, 2.2 e 3.0. Os aplicativos destinados ao .NET Core 2.0 continuam a usar a versão 2.1.1 do SDK.
2.8.14
Atualização da versão do SDK do ASP.NET Core de 2.3.0 para a mais recente (2.6.1) nos aplicativos destinados ao .NET Core 2,1, 2,2. Os aplicativos destinados ao .NET Core 2.0 continuam a usar a versão 2.1.1 do SDK.
2.8.12
Suporte para aplicativos ASP.NET Core 2.2.
Correção de um bug na extensão ASP.NET Core causando uma injeção de SDK, mesmo quando o aplicativo já foi instrumentado com o SDK. Para os aplicativos 2.1 e 2.2, agora a presença do ApplicationInsights.dll na pasta do aplicativo faz com que a extensão volte a ser desativada. Para aplicativos 2.0, a extensão recua apenas se o ApplicationInsights for habilitado com uma chamada UseApplicationInsights().
Correção permanente para resposta de HTML incompleta dos aplicativos ASP.NET Core. Agora essa correção está estendida para funcionar com aplicativos .NET Core 2.2.
Adição de suporte para desativar a injeção de JavaScript para aplicativos ASP.NET Core (APPINSIGHTS_JAVASCRIPT_ENABLED=false appsetting). Para ASP.NET Core, a injeção de JavaScript está no modo "Recusar" por padrão, salvo se explicitamente desativada. (A configuração padrão é feita para manter o comportamento atual.)
Corrigido o bug da extensão ASP.NET Core que causou a injeção mesmo se a ikey não estivesse presente.
Correção de um bug na lógica de prefixo da versão do SDK que causou uma versão incorreta do SDK na telemetria.
Adição do prefixo de versão do SDK nos aplicativos ASP.NET Core para identificar como a telemetria foi coletada.
Corrigida a página SCM-ApplicationInsights para mostrar corretamente a versão da extensão pré-instalada.
2.8.10
Correção para resposta de HTML incompleta dos aplicativos ASP.NET Core.
Separe o pacote .NET/.NET Core, Java e Node.js em diferentes extensão de site do Windows do Serviço de Aplicativo.
2.8.33
Agentes .NET, .NET Core, Java e Node.js e a Extensão do Windows: suporte para nuvens soberanas. As cadeias de conexão podem ser usadas para enviar dados para as nuvens soberanas.
2.8.24
Recriação de pacote da versão 2.8.21.
2.8.43
Separe o pacote .NET/.NET Core, Java e Node.js em diferentes extensão de site do Windows do Serviço de Aplicativo.
Agentes .NET, .NET Core, Java e Node.js e a Extensão do Windows: suporte para nuvens soberanas. As cadeias de conexão podem ser usadas para enviar dados para as nuvens soberanas.
2.8.24
Recriação de pacote da versão 2.8.21.
2.8.43
Separe o pacote .NET/.NET Core, Java e Node.js em diferentes extensão de site do Windows do Serviço de Aplicativo.
2.8.42
SDK de IA atualizado para 2.1.8 da versão 2.1.7. Adicionado suporte para identidades atribuídas pelo usuário e pelo sistema gerenciadas pelo Microsoft Entra.
Agentes .NET, .NET Core, Java e Node.js e a Extensão do Windows: suporte para nuvens soberanas. As cadeias de conexão podem ser usadas para enviar dados para as nuvens soberanas.
2.8.24
Recriação de pacote da versão 2.8.21.
As notas sobre a versão do Python serão mostradas aqui.