Perguntas frequentes sobre o Application Insights

Perguntas frequentes oficiais sobre o Azure Monitor Application Insights. Encontre respostas para perguntas sobre como usar o Application Insights com Azure Monitor.

Visão geral

Como instrumentar um aplicativo?

Para obter informações detalhadas sobre como instrumentar aplicativos para habilitar o Application Insights, confira as noções básicas de coleta de dados.

Como usar o Application Insights?

Depois de habilitar o Application Insights instrumentando um aplicativo, sugerimos primeiro verificar as métricas dinâmicas e o mapa do aplicativo.

Qual telemetria o Application Insights coleta?

De aplicativos web do servidor:

  • Solicitações HTTP.
  • Dependências como SQL, HTTP, Azure Cosmos DB, Armazenamento de Tabelas do Azure, Armazenamento de Blobs do Azure e chamadas do Armazenamento de Filas do Azure.
  • Exceções e rastreamentos de pilha.
  • Métricas de tempo de execução da instrumentação com suporte.
  • Eventos e métricas personalizados que você envia usando a telemetria personalizada do OpenTelemetry, o SDK do JavaScript ou o Click Analytics.
  • Logs de Rastreamento se você configurar o coletor apropriado.

Nas páginas do cliente na Web:

  • Exceções não capturadas no seu aplicativo, incluindo informações sobre

    • Rastreamento de pilha
    • Detalhes da exceção e mensagem que acompanha o erro
    • Número de coluna e linha do erro
    • URL no qual o erro foi gerado
    • Solicitações de dependência de rede realizadas pelo seu aplicativo, como XML HTTP Request (XHR) e Fetch (a coleta de solicitações Fetch está desativada por padrão), incluem informações sobre:
      • URL da fonte de dependência
      • O Comando e o Método utilizados para solicitar a dependência
      • A duração da solicitação
      • Código de resultado e o status de êxito da solicitação
      • ID do usuário que faz a solicitação (se houver)
      • Contexto de correlação (se houver) em que a solicitação é feita

  • Informações do usuário (por exemplo, local, rede, IP)

  • Informações do dispositivo (por exemplo, Navegador, SO, versão, idioma, modelo)

  • Informações da sessão

    Observação

    Para alguns aplicativos, como SPAs (aplicativos de página única), a duração nem sempre é registrada e, nesses casos, o padrão é 0.

    Para obter mais informações, consulte Coleta de dados, retenção e armazenamento no Application Insights.

Em outras fontes, se você configurá-las:

Para onde a telemetria coletada com estruturas de log tradicionais vai?

Ao usar estruturas de log como o Serilog, as mensagens de log são ingeridas pelo Application Insights como telemetria de rastreamento e armazenadas na traces tabela (ou AppTraces no Log Analytics). Isso é por design, já que tabelas como requests, dependenciese exceptions são reservadas para seus respectivos tipos de telemetria.

Para obter detalhes, consulte o modelo de dados de telemetria do Application Insights.

Quantos recursos do Application Insights devo implantar?

Para entender o número de recursos do Application Insights necessários para abranger seu aplicativo ou seus componentes entre ambientes, confira o Guia de planejamento de implantação do Application Insights.

Como posso gerenciar recursos do Application Insights com o PowerShell?

Você pode escrever scripts do PowerShell usando o Azure Resource Monitor para:

  • Criar e atualizar recursos do Application Insights.
  • Definir o plano de preços.
  • Obter a cadeia de conexão.
  • Adicione um alerta de métrica.
  • Adicionar um teste de disponibilidade.

Não é possível configurar um relatório do Metric Explorer ou configurar a exportação contínua.

Como posso consultar a telemetria do Application Insights?

Utilize a API REST para executar consultas Log Analytics.

É possível enviar telemetria para o portal do Application Insights?

Recomendamos o Azure Monitor OpenTelemetry Distro.

O ingestion schema e endpoint protocol estão disponíveis publicamente.

Quanto tempo demora para coletar a telemetria?

A maioria dos dados do Application Insights tem uma latência inferior a cinco minutos. Alguns dados podem levar mais tempo, o que é típico em arquivos de log maiores. Consulte o contrato de nível de serviço do Application Insights.

O que é o modelo de preços do Application Insights?

O Application Insights é cobrado por meio do workspace do Log Analytics no qual os dados de log foram ingeridos. O tipo de preço padrão pago conforme o uso do Log Analytics inclui 5 GB por mês de subsídio de dados gratuito por conta de cobrança. Saiba mais sobre as opções de preços dos logs do Azure Monitor.

Há encargos de transferência de dados entre um aplicativo Web Azure e o Application Insights?

  • Se seu aplicativo Web do Azure estiver hospedado em um data center, onde há um ponto de extremidade de coleta do Application Insights, não haverá cobrança.
  • Se não houver um ponto de extremidade de coleta no data center do host, então a telemetria do seu aplicativo incorrerá em Encargos do Azure.

Essa resposta depende da distribuição de nossos pontos de extremidade, não do local em que o recurso do Application Insights está hospedado.

Incorrerei em custos de rede se meu recurso do Application Insights estiver monitorando um recurso de Azure (ou seja, produtor de telemetria) em uma região diferente?

Sim, você pode incorrer em mais custos de rede, que variam dependendo da região de onde a telemetria está vindo e para onde está indo. Consulte preços de largura de banda do Azure para obter detalhes.

Se você estiver vendo encargos inesperados ou custos altos no Application Insights, este guia poderá ajudar. Ele aborda causas comuns, como alto volume de telemetria, picos de ingestão de dados e amostragem configurada incorretamente. É especialmente útil se você estiver solucionando problemas relacionados a picos de custo, volume de telemetria, amostragem não funcionando, limites de dados, ingestão alta ou cobrança inesperada. Para começar, consulte Solucionar problemas de alta ingestão de dados no Application Insights.

Quais versões do TLS têm suporte?

O Application Insights usa o TLS (Transport Layer Security) 1.2 e 1.3.

Para obter perguntas gerais sobre o problema herdado do TLS, consulte Solução de problemas de TLS e suporte Azure Resource Manager TLS.

Onde posso obter mais informações sobre o Application Insights?

Para obter mais informações, consulte Introdução ao Application Insights.

Coleta, retenção, storage e privacidade de dados

Como o Application Insights lida com coleta, retenção, storage e privacidade de dados?

Contexto

O Application Insights coleta telemetria do seu aplicativo e o armazena em um workspace do Log Analytics. Ele funciona para aplicativos hospedados em qualquer lugar, não apenas em Azure.

O que é coletado e de onde

A telemetria vem de: (1) o SDK que você adiciona ao seu aplicativo, incluindo qualquer telemetria personalizada enviada, (2) agentes de servidor opcionais e (3) testes de disponibilidade executados pela Microsoft. Os dados típicos incluem solicitações, dependências, exceções e falhas, contadores de desempenho, contexto de cliente e servidor, rastreamentos e quaisquer eventos ou métricas personalizados que você enviar. Para verificar o que está sendo enviado, execute seu aplicativo no modo de depuração e verifique as janelas de Saída ou Diagnóstico do IDE. Para páginas da web, abra as ferramentas de desenvolvedor do seu navegador e inspecione a guia Rede. Você pode filtrar ou enriquecer a telemetria antes que ela seja enviada, implementando um processador de telemetria.

Retenção e armazenamento

A retenção de dados brutos pode ser definida como 30, 60, 90, 120, 180, 270, 365, 550 ou 730 dias. A retenção além de 90 dias pode incorrer em encargos extras. As métricas agregadas são mantidas em granularidade de 1 minuto por 90 dias. Os instantâneos de depuração são mantidos por 15 dias. Os dados são armazenados na região escolhida ao criar o recurso. A telemetria é imutável após a ingestão. Não é possível editar a telemetria. A limpeza está disponível para excluir dados quando necessário.

Access, segurança e criptografia

Os dados são visíveis para você e colegas de equipe com access e podem ser exportados. Microsoft usa seus dados apenas para fornecer o serviço, com acesso restrito a pessoal, e pode usar estatísticas agregadas para melhorar o serviço. A telemetria é enviada por HTTPS e os dados são criptografados em repouso e à medida que se movem entre datacenters.

Privacidade e uso responsável

Os módulos padrão do SDK se concentram no desempenho, no uso e no diagnóstico e normalmente não incluem dados pessoais confidenciais. Não coloque dados confidenciais em URLs. Examine a telemetria personalizada para que ela não inclua dados pessoais. O IP do cliente é usado para localização geográfica e, em seguida, o campo IP armazenado é zerado por padrão. Se você precisar de máscara, adicione um inicializador de telemetria. Se o aplicativo precisar de uma opção de exclusão, desabilite a coleta dentro do código. Examine também campos aparentemente inócuos, por exemplo, o nome do dispositivo em dispositivos pessoais. Você pode controlar ou desabilitar alguma coleção na configuração ou por meio do código. Para obter mais informações, consulte Geolocalização e Tratamento de Endereço IP.

TLS

Use o TLS moderno para dados em trânsito. Não decodificar versões de protocolo mais antigas. Permita que a plataforma negocie versões mais recentes à medida que elas se tornam disponíveis. Para obter mais informações, consulte Proteja sua implantação do Azure Monitor.

Buffer local e interrupções

Se a conectividade com Azure for perdida ou limitada, os exportadores OpenTelemetry com suporte e os SDKs atuais poderão armazenar em buffer a telemetria localmente e tentar novamente. Para obter o comportamento atual do OpenTelemetry, consulte armazenamento offline e novas tentativas automáticas. Para obter as configurações de buffer do navegador, consulte a configuração do SDK do JavaScript.

Quais dados de uso a Microsoft coleta?

Em muitos casos, o Application Insights coleta automaticamente dados sobre o uso do produto para a Microsoft. Esses dados são armazenados em um armazenamento de dados da Microsoft e não afetam o volume e o custo de monitoramento dos clientes. O Application Insights coleta métricas essenciais e não essenciais sobre:

As três principais finalidades dessa coleta de dados são:

  • Saúde do serviço e confiabilidade - Monitorando a conectividade com o endpoint de ingestão de uma perspectiva externa para garantir que o serviço esteja funcionando corretamente.
  • Diagnóstico de suporte - Oferecendo insights autossuficientes e auxiliando o suporte ao cliente no diagnóstico e resolução de problemas.
  • Melhoria do produto - Coleta de insights para a Microsoft otimizar o design do produto e aprimorar a experiência geral do usuário.

Observação

A coleta de dados de uso não dá suporte a Link Privado do Azure.

Idiomas com suporte

Métricas .NET Java JavaScript Node.js Python
Métricas essenciais
Rede ❌ ✅ ❌ ✅ ✅
Anexar ✔️* ✅ ❌ ✅ ✅
Característica ❌ ✅ ❌ ✅ ✅
Métricas não essenciais
Falha de E/S do disco ❌ ✅ ❌ ❌ ❌

Regiões da UE com suporte

A coleta de dados de uso dá suporte ao Limite de Dados da UE para recursos do Application Insights nas seguintes regiões:

Nome da localização geográfica Nome da região
Europa Europa Setentrional
Europa Oeste da Europa
França França Central
França Sul da França
Alemanha Centro-oeste da Alemanha
Noruega Leste da Noruega
Noruega Oeste da Noruega
Suécia Suécia Central
Suíça Norte da Suíça
Suíça Oeste da Suíça
Reino Unido Sul do Reino Unido
Reino Unido Oeste do Reino Unido

Dados de uso coletados

Métricas de rede

Nome da métrica Unidade Dimensões suportadas
Contagem de êxitos de solicitações Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, , Operating System, Language, Version, , EndpointHost
Contagem de falhas de solicitações Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, Operating System, , Language, Version, , Endpoint, Host, Status Code
Duração da solicitação Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, , Operating System, Language, Version, , EndpointHost
Contagem de repetições Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, Operating System, , Language, Version, , Endpoint, Host, Status Code
Contagem de restrição Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, Operating System, , Language, Version, , Endpoint, Host, Status Code
Contagem de Exceções Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, Operating System, , Language, Version, , Endpoint, Host, Exception Type

Anexar métricas

Nome da métrica Unidade Dimensões suportadas
Anexar Contagem Resource Provider, Resource Provider Identifier, Attach Type, Instrumentation Key, Runtime Version, Operating System, , Language, , Version

Métricas de funcionalidades

Nome da métrica Unidade Dimensões suportadas
Característica Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, , Feature, Type, Operating System, , LanguageVersion

Métricas não essenciais

Acompanhar a falha de E/S de disco quando você usa a persistência de disco para telemetria confiável.

Nome da métrica Unidade Dimensões suportadas
Contagem de Falhas de Leitura Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, , Operating System, Language, Version
Número de Falhas de Gravação Contagem Resource Provider, Attach Type, Instrumentation Key, Runtime Version, , Operating System, Language, Version

Configuração do firewall

As métricas são enviadas para os seguintes locais, para os quais as conexões de saída devem ser abertas em firewalls:

Localização URL
Europa westeurope-5.in.applicationinsights.azure.com
Fora da Europa westus-0.in.applicationinsights.azure.com

Desabilitar a coleta de dados de uso

.NET

A coleta de dados de uso é habilitada por padrão. Ele pode ser desabilitado configurando a variável de ambiente APPLICATIONINSIGHTS_STATSBEAT_DISABLED como true.

Java

Observação

Somente métricas não essenciais podem ser desabilitadas em Java.

Para desabilitar métricas não essenciais, adicione a seguinte configuração ao arquivo de configuração:

{
  "preview": {
    "statsbeat": {
        "disabled": "true"
    }
  }
}

Você também pode desabilitar este recurso definindo a variável de ambiente APPLICATIONINSIGHTS_STATSBEAT_DISABLED para true. Esta configuração então tem precedência sobre disabled, que é especificada na configuração do JSON.

Node.js

A coleta de dados de uso é habilitada por padrão. Ele pode ser desabilitado configurando a variável de ambiente APPLICATION_INSIGHTS_NO_STATSBEAT como true.

Python

A coleta de dados de uso é habilitada por padrão. Ele pode ser desabilitado configurando a variável de ambiente APPLICATIONINSIGHTS_STATSBEAT_DISABLED_ALL como true.

Informações arquivadas

Para obter informações arquivadas, consulte Coleta, retenção e armazenamento de dados no Application Insights.

Compatível com TLS

Determinar se a aposentadoria do TLS afeta você

O Application Insights e o Azure Monitor não controlam a versão do TLS usada para conexões HTTPS. A versão do TLS depende do sistema operacional e do ambiente de runtime em que o aplicativo é executado.

Para confirmar a versão do TLS em uso:

  • Examine a documentação do sistema operacional e do runtime ou da estrutura.
  • Entre em contato com a equipe de suporte apropriada se precisar de mais ajuda. Não abra uma solicitação de suporte com o Application Insights.

Exemplo de linguagem e suporte a runtime para TLS 1.2+

As versões a seguir incluem suporte integrado para TLS 1.2 ou superior:

  • .NET/.NET Core: .NET Framework 4.6.2 ou posterior e todas as versões do .NET Core
  • Java: Java 8 atualização 161 (8u161) ou posterior
  • Python: distribuições do Python criadas com o OpenSSL 1.0.1 ou posterior
  • Node.js: Node.js versão 10 ou posterior

Exemplo de suporte do sistema operacional para TLS 1.2+

Os seguintes sistemas operacionais incluem suporte integrado para TLS 1.2 ou superior:

  • Windows: Windows 8, Windows Server 2012 e posterior
  • Linux: a maioria das distribuições modernas do Linux que usam o OpenSSL 1.0.1 ou posterior

Como posso garantir que meus recursos não sejam afetados?

Para evitar interrupções de serviço, cada ponto de extremidade remoto (incluindo solicitações dependentes) com o qual o recurso interage precisa dar suporte a pelo menos uma combinação da mesma versão de protocolo, cipher suite e curva elíptica mencionada anteriormente. Se o ponto de extremidade remoto não der suporte à configuração de TLS necessária, ele precisará ser atualizado com suporte para alguma combinação da configuração do TLS pós-substituição.

Após 1º de maio de 2025, qual é o comportamento dos recursos afetados?

Os recursos afetados do Application Insights param de ingerir dados e não podem acessar os componentes necessários do aplicativo. Como resultado, alguns recursos param de funcionar.

Quais componentes a substituição afeta?

A descontinuação do TLS (Transport Layer Security) detalhada neste documento só deve afetar o comportamento após 1º de maio de 2025. Para obter mais informações sobre operações CRUD, consulte suporte a TLS do Azure Resource Manager. Esse recurso fornece mais detalhes sobre os prazos de suporte e descontinuação do TLS.

Onde posso obter suporte ao TLS (Transport Layer Security)?

Em caso de dúvidas gerais sobre o problema herdado do TLS, consulte Solução de problemas de TLS.

Onde posso obter mais informações sobre o suporte do TLS no Application Insights?

Para obter mais informações, consulte o suporte ao TLS.

aplicativos ASP.NET Core

Como posso acompanhar a telemetria que não é coletada automaticamente?

Para instrumentação atual, use APIs OpenTelemetry e APIs de registro em log ou métricas específicas do idioma. Para obter exemplos, consulte Coletar telemetria personalizada.

Para eventos personalizados do navegador, use o SDK javaScript do Application Insights ou o Click Analytics. Para eventos personalizados do lado do servidor, use eventos personalizados OpenTelemetry.

Como fazer a captura do corpo da solicitação e da resposta na minha telemetria?

ASP.NET Core tem suporte integrado para registrar em log informações de solicitação e resposta HTTP, incluindo o corpo. Isso pode expor informações de identificação pessoal (PII) e pode aumentar significativamente os custos de desempenho e ingestão, portanto, avalie os riscos cuidadosamente antes de usá-los.

Como eu posso personalizar a coleção de registros do ILogger?

Para aplicativos .NET atuais, configure a coleção de logs por meio do OpenTelemetry e da configuração de log de .NET padrão. Use Logging:LogLevel no appsettings.json para escolher os níveis de log do aplicativo e configurar a exportação de log do OpenTelemetry como parte da configuração do Azure Monitor OpenTelemetry. Veja Habilitar OpenTelemetry com o Application Insights e Modificar a Telemetria.

Estou implantando meu aplicativo ASP.NET Core para Aplicativos Web. Ainda devo habilitar a extensão do Application Insights de Aplicativos Web?

Escolha um caminho de instrumentação para o aplicativo. Para a configuração atual baseada em código, use Azure Monitor OpenTelemetry. Para o monitoramento de serviços de aplicativo sem a necessidade de código, use monitoramento de aplicativos sem mudanças de código. Evite a sobreposição de instrumentação para o mesmo aplicativo, a menos que você esteja validando uma migração.

Posso habilitar o monitoramento do Application Insights sem alterar o código do aplicativo?

Para novo monitoramento de aplicativos, use Distribuições do OpenTelemetry do Azure Monitor ou os caminhos atuais de autoinstrumentação. Consulte Habilitar o OpenTelemetry com o Application Insights e o monitoramento de aplicativos sem alterações de código.

Onde posso obter mais informações sobre como usar o Application Insights para aplicativos ASP.NET Core?

Para obter a instrumentação atual do ASP.NET Core, consulte Habilitar o OpenTelemetry com o Application Insights.

Contadores de desempenho do ASP.NET

Qual é a diferença entre a Taxa de exceções e as Métricas de exceções?

  • Exception rate: a taxa de exceções é um contador de desempenho do sistema. O CLR conta todas as exceções tratadas e sem tratamento que são geradas, e divide o total em um intervalo de amostragem pela duração do intervalo. O SDK do Application Insights coleta esse resultado e o envia para o portal.
  • Exceptions: A métrica 'Exceções' contabiliza a telemetria de exceção recebida pelo portal no intervalo de amostragem do gráfico. Isto inclui as exceções tratadas que são relatadas por sua instrumentação. Pode não incluir exceções não tratadas.

Onde posso obter mais informações sobre contadores de desempenho .NET ASP?

Para obter diretrizes de métricas atuais, consulte Métricas no Application Insights.

Contadores de eventos .NET ASP

Posso ver o EventCounters no Live Metrics?

As métricas ao vivo não mostram EventCounters. Use o Metric Explorer ou o Analytics para ver a telemetria.

Depois que habilitei o Application Insights do portal do Azure Web App, por que não consigo ver contadores de eventos?

No momento, o monitoramento do Serviço de Aplicativo sem alterações de código não dá suporte a esse recurso para ASP.NET Core.

Onde posso obter mais informações sobre contadores de eventos asp.NET?

Para obter diretrizes de métricas atuais, consulte Métricas no Application Insights.

acompanhamento de dependência

Como o coletor de dependências automáticas reporta chamadas com falha para as dependências?

As chamadas de dependência com falha têm o campo success definido como false. A telemetria de dependências não cria automaticamente um item de exceção separado para cada chamada de dependência com falha. O modelo de dados completo para telemetria de dependência é descrito no modelo de dados de telemetria do Application Insights.

Como calcular a latência de ingestão para a minha telemetria de dependência?

Use este código:

dependencies
| extend E2EIngestionLatency = ingestion_time() - timestamp
| extend TimeIngested = ingestion_time()

Como posso determinar quando a chamada de dependência foi iniciada?

Na exibição de consulta Log Analytics, timestamp representa o momento em que a operação de telemetria de dependência foi iniciada, que ocorre imediatamente após o recebimento da resposta de chamada de dependência. Para calcular a hora em que a chamada de dependência começou, você pegaria timestamp e subtrairia o duration registrado da chamada de dependência.

O acompanhamento de dependência no Application Insights inclui corpos de resposta de registro em log?

O acompanhamento de dependências no Application Insights não inclui corpos de resposta de registro em log, porque isso geraria um excesso de telemetria para a maioria dos aplicativos.

Onde posso obter mais informações sobre o acompanhamento de dependências no Application Insights?

Para obter as diretrizes de dependência e de intervalo personalizado atuais, consulte Adicionar intervalos personalizados.

Testes de disponibilidade

Posso executar testes de disponibilidade em um servidor de intranet?

Os testes de disponibilidade são executados em pontos de presença distribuídos em todo o mundo. Existem duas soluções:

  • Porta do firewall: permita solicitações a seu servidor da lista extensa e mutável dos agentes de teste da Web.
  • Código personalizado: grave seu próprio código para enviar solicitações periódicas ao seu servidor a partir da sua intranet. Você pode executar Visual Studio testes web para essa finalidade. Emitir um sinal interno de integridade e gerar um alerta no log ou na métrica resultante.

O que é a cadeia de caracteres do agente de usuário para testes de disponibilidade?

A cadeia de caracteres do agente de usuário é Mozilla/5.0 (compatível; MSIE 9.0; Windows NT 6.1; Trident/5.0; AppInsights)

Onde posso obter mais informações sobre testes de disponibilidade do Application Insights?

Para obter mais informações, consulte testes de disponibilidade.

Suporte do TLS para testes de disponibilidade

Como a substituição afeta meu comportamento de teste na Web?

Os testes de disponibilidade atuam como um cliente distribuído em cada um dos locais de teste da Web com suporte. Sempre que um teste na Web é executado, o serviço de teste de disponibilidade tenta entrar em contato com o ponto de extremidade remoto definido na configuração de teste da Web. Uma mensagem “Olá” do cliente TLS é enviada contendo toda a configuração TLS com suporte no momento. Se o ponto de extremidade remoto compartilhar uma configuração TLS comum com o cliente de teste de disponibilidade, o handshake do TLS terá êxito. Caso contrário, o teste da Web falhará com uma falha de handshake do TLS.

Como posso validar qual configuração de TLS é suportada por um ponto de extremidade remoto?

Há várias ferramentas disponíveis para testar qual configuração de TLS um ponto de extremidade dá suporte. Uma maneira seria seguir o exemplo detalhado nesta página. Se o ponto de extremidade remoto não estiver disponível pela Internet pública, você precisará garantir a validação da configuração TLS suportada no ponto de extremidade remoto a partir de um computador que tenha acesso para chamar seu ponto de extremidade.

Observação

Para obter as etapas para habilitar a configuração de TLS necessária em seu servidor Web, é melhor entrar em contato com a equipe que possui a plataforma de hospedagem em que o servidor Web é executado se o processo não for conhecido.

Após 1° de maio de 2025, qual será o comportamento de teste na web para os testes afetados?

Não há um tipo de exceção com o qual todas as falhas de handshake do TLS afetadas por essa substituição se apresentariam. No entanto, a exceção mais comum com a qual o teste da Web começaria a falhar seria The request was aborted: Couldn't create SSL/TLS secure channel. Você também deve ser capaz de ver quaisquer falhas relacionadas ao TLS no TLS Transport Troubleshooting Step para o resultado do teste web que é potencialmente afetado.

Posso exibir qual configuração do TLS está sendo usada no momento pelo meu teste na Web?

A configuração do TLS negociada durante uma execução de teste da Web não pode ser exibida. Desde que o ponto de extremidade remoto dê suporte à configuração TLS comum com testes de disponibilidade, nenhum impacto deve ser visto após a substituição.

Quais componentes a substituição afeta no serviço de teste de disponibilidade?

A preterição do TLS detalhada nesse documento só deve afetar o comportamento de execução do teste web de disponibilidade após 1° de maio de 2025. Para obter mais informações sobre como interagir com o serviço de teste de disponibilidade para operações CRUD, consulte Suporte TLS do Azure Resource Manager. Esse recurso fornece mais detalhes sobre os prazos de suporte e descontinuação do TLS.

Onde posso obter suporte ao TLS?

Em caso de dúvidas gerais sobre o problema herdado do TLS, consulte Solução de problemas de TLS.

Onde posso obter mais informações sobre o suporte do TLS para testes de disponibilidade?

Para obter mais informações, consulte as configurações de TLS com suporte.

Monitoramento em Serviço de Aplicativo do Azure para aplicativos .NET, Node.js, Python e Java

O que o Application Insights modifica no meu projeto?

As alterações dependem da rota de instrumentação. Normalmente, o monitoramento do Serviço de Aplicativo sem código usa configurações de aplicativo e configuração de plataforma. O monitoramento baseado em código usa o pacote OpenTelemetry e a configuração de inicialização para o idioma selecionado. Para obter diretrizes atuais, consulte Ativar o monitoramento de aplicativos no Serviço de Aplicativo do Azure e Habilitar OpenTelemetry com o Application Insights.

Qual é a diferença entre as métricas padrão do Application Insights versus as métricas de Serviço de Aplicativo do Azure?

O Application Insights coleta a telemetria das solicitações que chegaram no aplicativo. Se a falha ocorrer no Aplicativos Web ou no servidor Web e a solicitação não tiver alcançado o aplicativo de usuário, o Application Insights não terá telemetria sobre ele.

A duração de serverresponsetime calculada pelo Application Insights não corresponde necessariamente ao tempo de resposta do servidor observado por Aplicativos Web. O Application Insights conta a duração quando a solicitação atinge o aplicativo do usuário. Se a solicitação estiver paralisada ou enfileirada no servidor Web, o tempo de espera será incluído nas métricas de Aplicativos Web, mas não nas métricas do Application Insights.

Onde posso obter mais informações sobre monitoramento em Serviço de Aplicativo do Azure para aplicativos .NET, Node.js, Python e Java?

Para obter mais informações, consulte Enable application monitoring in Serviço de Aplicativo do Azure.

Instrumentação automática

O termo "autoinstrumentação" deve ser hifenizado?

Seguimos o Guia de Estilo da Microsoft para a documentação de produtos publicada na plataforma Microsoft Learn.

Em geral, não incluímos um hífen após o prefixo "auto".

Onde posso obter mais informações sobre autoinstrumentação?

Para obter mais informações, consulte O que é a autoinstrumentação para Azure Monitor Application Insights?.

Cadeias de conexão

Novas regiões de Azure exigem o uso de cadeias de conexão?

Novas regiões do Azure exigem o uso de cadeias de conexão em vez de chaves de instrumentação. Connection string identifica o recurso que você deseja associar aos dados de telemetria. Ela também permite modificar os pontos de extremidade que o recurso usa como um destino para a telemetria. Copie o cadeia de conexão e adicione-o ao código do aplicativo ou a uma variável de ambiente.

Devo usar cadeias de conexão ou chaves de instrumentação?

Recomendamos usar cadeias de conexão em vez de chaves de instrumentação.

Quando preciso definir a variável de ambiente?

Defina manualmente APPLICATIONINSIGHTS_CONNECTION_STRING em todos os cenários em que o sistema não o fornece automaticamente. Esses cenários incluem, mas não se limitam a: desenvolvimento local e .NET funções isoladas usando ASP.NET Core integração. Nesses casos, a variável de ambiente garante que o pipeline OpenTelemetry possa enviar telemetria para o Application Insights. Para obter mais informações sobre como configurar cadeias de conexão com uma variável de ambiente, consulte Configurando OpenTelemetry no Application Insights.

Devo usar um recurso separado do Application Insights para telemetria do navegador se eu usar ingestão autenticada do lado do servidor ou OTLP?

Não estritamente. Um único recurso do Application Insights pode receber telemetria do navegador do SDK JavaScript do Application Insights e telemetria do lado do servidor enviada usando ingestão autenticada, quando a autenticação local permanece habilitada para ingestão do navegador. A telemetria do lado do servidor pode usar a ingestão autenticada do Microsoft Entra e a ingestão OTLP usando o OpenTelemetry Collector requer autenticação do Microsoft Entra. Você não precisa evitar OpenTelemetry ou OTLP apenas porque seu aplicativo também coleta telemetria do navegador.

A principal exceção é quando você desativa a autenticação local em um recurso do Application Insights para exigir autenticação do Microsoft Entra para toda a ingestão. Nessa configuração, o SDK do JavaScript não pode se autenticar diretamente do navegador e a telemetria do navegador pode parar de fluir. Para telemetria do navegador nesse cenário, use um recurso de telemetria de navegador separado com autenticação local habilitada ou rotear a telemetria do navegador por meio de um padrão de proxy autenticado. Para obter mais informações, consulte a telemetria do navegador autenticado usando cadeias de conexão.

Mesmo quando um único recurso funciona tecnicamente, considere usar um recurso separado do Application Insights para telemetria do lado do cliente/navegador como uma prática recomendada de isolamento de risco. A instrumentação do navegador é executada em um ambiente de cliente não confiável, portanto, sua cadeia de conexão é visível para os usuários e não pode ser tratada como um segredo. Uma cadeia de conexão exposta pode potencialmente ser usada para enviar dados de telemetria falsificados, irrelevantes ou de alto volume para o recurso associado, o que pode poluir os painéis, alertas, consultas de solução de problemas e aumentar o custo de ingestão.

Um recurso de telemetria de navegador separado pode ajudá-lo:

  • Gire ou substitua a cadeia de conexão do lado do navegador sem interromper a telemetria do lado do servidor.
  • Contenha telemetria falsificada, spam ou lixo no recurso específico do navegador.
  • Proteja a qualidade da telemetria do lado do servidor usada para diagnóstico, alertas e análise operacional.
  • Aplique diferentes configurações de controle de acesso, propriedade ou governança quando necessário.

Equilibre esses benefícios com a sobrecarga adicional de gerenciamento de vários recursos, incluindo strings de conexão adicionais, atribuições de RBAC, configuração e investigações entre recursos. A correlação de ponta a ponta ainda pode funcionar em vários recursos do Application Insights quando o usuário tiver acesso aos recursos relevantes. Para obter mais informações, consulte o mapa do aplicativo e o diagnóstico de transação.

Link Privado e autenticação de ingestão de dados são controles separados. Link Privado controla o acesso à rede aos recursos do Azure Monitor; a autenticação do Microsoft Entra controla se a ingestão de telemetria é autorizada por uma identidade. Não use Link Privado como um substituto para a autenticação de ingestão e não trate a separação de recursos como um requisito para a ingestão autenticada do lado do servidor.

Como implementar um aplicativo web global para atender aos requisitos de conformidade de dados regionais?

Para atender aos requisitos de conformidade de dados regionais, use pontos de extremidade regionais do Application Insights em vez do ponto de extremidade global. O ponto de extremidade global não garante que os dados permaneçam em uma região específica. Pontos de extremidade regionais ajudam a garantir que a telemetria de usuários em áreas regulamentadas seja enviada apenas para datacenters nessas regiões.

Para configurar seu aplicativo Web global para conformidade regional:

  • Crie um recurso do Application Insights por região com requisitos de conformidade rigorosos, como a União Europeia ou o Estados Unidos.
  • Crie outro recurso do Application Insights para usuários em todas as outras regiões.
  • Configure seu aplicativo para enviar telemetria para o recurso apropriado do Application Insights com base na região de cada usuário. Determine a região usando sinais como endereço IP, metadados de conta ou configurações de local.
  • Conecte todos os recursos do Application Insights a um workspace do Log Analytics se precisar de uma experiência de consulta unificada entre regiões.

Por exemplo:

  • Enviar dados de usuários da Região A para o recurso Application Insights da Região A usando a cadeia de conexão da Região A.
  • Envie dados de usuários da Região B para o recurso Application Insights da Região B usando a cadeia de conexão da Região B.
  • Envie todos os outros dados do usuário para um recurso do Application Insights de uso geral usando uma cadeia de conexão diferente.

Importante

O uso do ponto de extremidade global não garante a conformidade regional. Para atender aos requisitos de residência de dados, sempre use pontos de extremidade específicos da região e rote a telemetria com base na região do usuário.

O diagrama a seguir mostra um exemplo de configuração para um aplicativo Web global:

Diagrama mostrando o roteamento com base na região para recursos específicos do App Insights.

Onde posso obter mais informações sobre cadeias de conexão no Application Insights?

Para saber mais, confira Cadeias de conexão.

Criando e configurando recursos do Application Insights

Como faço para mover um recurso do Application Insights para uma nova região?

Não há suporte para a transferência de recursos existentes do Application Insights entre regiões, e você não pode migrar dados históricos para uma nova região. A solução alternativa envolve:

  • Criando um novo recurso do Application Insights na região desejada.
  • Recriar quaisquer personalizações exclusivas do recurso original no novo.
  • Atualizar seu aplicativo com a cadeia de conexão do novo recurso de região.
  • Testar para garantir que tudo funcione conforme o esperado com o novo recurso do Application Insights.
  • Decidir manter ou excluir o recurso original do Application Insights. A exclusão de um recurso clássico significa perder todos os dados históricos. Se o recurso for baseado em espaço de trabalho, os dados permanecerão no Log Analytics, habilitando o acesso a dados históricos até que o período de retenção expire.

As personalizações exclusivas que normalmente precisam ser recriadas ou atualizadas manualmente para o recurso na nova região incluem, entre outros:

  • Recriar painéis personalizados e pastas de trabalho.
  • Recriar ou atualizar o escopo de quaisquer alertas de log/métrica personalizados.
  • Recriar alertas de disponibilidade.
  • Recrie quaisquer configurações personalizadas de controle de acesso baseadas em função Azure necessárias para que os usuários possam acessar o novo recurso.
  • Replicar as configurações que envolvem amostragem de ingestão, retenção de dados, limite diário e habilitação de métricas personalizadas. Essas configurações são controladas por meio do painel Uso e custos estimados.
  • Qualquer integração que dependa de chaves de API, como anotações de versão e canal de controle seguro do Live Metrics. Você precisa gerar novas chaves de API e atualizar a integração associada.
  • A exportação contínua em recursos clássicos deve ser configurada novamente.
  • As configurações de diagnóstico em recursos baseados em espaço de trabalho devem ser definidas novamente.

Posso usar provedores('Microsoft.Insights', 'components').apiVersions[0] nas minhas implantações do Azure Resource Manager?

Não é recomendável usar esse método de preenchimento da versão da API. A versão mais recente pode representar versões de visualização, que podem conter alterações interruptivas. Mesmo com versões mais recentes que não sejam de visualização, as versões da API nem sempre são compatíveis com versões anteriores de modelos existentes. Em alguns casos, a versão da API pode não estar disponível para todas as assinaturas.

Onde posso obter mais informações sobre como criar e configurar recursos do Application Insights?

Para obter mais informações, consulte Criar e configurar recursos do Application Insights.

Modelo de dados de telemetria

Como posso relatar problemas e sugestões de modelo de dados ou esquema?

Para relatar problemas e sugestões de modelo de dados ou esquema, use nosso GitHub repositório.

Como eu deveria medir o impacto de uma campanha de monitoramento?

A Telemetria de PageView inclui o URL e você pode analisar o parâmetro UTM usando uma função regex no Kusto.

Ocasionalmente, esses dados poderão estar ausentes ou ser imprecisos se o usuário ou a empresa desabilitar o envio do Agente do usuário nas configurações do navegador. O UA Parser regexes pode não incluir todas as informações do dispositivo. Ou o Application Insights pode não ter adotado as atualizações mais recentes.

Por que uma medida personalizada teria êxito sem erro, mas o log não aparece?

Isso pode ocorrer se você estiver usando valores de cadeia de caracteres. Somente valores numéricos funcionam com medidas personalizadas.

Onde posso obter mais informações sobre o modelo de dados de telemetria?

Para saber mais, confira o Modelo de dados de telemetria do Application Insights.

Registro em log com .NET

Que tipo de telemetria do Application Insights é produzido dos logs do ILogger? Onde posso ver os logs do ILogger no Application Insights?

Os registros de log OpenTelemetry são armazenados na tabela traces nos Logs do Application Insights. Para exibi-los no portal Azure, abra o recurso do Application Insights, selecione Logs e consulte a tabela traces.

Consulta de exemplo: traces | where message contains "YourSearchTerm".

Como eu posso personalizar a coleção de registros do ILogger?

Para aplicativos .NET atuais, configure a coleção de logs por meio do OpenTelemetry e da configuração de log de .NET padrão. Use Logging:LogLevel no appsettings.json para escolher os níveis de log do aplicativo e configurar a exportação de log do OpenTelemetry como parte da configuração do Azure Monitor OpenTelemetry. Veja Habilitar OpenTelemetry com o Application Insights e Modificar a Telemetria.

Por que alguns logs do ILogger não têm as mesmas propriedades do que outros?

Quando os logs são emitidos antes da conclusão da configuração de telemetria do aplicativo, eles podem ter menos propriedades enriquecidas do que os logs emitidos posteriormente no ciclo de vida do aplicativo.

Como devo enviar telemetria personalizada manualmente?

Para a instrumentação atual, envie a telemetria personalizada usando as APIs do OpenTelemetry ou a Distribuição do OpenTelemetry do Azure Monitor. Para obter exemplos, consulte Coletar telemetria personalizada.

Onde posso obter mais informações sobre o registro em log com o .NET?

Para saber mais sobre a instrumentação atual do .NET, consulte Habilitar OpenTelemetry com Application Insights.

Perfilador de Java

O que é a Criação de Perfil Java do Application Insights do Azure Monitor?

O Java Profiler usa o Java Flight Recorder (JFR) para criar o perfil do aplicativo usando uma configuração personalizada.

O que é o Java Flight Recorder?

O Java Flight Recorder (JFR) é uma ferramenta usada para coletar dados de criação de perfil de um aplicativo Java em execução. O JFR é integrado à Máquina Virtual Java (JVM) e é usado para solucionar problemas de desempenho. Saiba mais sobre o JFR Runtime do Java SE.

Quais são as implicações de preço e/ou taxa de licenciamento para habilitar a Criação de Perfil Java do App Insights?

A habilitação da Criação de Perfil Java é um recurso gratuito com o Application Insights. Os preços do Azure Monitor Application Insights são baseados no custo de ingestão de dados.

Quais informações de criação de perfil Java são coletadas?

Os dados da criação de perfil coletados pelo JFR incluem: dados de criação de perfil de método e execução, dados de coleta de lixo e perfis de bloqueio.

Como posso usar a Criação de Perfil Java do App Insights e visualizar os dados?

A gravação JFR pode ser exibida e analisada com sua ferramenta preferida, por exemplo, Java Mission Control (JMC).

O diagnóstico de desempenho e as recomendações de correção são fornecidos com a Criação de Perfil Java do App Insights?

O "Diagnóstico e recomendações de desempenho" é um nova funcionalidade que estará disponível em breve como Diagnóstico Java do Application Insights. Você pode se inscrever para obter a versão prévia desse recurso. A gravação do JFR pode ser exibida com o JMC (Java Mission Control).

Qual é a diferença entre a criação de perfil Java sob demanda e automática no App Insights?

A criação de perfil sob demanda é disparada pelo usuário em tempo real, enquanto a automática é feita com gatilhos pré-configurados.

Use Criar perfil agora para a opção de criação de perfil sob demanda. A função Criar perfil agora cria imediatamente o perfil de todos os agentes que estão anexados à instância do Application Insights.

A criação de perfil automatizada é disparada atingindo um limite de recurso.

Quais gatilhos de criação de perfil Java eu posso configurar?

Atualmente, o Agente Java do Application Insights dá suporte ao monitoramento do consumo de CPU e de memória. O limite da CPU é configurado como uma porcentagem de todos os núcleos disponíveis no computador. A memória é a ocupação atual da região de memória titular (OldGen) em relação ao tamanho máximo possível da região.

Quais são os pré-requisitos necessários para habilitar a Criação de Perfil Java?

Examine os pré-requisitos.

Posso usar a Criação de Perfil Java para um aplicativo de microsserviços?

Sim, você pode criar um perfil de uma JVM executando microsserviços usando o JFR.

Onde posso obter mais informações sobre o Java Profiler?

Para obter mais informações, consulte Azure Monitor Application Insights Profiler para Java.

Substituições de amostragem – Application Insights para Java

Preciso usar a instrumentação manual para habilitar substituições de amostragem?

Não, Substituições de Amostragem agora estão em disponibilidade geral (GA) e podem ser usadas tanto com autoinstrumentação quanto com instrumentação manual.

Como configurar Substituições de Amostragem ao usar o Serviço de Aplicativo do Azure com autoinstrumentação?

Se você usar a autoinstrumentação, atualize o arquivo applicationinsights.json no portal do Azure.

É necessário carregar manualmente o arquivo do agente do Application Insights para Substituições de Amostragem?

Para autoinstrumentação, nenhum upload manual de agente é necessário. No entanto, para instrumentação manual, você ainda precisa incluir o arquivo JAR do agente do Application Insights e os arquivos de configuração no pacote de implantação.

Qual é a diferença entre "desenvolvimento local" e "servidor de aplicativos" no contexto da instrumentação manual?

O desenvolvimento local refere-se ao ambiente em que o aplicativo está sendo criado ou testado, como um computador do desenvolvedor ou uma instância de Azure Cloud Shell. O servidor de aplicativos refere-se ao servidor Web que executa o aplicativo, como o Tomcat 11 em um App Service environment do Azure. Ao usar a instrumentação manual, você deve garantir que o arquivo JAR do agente seja colocado corretamente no servidor de aplicativos.

Se eu estiver usando um Serviço de Aplicativo do Azure com um ambiente de execução Java (por exemplo, Tomcat 11), como configurar as Substituições de Amostragem?

Para autoinstrumentação, você pode configurar Substituições de Amostragem por meio do portal do Azure. Se estiver usando a instrumentação manual, coloque o JAR do agente do Application Insights no diretório apropriado e inclua o arquivo applicationinsights.json com as configurações de amostragem desejadas.

Onde posso obter mais informações sobre substituições de amostragem?

Para obter mais informações, consulte As substituições de amostragem – Application Insights do Azure Monitor para Java.

Processadores de telemetria

Por que o processador de logs não processa logs que não fazem parte da instrumentação OpenTelemetry?

Os processadores do OpenTelemetry podem trabalhar com telemetria que transita pelo pipeline do OpenTelemetry. Logs ou arquivos gravados fora desse pipeline não são processados por processadores OpenTelemetry, a menos que você os colete explicitamente.

Onde posso obter mais informações sobre processadores de telemetria?

Para obter mais informações, consulte Telemetry processors (versão prévia) - Azure Monitor Application Insights para Java.

SDK do JavaScript

Quais são as contagens de sessão e usuário?

  • O SDK do JavaScript define um cookie de usuário no cliente Web para identificar os usuários que retornam e, um cookie de sessão para atividades de grupo.
  • Se não houver nenhum script do lado do cliente, você poderá definir cookies no servidor.
  • Se um usuário real usar seu site em diferentes navegadores, usar navegação em modo privado/anônimo ou usar diferentes máquinas, eles serão contados mais de uma vez.
  • Para identificar um usuário conectado entre computadores e navegadores, use o contexto de usuário autenticado do SDK do JavaScript ou defina o atributo OpenTelemetry enduser.id .

Qual é o desempenho/sobrecarga do SDK JavaScript?

O SDK do JavaScript Application Insights tem uma sobrecarga mínima em seu site. Com apenas 36 KB compressado com gzip e levando apenas em torno de 15 ms para inicializar, o SDK adiciona uma quantidade insignificante de tempo de carregamento ao seu site. Os componentes mínimos da biblioteca são rapidamente carregados quando você usa o SDK e o script completo é baixado em segundo plano.

Além disso, enquanto o script é baixado da CDN, todo o acompanhamento de sua página é enfileirado, para que você não perca nenhuma telemetria durante todo o ciclo de vida de sua página. Esse processo de instalação fornece à sua página um sistema de análise contínuo que é invisível para os usuários.

Quais navegadores têm suporte no SDK do JavaScript?

Chrome Firefox IE Opera Safari
Chrome Mais recente ✔ Firefox Mais recente✔ v3.x: IE 9+ e Microsoft Edge ✔
v2.x: IE 8+ compatível e o Microsoft Edge ✔		 Opera Mais recente ✔ Safari Mais recente✔

Onde posso encontrar exemplos de código para o SDK do JavaScript?

Para obter exemplos executáveis, consulte Application Insights JavaScript SDK samples.

Qual é a compatibilidade do ES3/Internet Explorer 8 com o SDK do JavaScript?

Precisamos tomar as medidas necessárias para garantir que este SDK continue a "funcionar" e não interrompa a execução do JavaScript quando carregado por um navegador mais antigo. Seria ideal não dar suporte a navegadores mais antigos, mas vários clientes grandes não podem controlar qual navegador seus usuários optam por usar.

Esta instrução não significa que daremos suporte apenas ao menor conjunto comum de funcionalidades. Precisamos manter a compatibilidade de código ES3. Novas funcionalidades precisam ser adicionadas de uma maneira que não interrompa a análise do JavaScript ES3, e que sejam adicionados como uma funcionalidade opcional.

Consulte GitHub para obter detalhes completos sobre o suporte Internet Explorer 8.

O SDK do JavaScript é de software livre?

Sim, o SDK do JavaScript do Application Insights é código aberto. Para ver o código-fonte ou contribuir com o projeto, consulte o repositório oficial do GitHub.

Onde posso obter mais informações sobre o SDK do JavaScript?

Para obter mais informações, consulte Habilitar Monitoramento Real do Usuário do Azure Monitor Application Insights.

Configuração de SDK do JavaScript

Como posso atualizar minha configuração de servidor de terceiros para o SDK do JavaScript?

O lado do servidor precisa ser capaz de aceitar conexões com esses cabeçalhos presentes. Dependendo da configuração Access-Control-Allow-Headers no lado do servidor, geralmente é necessário estender a lista do lado do servidor adicionando manualmente Request-Id, Request-Context e traceparent (cabeçalho distribuído W3C).

Controle de Acesso a Cabeçalhos Permitidos: Request-Id, traceparent, Request-Context e <your header>

Como posso desabilitar o rastreamento distribuído para o SDK do JavaScript?

O rastreamento distribuído pode ser desabilitado na configuração.

As respostas HTTP 502 e 503 sempre serão capturadas pelo Application Insights?

Não. Os erros "502 Gateway incorreto" e "503 Serviço indisponível" nem sempre são capturados pelo Application Insights. Se apenas o JavaScript do lado do cliente estiver sendo usado para monitoramento, esse comportamento será esperado, pois a resposta de erro é retornada antes da renderização da página que contém o cabeçalho HTML com o snippet de código JavaScript de monitoramento.

Se a resposta 502 ou 503 foi enviada de um servidor com o monitoramento do lado do servidor habilitado, os erros são coletados pelo SDK do Application Insights.

Mesmo quando o monitoramento do lado do servidor está habilitado no servidor Web de um aplicativo, às vezes um erro 502 ou 503 não é capturado pelo Application Insights. Muitos servidores Web modernos não permitem que um cliente se comunique diretamente. Em vez disso, eles utilizam soluções como proxies reversos para transmitir informações entre o cliente e os servidores Web front-end.

Nesse cenário, uma resposta 502 ou 503 pode ser retornada a um cliente devido a um problema na camada de proxy reverso, então ela não será capturada pelo Application Insights. Para ajudar a detectar problemas nessa camada, talvez seja necessário encaminhar logs do proxy reverso para o Log Analytics e criar uma regra personalizada para verificar se há respostas 502 ou 503. Para saber mais sobre as causas comuns dos erros 502 e 503, confiraSolucionar erros HTTP “502 Gateway incorreto” e “503 Serviço indisponível” no Serviço de Aplicativo do Azure.

Onde posso obter mais informações sobre a configuração do SDK do JavaScript?

Para obter mais informações, consulte a configuração do SDK do JavaScript do Application Insights.

Extensões da estrutura JavaScript

Como o Application Insights gera informações do dispositivo, como navegador, sistema operacional, linguagem e modelo?

O navegador passa a string do User-Agent no cabeçalho HTTP da solicitação. O serviço de ingestão do Application Insights usa UA Parser para gerar os campos que você vê nas tabelas de dados e experiências. Como resultado, os usuários do Application Insights não podem alterar esses campos.

Ocasionalmente, esses dados poderão estar ausentes ou ser imprecisos se o usuário ou a empresa desabilitar o envio do Agente do usuário nas configurações do navegador. O UA Parser regexes pode não incluir todas as informações do dispositivo. Ou o Application Insights pode não ter adotado as atualizações mais recentes.

Onde posso obter mais informações sobre extensões da estrutura JavaScript?

Para obter mais informações, consulte Habilitar uma extensão de estrutura para o SDK do JavaScript do Application Insights.

Workspaces gerenciados

Preciso atualizar scripts ou automação que referenciem recursos clássicos?

Não. Os modelos e as chamadas à API do ARM existentes continuam funcionando. Quando você tenta criar um recurso clássico, um recurso baseado em espaço de trabalho com gerenciamento é criado em vez disso.

Sou notificado antes que meu recurso seja migrado?

Não. A notificação para migrações de recursos individuais não está disponível. Para controlar quando e como seus recursos são migrados, use a migração manual.

Quanto tempo leva o processo de migração?

As migrações individuais geralmente são concluídas em menos de dois minutos. A distribuição completa ocorre ao longo de várias semanas em todas as regiões.

Como posso saber se um recurso é migrado?

Após a migração, o recurso é vinculado a um workspace do Log Analytics na página Visão Geral. O aviso clássico de retirada é removido, e a planilha de aposentadorias não lista mais o recurso.

Minha cobrança será alterada após a migração?

Normalmente, os custos permanecem semelhantes. O Application Insights baseado em workspace permite recursos de economia de custos e recomendamos revisar os planos de preços.

Se você estiver em um modelo de cobrança herdado, examine a documentação preços para obter detalhes.

Perco alertas ou testes de disponibilidade durante a migração?

Não. Todos os alertas, dashboards e testes de disponibilidade permanecem intactos e continuam funcionando após a migração.

Onde posso obter mais informações sobre workspaces gerenciados?

Para obter mais informações, consulte workspaces gerenciados no Application Insights.

Node.js

Como posso desabilitar a correlação de telemetria?

Para instrumentação atual, examine o rastreamento distribuído e a correlação de telemetria. Para obter a telemetria do navegador JavaScript, consulte a configuração do SDK do JavaScript.

Como posso configurar o nível de log desejado?

Para configurar o nível de log desejado que o Application Insights usará, use a variável de APPLICATIONINSIGHTS_INSTRUMENTATION_LOGGING_LEVEL ambiente. Os valores com suporte são NONE, ERROR, WARN, INFO, DEBUG, VERBOSE e ALL. Para obter mais informações, consulte ApplicationInsights-node.js.

Onde posso obter mais informações sobre como monitorar Node.js serviços e aplicativos com o Application Insights?

Para obter a instrumentação Node.js atual, consulte Habilitar OpenTelemetry com o Application Insights.

Azure Monitor OpenTelemetry

Onde posso encontrar uma lista de versões do SDK do Application Insights e respectivos nomes?

Uma lista de versões e nomes do SDK é hospedada no GitHub. Para obter mais informações, consulte SDK Version.

Onde posso obter mais informações sobre o OpenTelemetry?

Para obter mais informações, consulte Coletar telemetria com OpenTelemetry no Application Insights.

Migrar dos SDKs do .NET Application Insights para o OpenTelemetry do Azure Monitor

Onde posso obter diretrizes de migração?

Veja Migrar dos SDKs do Application Insights para o OpenTelemetry do Azure Monitor. Mantenha as diretrizes específicas de migração nessa página para que os artigos de configuração atuais possam continuar a apresentar um único caminho recomendado do OpenTelemetry.

Como faço para rastrear manualmente a telemetria usando o OpenTelemetry?

Use as APIs do OpenTelemetry e as APIs de log ou métricas específicas do idioma. Para obter exemplos, consulte Coletar telemetria personalizada.

Amostragem do OpenTelemetry

O amostrador personalizado do Application Insights é baseado na parte final?

O amostrador personalizado do Application Insights toma decisões de amostragem após a criação do intervalo, e não antes, portanto, ele não segue uma abordagem tradicional baseada em cabeçalho. Em vez disso, ele aplica decisões de amostragem no final da geração do intervalo—após a conclusão do intervalo, mas antes da exportação.

Embora esse comportamento se assemelhe à amostragem baseada na parte final em alguns aspectos, o amostrador não espera coletar vários intervalos do mesmo rastreamento antes de tomar a decisão. Em vez disso, ele usa um hash do ID de rastreamento para ajudar a garantir a completude do rastreamento.

Essa abordagem equilibra a integridade e a eficiência do rastreamento e evita o custo mais alto associado à amostragem completa baseada na parte final.

Para tomar decisões de amostragem com base no resultado de um rastreamento inteiro (por exemplo, determinar se ocorreu uma falha em algum intervalo dentro do rastreamento), é necessária uma amostragem completa baseada na parte final em um agente ou um coletor downstream. No momento, não há suporte para essa funcionalidade, mas você pode solicitá-la como um novo recurso por meio do hub Feedback.

Como o amostrador personalizado do Application Insights se compara à amostragem baseada em cabeça ou em cauda do OpenTelemetry?

Método de amostragem Ponto de decisão Pontos fortes Fraquezas
Baseado na cabeça Antes de um período começar Baixa latência, sobrecarga mínima Pode amostrar os rastreamentos desejados, incluindo falhas
Baseado na cauda Depois que os intervalos são armazenados em buffer com base em limites de tempo ou volume Permite critérios de amostragem de rastreamento altamente seletivos Custo mais alto e atraso de processamento adicionado
Azure Monitor amostrador personalizado Fim da geração de intervalo Equilibra a integridade do rastreamento com a eficiência Necessário para compatibilidade de métricas dinâmicas

Posso amostrar dependências, solicitações ou outros tipos de telemetria em taxas diferentes?

Não, o amostrador aplica uma taxa fixa em todos os tipos de telemetria em um rastreamento. Solicitações, dependências e outros intervalos seguem a mesma porcentagem de amostragem. Para aplicar taxas diferentes por tipo de telemetria, considere usar os processadores de span do OpenTelemetry ou [transformações no momento da ingestão][app-insights-overview.md#telemetry-routing].

Como o sampler personalizado do Application Insights propaga as decisões de amostragem?

O amostrador personalizado do Application Insights propaga decisões de amostragem usando o padrão W3C Trace Context por padrão. Esse padrão permite que as decisões de amostragem fluam entre os serviços. Entretanto, como o amostrador toma decisões de amostragem no final da geração do intervalo—após a chamada para serviços downstream—a propagação carrega informações de amostragem incompletas. Essa limitação está em conformidade com a especificação de Contexto de Rastreamento do W3C, mas os serviços downstream não podem usar de forma confiável essa decisão de amostragem propagada.

O amostrador personalizado do Application Insights respeita as decisões de amostragem dos serviços upstream?

Não, o sampler personalizado do Application Insights sempre toma uma decisão de amostragem independente, mesmo que o serviço upstream use o mesmo algoritmo de amostragem. As decisões de amostragem de serviços upstream, incluindo aqueles que usam cabeçalhos de contexto de rastreamento do W3C, não influenciam a decisão do serviço downstream. No entanto, ele faz a amostragem com base em um hash da ID do rastreamento para garantir a integridade do rastreamento. Para aprimorar a consistência e reduzir a chance de rastreamentos interrompidos, configure todos os componentes no sistema para usar o mesmo amostrador e taxa de amostragem.

Por que alguns rastreamentos aparecem incompletos mesmo ao usar o sampler personalizado do Application Insights?

Há vários motivos pelos quais os rastreamentos podem aparecer incompletos:

  • Diferentes nós em um sistema distribuído usam abordagens distintas de amostragem que não coordenam decisões. Por exemplo, um nó aplica a amostragem baseada em cabeçalho do OpenTelemetry, e outro nó aplica a amostragem por meio do amostrador personalizado do Azure Monitor.
  • Nós diferentes são definidos para taxas de amostragem diferentes, mesmo que ambos usem a mesma abordagem de amostragem.
  • Você define limites de filtragem, amostragem ou taxa no pipeline do lado do serviço, e essa configuração faz a amostragem aleatória de intervalos sem considerar a integridade do rastreamento.

Se um componente aplicar amostragem baseada em cabeçalho sem propagar a decisão de amostragem (por meio de cabeçalhos de contexto de rastreamento do W3C), os serviços downstream amostrarão o rastreamento de forma independente, o que pode resultar em intervalos descartados. Como resultado, algumas partes do rastreamento nem sempre estão disponíveis quando exibidas no Application Insights.

Como o amostrador personalizado do Application Insights funciona junto com a amostragem de ingestão?

A amostragem de ingestão descarta apenas o que atinge o serviço, portanto, ela não pode contrariar ou substituir as decisões do sampler personalizado do Application Insights. Se ambos estiverem habilitados, a taxa efetiva será multiplicativa. Por exemplo, uma taxa de SDK de 20% combinada com uma taxa de ingestão de 50% resulta no armazenamento de cerca de 10% dos dados. A Microsoft recomenda fazer a amostragem na fonte com o amostrador Azure Monitor OpenTelemetry para manter os rastreamentos intactos e previsíveis, utilizando a amostragem de ingestão apenas como um recurso alternativo.

Onde posso obter mais informações sobre a amostragem OpenTelemetry?

Para obter mais informações, consulte Amostragem no Azure Monitor Application Insights com OpenTelemetry.

Suporte e comentários do OpenTelemetry

O que é o OpenTelemetry?

É um padrão de software livre para observabilidade. Saiba mais em OpenTelemetry.

Por que o Microsoft Azure Monitor está investindo no OpenTelemetry?

A Microsoft está investindo no OpenTelemetry pelos seguintes motivos:

  • É neutro em relação a fornecedores e fornece APIs/SDKs consistentes entre diferentes linguagens.
  • Com o tempo, acreditamos que o OpenTelemetry permitirá que os clientes do Azure Monitor observem aplicativos escritos em idiomas além de nossos idiomas suportados.
  • Ele expande os tipos de dados que podem ser coletados por meio de um conjunto avançado de bibliotecas de instrumentação.
  • Os Software Development Kits (SDKs) do OpenTelemetry são projetados para telemetria neutra em relação ao fornecedor e de desempenho eficiente em escala.
  • OpenTelemetry se alinha à estratégia da Microsoft para adotar o código aberto.

Qual é o status do OpenTelemetry?

Confira Status do OpenTelemetry.

Qual é o distro Azure Monitor OpenTelemetry?

Você pode pensar nisso como um wrapper fino que agrupa todos os componentes OpenTelemetry para uma experiência de primeira classe em Azure. Esse wrapper também é chamado de distribuição no OpenTelemetry.

Por que devo usar o Azure Monitor OpenTelemetry Distro?

Há várias vantagens em usar a Distribuição OpenTelemetry do Azure Monitor em relação ao OpenTelemetry nativo da comunidade:

No espírito do OpenTelemetry, projetamos a distribuição para ser aberta e extensível. Por exemplo, você pode adicionar:

  • Um exportador do Protocolo OpenTelemetry (OTLP) e enviar para um segundo destino simultaneamente
  • Outras bibliotecas de instrumentação não incluídas na distribuição

Como a Distribuição oferece uma distribuição do OpenTelemetry, ela suporta tudo o que é suportado pelo OpenTelemetry. Por exemplo, você pode adicionar mais processadores de telemetria, exportadores ou bibliotecas de instrumentação se o OpenTelemetry der suporte a eles.

Para idiomas sem um exportador autônomo do OpenTelemetry com suporte, a Distribuição do OpenTelemetry para Azure Monitor é atualmente a única maneira com suporte para usar o OpenTelemetry com o Azure Monitor. Para idiomas com um exportador OpenTelemetry autônomo com suporte, você tem a opção de usar o Azure Monitor OpenTelemetry Distro ou o exportador OpenTelemetry autônomo apropriado, dependendo do cenário de telemetria. Para obter mais informações, consulte Quando devo usar o exportador Azure Monitor OpenTelemetry?.

Devo usar o OpenTelemetry para novos projetos do Application Insights?

Sim. É recomendável usar o Azure Monitor OpenTelemetry Distro para novos projetos.

Se você estiver migrando um aplicativo .NET ou Node.js existente de SDKs mais antigos do Application Insights, consulte Igrate de SDKs do Application Insights para Azure Monitor OpenTelemetry.

Quando devo usar o exportador Azure Monitor OpenTelemetry?

Para ASP.NET Core, Java, Node.jse Python, recomendamos usar a Distribuição Azure Monitor OpenTelemetry. É uma linha de código para começar.

Para todos os outros cenários .NET, incluindo ASP.NET clássico, aplicativos de console, Windows Forms (WinForms), etc., recomendamos usar o exportador .NET do Azure Monitor OpenTelemetry: Azure.Monitor.OpenTelemetry.Exporter.

Para cenários de telemetria do Python mais complexos que exigem configuração avançada, recomendamos usar o Azure Monitor OpenTelemetry Exporter do Python.

Qual é o estado atual de lançamento dos recursos na distribuição Azure Monitor OpenTelemetry?

Distribuições do OpenTelemetry do Azure Monitor são compatíveis com o caminho de instrumentação atual recomendado do Application Insights.

Para obter os detalhes mais recentes sobre experiências de code analysis, consulte .NET Profiler e Snapshot Debugger.

O OpenTelemetry pode ser usado para navegadores da Web?

Sim, mas não recomendamos e Azure não dá suporte. O Javascript do OpenTelemetry é altamente otimizado para Node.js. Nesse caso, recomendamos usar o SDK do JavaScript do Application Insights.

Quando podemos esperar que o SDK do OpenTelemetry esteja disponível para uso em navegadores da Web?

O SDK da Web do OpenTelemetry não tem uma linha do tempo de disponibilidade determinada. Deve demorar alguns anos para algum SDK de navegador ser uma alternativa viável ao SDK do JavaScript do Application Insights.

Posso testar o OpenTelemetry em um navegador da Web hoje?

O OpenTelemetry Web Sandbox é um fork projetado para fazer o OpenTelemetry funcionar em um navegador. Ainda não é possível enviar telemetria para o Application Insights. O SDK não define eventos gerais do cliente.

Há suporte para a execução do Application Insights junto com agentes concorrentes, como o AppDynamics, DataDog e NewRelic?

Essa prática não é algo que planejamos testar ou oferecer suporte, embora nossas distribuições permitam que você exporte para um ponto de extremidade OTLP junto com o Azure Monitor simultaneamente.

Posso usar versão prévia do recurso em ambientes de produção?

Não recomendamos isso. Consulte os termos suplementares de uso para visualizações do Microsoft Azure.

Posso usar o Coletor do OpenTelemetry?

Alguns clientes usam o Coletor do OpenTelemetry como uma alternativa de agente, embora a Microsoft ainda não dê suporte oficial a uma abordagem baseada em agente para o monitoramento de aplicativos. Enquanto isso, a comunidade de software livre contribuiu com um OpenTelemetry Collector Azure Monitor Export que alguns clientes estão usando para enviar dados para Azure Monitor Application Insights. Isso não tem suporte da Microsoft.

No Grafana, por que vejo "Status 500. Não é possível visualizar eventos de rastreamento usando o visualizador de rastreamento"?

Você pode estar tentando visualizar logs de texto bruto em vez de rastreamentos do OpenTelemetry.

No Application Insights, a tabela "Traces" armazena logs de texto bruto para fins de diagnóstico. Eles ajudam a identificar e correlacionar rastreamentos associados a solicitações de usuários, outros eventos e relatórios de exceções. No entanto, a tabela "Traces" não contribui diretamente para a visualização da transação de ponta a ponta (gráfico em cascata) em ferramentas de visualização como o Grafana.

Com a crescente adoção de práticas nativas da nuvem, há uma evolução na coleta e na terminologia de telemetria. OpenTelemetry tornou-se um padrão para coleta e instrumentação de dados de telemetria. Nesse contexto, o termo "Traços" ganhou um novo significado. Em vez de logs brutos, 'Traces' no OpenTelemetry referem-se a uma forma de telemetria mais rica e estruturada que inclui spans, que representam unidades individuais de trabalho. Esses intervalos são cruciais para a construção de visualizações detalhadas de transações, permitindo melhor monitoramento e diagnóstico de aplicativos nativos da nuvem.

Como devo instrumentar os aplicativos Blazor?

Para instrumentar um aplicativo Blazor, primeiro identifique o modelo de hospedagem. O Blazor Server dá suporte à instrumentação completa baseada em OpenTelemetry. O Blazor WebAssembly é executado no navegador e dá suporte à instrumentação limitada por meio do JavaScript.

Visão geral do dashboard

Posso exibir mais de 30 dias de dados?

Não, existe um limite de 30 dias de dados exibidos em um painel.

Estou vendo um erro de "recurso não encontrado" no painel.

Um erro de "recurso não encontrado" pode ocorrer se você mover ou renomear sua instância do Application Insights.

Para contornar esse comportamento, exclua o painel padrão e selecione novamente o Painel de Aplicativos para criar um painel novo.

Onde posso obter mais informações sobre o painel visão geral?

Para obter mais informações, consulte Painel de visão geral do Application Insights.

Canais de telemetria

O Application Insights garante a entrega de telemetria?

Os exportadores e os SDKs do OpenTelemetry geralmente usam a entrega de melhor esforço. A telemetria ainda poderá ser perdida se um aplicativo falhar, o processo for encerrado antes que a telemetria pendente seja exportada, o armazenamento não estiver disponível ou as interrupções de rede e serviço durarem além dos limites de repetição. Para obter o comportamento atual do OpenTelemetry, consulte armazenamento offline e novas tentativas automáticas.

O SDK cria armazenamento local temporário? Os dados são criptografados no armazenamento?

Alguns exportadores e SDKs atuais podem criar armazenamento local temporário durante problemas de rede ou controle de fluxo. O armazenamento temporário local não é criptografado pelo Application Insights, portanto, proteja qualquer diretório configurado. Para obter o comportamento atual do OpenTelemetry, consulte armazenamento offline e novas tentativas automáticas.

Onde posso obter mais informações sobre o comportamento de entrega de telemetria?

Para obter o comportamento atual de repetição e armazenamento do OpenTelemetry, consulte a configuração do OpenTelemetry.

Pesquisa

Que quantidade de dados é mantida?

Confira o resumo de Limites.

Como consultar dados de POSTAGEM nas minhas solicitações de servidor?

Não registramos dados POST automaticamente. Use o registro de logs do aplicativo cuidadosamente se precisar capturar os detalhes do corpo da solicitação e evite coletar dados confidenciais.

Por que minha pesquisa de função Azure não retorna resultados?

Azure Functions não registra cadeias de caracteres de consulta de URL.

Onde posso obter mais informações sobre a Pesquisa?

Para obter mais informações, consulte Pesquisa e Diagnóstico.

Diagnóstico da transação

Por que vejo apenas um componente no gráfico e os outros componentes são exibidos apenas como dependências externas sem detalhes?

Motivos possíveis:

  • Os outros componentes são instrumentados com Application Insights?
  • Eles estão usando o SDK estável mais recente do Application Insights?
  • Se esses componentes forem recursos separados do Application Insights, verifique se você tem acesso. Se você tiver acesso e os componentes estiverem instrumentados com os SDKs mais recentes do Application Insights, avise-nos através do canal de comentários no canto superior direito.

Eu vejo linhas duplicadas para as dependências. Esse comportamento é esperado?

No momento, estamos mostrando a chamada de dependência de saída separada da solicitação de entrada. Normalmente, as duas chamadas parecem idênticas, apenas o valor da duração sendo diferente devido à viagem de ida e volta da rede. O ícone principal e o estilo distinto das barras de duração ajudam a diferenciá-las. Essa apresentação dos dados está confusa? Envie-nos seus comentários!

O que significa o relógio distorcer entre instâncias do componente diferentes?

As linhas do tempo são ajustadas para as distorções do relógio no gráfico de transações. É possível visualizar os carimbos de data/hora exatos no painel de detalhes ou usando o Log Analytics.

Por que na nova experiência está faltando a maioria das consultas de itens relacionados?

Esse comportamento é por design. Todos os itens relacionados, em todos os componentes, já estão disponíveis no lado esquerdo, nas seções superior e inferior. A nova experiência tem dois itens relacionados que o lado esquerdo não abrange: toda a telemetria de cinco minutos antes e depois desse evento e a linha do tempo do usuário.

Há uma maneira de ver menos eventos por transação quando uso o SDK do Application Insights para JavaScript?

A experiência de diagnóstico de transação mostra toda a telemetria em uma única operação que compartilha uma ID da Operação. Por padrão, o SDK do Application Insights para JavaScript cria uma operação para cada exibição de página exclusiva. Em um SPA (aplicativo de página única), somente um evento de exibição de página é gerado e apenas uma ID de operação é usada para todas as telemetrias geradas. Como resultado, muitos eventos podem estar correlacionados com a mesma operação.

Nesses cenários, você pode usar o Acompanhamento de Rota Automático para criar automaticamente novas operações de navegação em seu SPA. Você deve ativar o enableAutoRouteTracking para que uma visualização de página seja gerada sempre que a rota de URL for atualizada (uma visualização lógica de página ocorre). Se você quiser atualizar manualmente a ID da operação, chame appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId(). O disparo manual de um evento PageView também redefinirá a ID da operação.

Por que as durações dos detalhes da transação não são somadas à duração da solicitação superior?

O tempo não explicado no gráfico de Gantt é o tempo que não é coberto por uma dependência rastreada. Esse problema pode ocorrer porque as chamadas externas não foram instrumentadas, seja automaticamente ou manualmente. Também pode ocorrer porque o tempo gasto estava em processo, em vez de por causa de uma chamada externa.

Se todas as chamadas foram instrumentadas, em andamento é a causa raiz provável para o tempo gasto. Uma ferramenta útil para diagnosticar o processo é o .NET Profiler.

E se eu vir a mensagem "Erro ao recuperar dados" ao navegar pelo Application Insights no Azure portal?

Esse erro indica que o navegador não pôde chamar uma API exigida ou a API retornou uma resposta de falha. Para solucionar o comportamento, abra uma janela InPrivate do navegador e desabilite todas as extensões do navegador em execução e identifique se você ainda pode reproduzir o comportamento do portal. Se o erro do portal ainda ocorrer, tente testar com outros navegadores ou outros computadores, investigue o DNS ou outros problemas relacionados à rede do computador cliente em que as chamadas à API estão falhando. Se o erro do portal continuar e precisar de mais investigação, colete um rastreamento de rede do navegador ao reproduzir o comportamento inesperado do portal e, em seguida, abra um caso de suporte no portal Azure.

Onde posso obter mais informações sobre o Diagnóstico de Transação?

Para obter mais informações, consulte Investigar falhas, desempenho e transações com o Application Insights.

Análise de uso

O evento inicial representa a primeira vez que o evento aparece em uma sessão ou sempre que aparece em uma sessão?

O evento inicial em visualização representa apenas a primeira vez que um usuário enviou essa exibição de página ou evento personalizado durante uma sessão. Se os usuários podem enviar o evento inicial várias vezes em uma sessão, a coluna Etapa 1 mostra apenas como os usuários se comportam após a primeira instância de um evento inicial e não de todas as instâncias.

Alguns dos nós na minha visualização têm um nível muito alto. Como posso obter nós mais detalhados?

Use as opções Dividir por no menu Editar:

  1. Selecione o evento que você deseja dividir no menu Evento.

  2. Selecione uma dimensão no menu Dimensão. Por exemplo, se você tiver um evento chamado Botão clicado, tente uma propriedade personalizada chamada Nome do botão.

Defini uma coorte de usuários de um determinado país/região. Quando comparo essa coorte na ferramenta Usuários para definir um filtro nesse país/região, por que estou vendo resultados diferentes?

Coortes e filtros são diferentes. Suponha que você tenha uma coorte de usuários do Reino Unido (definidos como no exemplo anterior) e compare os resultados com uma configuração do filtro Country or region = United Kingdom:

  • A versão de coorte mostra todos os eventos de usuários que enviaram um ou mais eventos do Reino Unido no período atual. Se você dividir por país ou região, provavelmente verá muitos países e regiões.

  • A versão dos filtros mostra apenas eventos do Reino Unido. Se você dividir por país ou região, verá apenas o Reino Unido.

Como posso exibir os dados em diferentes níveis de granularidade (diário, mensal ou semanal)?

Você pode selecionar o filtro Granularidade de Datas para alterar a granularidade. O filtro está disponível em todas as guias de dimensão.

Captura de tela que mostra o filtro para mudar a granularidade de datas para diário, mensal ou semanal na pasta de trabalho.

Como faço para acessar informações no meu aplicativo que não estão disponíveis nas pastas de trabalho HEART?

Você poderá se aprofundar nos dados que alimentam a pasta de trabalho HEART se os visuais não responderem a todas as suas dúvidas. Para realizar essa tarefa, na seção de Monitoring no Application Insights, selecione Logs e consulte a tabela customEvents. Alguns dos atributos do Click Analytics estão contidos no campo customDimensions.

Uma consulta de exemplo é mostrada aqui:

customEvents
| where isnotnull(customDimensions.actionType)
| extend parentid=tostring(customDimensions.parenId),
pagename=tostring(customDimensions.pageName),
actiontype=tostring(customDimensions.actionType)
| project actiontype,parentid,pagename,
user_AuthenticatedId,user_Id,session_Id,itemType,timestamp

Para saber mais sobre os Logs no Azure Monitor, consulte Visão geral dos Logs do Azure Monitor.

Posso editar elementos visuais na pasta de trabalho?

Sim. Para saber como editar modelos de pasta de trabalho, consulte Azure modelos de pastas de trabalho.

Onde posso obter mais informações sobre a análise de uso?

Para obter mais informações, consulte Análise de uso com o Application Insights.

Aplicativos do Serviço de Trabalho

Qual pacote eu devo usar?

Para aplicativos de serviço do trabalho atuais, use o Exportador ou Distribuições do OpenTelemetry do Azure Monitor. Veja Habilitar OpenTelemetry com Application Insights.

Como posso acompanhar a telemetria que não é coletada automaticamente?

Para instrumentação atual, use APIs OpenTelemetry e APIs de registro em log ou métricas específicas do idioma. Para obter exemplos, consulte Coletar telemetria personalizada.

Para eventos personalizados do navegador, use o SDK javaScript do Application Insights ou o Click Analytics. Para eventos personalizados do lado do servidor, use eventos personalizados OpenTelemetry.

Posso habilitar o monitoramento do Application Insights sem alterar o código do aplicativo?

Para novo monitoramento de aplicativos, use Distribuições do OpenTelemetry do Azure Monitor ou os caminhos atuais de autoinstrumentação. Consulte Habilitar o OpenTelemetry com o Application Insights e o monitoramento de aplicativos sem alterações de código.

Se eu executar meu aplicativo no Linux, todos os recursos terão suporte?

O suporte a funcionalidades depende do idioma, do ambiente de hospedagem e do caminho de instrumentação. Para obter suporte atual, comece com Habilitar OpenTelemetry com o Application Insights e o artigo de configuração relevante específico para o idioma.

Onde posso obter mais informações sobre aplicativos do Serviço de Trabalho?

Para obter a instrumentação de serviço de trabalho atual, consulte Habilitar OpenTelemetry com o Application Insights.

  • Last updated on