Modelo de dados telemétricos no Application Insights

O Application Insights envia telemetria do seu aplicativo Web para o portal do Azure para que você possa analisar o desempenho e o uso do seu aplicativo. O modelo de telemetria é padronizado, por isso é possível criar monitoramento independente de plataforma e linguagem.

Os dados coletados pelo Application Insights modelam esse padrão típico de execução de aplicativos.

Os seguintes tipos de telemetria são usados para monitorar a execução do seu aplicativo. O SDK do Application Insights da estrutura do aplicativo Web coleta automaticamente estes três tipos:

• Solicitação: gerada para registrar uma solicitação recebida pelo seu aplicativo. Por exemplo, o SDK da Web do Application Insights gera automaticamente um item de telemetria de solicitação para cada solicitação HTTP que seu aplicativo Web recebe.

  Uma operação é composta pelos threads de execução que processam uma solicitação. Você também pode escrever código para monitorar outros tipos de operação, como um "despertar" em um trabalho da Web ou função que processa dados periodicamente. Cada operação tem um ID. A ID pode ser usada para agrupar toda a telemetria gerada enquanto seu aplicativo está processando a solicitação. Cada operação é bem-sucedida ou falha e tem uma duração de tempo.

• Exceção: normalmente representa uma exceção que faz com que uma operação falhe.

• Dependência: representa uma chamada do seu aplicativo para um serviço ou armazenamento externo, como uma API REST ou SQL. No ASP.NET, as chamadas de dependência para SQL são definidas por System.Data. As chamadas para pontos de extremidade HTTP são definidas por System.Net.

O Application Insights fornece três tipos de dados para telemetria personalizada:

• Rastreamento: usado diretamente ou por meio de um adaptador para implementar o log de diagnóstico usando uma estrutura de instrumentação que lhe é familiar, como Log4Net ou System.Diagnostics.
• Evento: normalmente usado para capturar a interação do usuário com seu serviço para analisar padrões de uso.
• Métrica: Usada para relatar medições escalares periódicas.

Cada item de telemetria pode definir as informações de contexto, como a versão do aplicativo ou o ID da sessão do usuário. Contexto é um conjunto de campos fortemente tipados que desbloqueia determinados cenários. Quando a versão do aplicativo é inicializada corretamente, o Application Insights pode detetar novos padrões no comportamento do aplicativo correlacionados com a reimplantação.

Você pode usar a ID de sessão para calcular uma interrupção ou um problema de impacto nos usuários. O cálculo da contagem distinta de valores de ID de sessão para uma dependência com falha, rastreamento de erro ou exceção crítica específica oferece uma boa compreensão de um impacto.

O modelo de telemetria do Application Insights define uma maneira de correlacionar a telemetria à operação da qual ela faz parte. Por exemplo, uma solicitação pode fazer uma chamada do Banco de dados SQL e registrar informações de diagnóstico. Você pode definir o contexto de correlação para os itens de telemetria que o vinculam à telemetria de solicitação.

Melhorias no esquema

O modelo de dados do Application Insights é uma maneira básica, mas poderosa, de modelar a telemetria do seu aplicativo. Nós nos esforçamos para manter o modelo simples e fino para suportar cenários essenciais e permitir que o esquema seja estendido para uso avançado.

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

Pedir

Um item de telemetria de solicitação no Application Insights representa a sequência lógica de execução acionada por uma solicitação externa ao seu aplicativo. Cada execução de solicitação é identificada por um único id e url que contém todos os parâmetros de execução.

Você pode agrupar solicitações por lógica name e definir a source dessa solicitação. A execução de código pode resultar em success ou fail e tem um certo duration. Você pode agrupar ainda mais execuções de sucesso e falha usando resultCodeo . A hora de início da telemetria de solicitação é definida no nível do envelope.

A telemetria de solicitação suporta o modelo de extensibilidade padrão usando personalizado properties e measurements.

Nota

A 31 de março de 2025, o suporte da ingestão de chaves de instrumentação terminará. A ingestão de chaves de instrumentação continuará a funcionar, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar os novos recursos.

Nome

Este campo é o nome da solicitação e representa o caminho de código usado para processar a solicitação. Um baixo valor de cardinalidade permite um melhor agrupamento de solicitações. Para solicitações HTTP, ele representa o método HTTP e o modelo de caminho de URL como GET /values/{id} sem o valor real id .

O SDK da Web do Application Insights envia um nome de solicitação "como está" sobre maiúsculas e minúsculas. O agrupamento na interface do usuário diferencia maiúsculas de minúsculas, portanto GET /Home/Index , é contado separadamente, embora muitas vezes resulte no mesmo controlador e execução de GET /home/INDEX ação. A razão para isso é que os URLs em geral diferenciam maiúsculas de minúsculas. Talvez você queira ver se todos os 404 erros aconteceram para URLs digitados em maiúsculas. Você pode ler mais sobre a coleta de nomes de solicitação pelo SDK da Web ASP.NET na postagem do blog.

Comprimento máximo: 1.024 caracteres

ID

ID é o identificador de uma instância de chamada de solicitação. Ele é usado para correlação entre a solicitação e outros itens de telemetria. O ID deve ser globalmente exclusivo. Para obter mais informações, consulte Correlação de telemetria no Application Insights.

Comprimento máximo: 128 caracteres

URL

URL é a URL de solicitação com todos os parâmetros de cadeia de caracteres de consulta.

Comprimento máximo: 2.048 caracteres

Origem

A fonte é a fonte do pedido. Exemplos são a chave de instrumentação do chamador ou o endereço IP do chamador. Para obter mais informações, consulte Correlação de telemetria no Application Insights.

Comprimento máximo: 1.024 caracteres

Duração

A duração da solicitação é formatada como DD.HH:MM:SS.MMMMMM. Deve ser positivo e menos de 1000 dias. Este campo é obrigatório porque a telemetria de solicitação representa a operação com o início e o fim.

Código de resposta

O código de resposta é o resultado de uma execução de solicitação. É o código de status HTTP para solicitações HTTP. Pode ser um HRESULT valor ou um tipo de exceção para outros tipos de solicitação.

Comprimento máximo: 1.024 caracteres

Com êxito

Êxito indica se uma chamada foi bem-sucedida ou não. Este campo é obrigatório. Quando uma solicitação não é definida explicitamente como false, ela é considerada bem-sucedida. Se uma exceção ou um código de resultado de erro retornado interrompeu a operação, defina esse valor como false.

Para aplicativos Web, o Application Insights define uma solicitação como bem-sucedida quando o código de resposta é menor 400 ou igual a 401. No entanto, há casos em que esse mapeamento padrão não corresponde à semântica do aplicativo.

O código 404 de resposta pode indicar "sem registros", o que pode fazer parte do fluxo regular. Também pode indicar um link quebrado. Para links quebrados, você pode implementar uma lógica mais avançada. Você pode marcar links quebrados como falhas somente quando esses links estiverem localizados no mesmo site, analisando o referenciador de URL. Ou você pode marcá-los como falhas quando forem acessados pelo aplicativo móvel da empresa. Da mesma forma, 301 e 302 indicar falha quando eles são acessados a partir do cliente que não suporta redirecionamento.

O conteúdo 206 parcialmente aceito pode indicar uma falha de uma solicitação geral. Por exemplo, um ponto de extremidade do Application Insights pode receber um lote de itens de telemetria como uma única solicitação. Ele retorna 206 quando alguns itens do lote não foram processados com êxito. Uma taxa crescente de 206 indica um problema que precisa ser investigado. Lógica semelhante se aplica a 207 Multi-Status, onde o sucesso pode ser o pior dos códigos de resposta separados.

Propriedades personalizadas

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para estender a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria, como o número do pedido.

• Comprimento máximo da chave: 150
• Comprimento máximo do valor: 8,192

Medidas personalizadas

Coleção de medidas personalizadas: use esta coleção para relatar medidas nomeadas associadas ao item de telemetria. Os casos de uso típicos são:

• O tamanho da carga útil da telemetria de dependência.
• O número de itens de fila processados por telemetria de solicitação.
• O tempo que um cliente levou para concluir a etapa do assistente concluindo a telemetria de eventos.

Você pode consultar medidas personalizadas no Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

• As medidas personalizadas estão associadas ao item de telemetria ao qual pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medições. Para controlar uma medição que tenha um valor independente de outros tipos de telemetria, use a telemetria métrica.
• Não use valores de cadeia de caracteres para medições personalizadas. Apenas valores numéricos são suportados.

Comprimento máximo da chave: 150

Dependency

A telemetria de dependência (no Application Insights) representa uma interação do componente monitorado com um componente remoto, como SQL ou um ponto de extremidade HTTP.

Nome

Este campo é o nome do comando iniciado com esta chamada de dependência. Tem um baixo valor de cardinalidade. Exemplos são o nome do procedimento armazenado e o modelo de caminho de URL.

ID

ID é o identificador de uma instância de chamada de dependência. Ele é usado para correlação com o item de telemetria de solicitação que corresponde a essa chamada de dependência. Para obter mais informações, consulte Correlação de telemetria no Application Insights.

Dados

Este campo é o comando iniciado por esta chamada de dependência. Exemplos são instrução SQL e URL HTTP com todos os parâmetros de consulta.

Type

Este campo é o nome do tipo de dependência. Tem um baixo valor de cardinalidade para agrupamento lógico de dependências e interpretação de outros campos como commandName e resultCode. Exemplos são SQL, tabela do Azure e HTTP.

Destino

Este campo é o site de destino de uma chamada de dependência. Exemplos são o nome do servidor e o endereço do host. Para obter mais informações, consulte Correlação de telemetria no Application Insights.

Duração

A duração do pedido está no formato DD.HH:MM:SS.MMMMMM. Deve ser inferior a 1000 dias.

Código de resultado

Este campo é o código de resultado de uma chamada de dependência. Exemplos são o código de erro SQL e o código de status HTTP.

Com êxito

Este campo é a indicação de uma chamada bem-sucedida ou malsucedida.

Propriedades personalizadas

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para estender a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria, como o número do pedido.

• Comprimento máximo da chave: 150
• Comprimento máximo do valor: 8,192

Medidas personalizadas

Coleção de medidas personalizadas: use esta coleção para relatar medidas nomeadas associadas ao item de telemetria. Os casos de uso típicos são:

• O tamanho da carga útil da telemetria de dependência.
• O número de itens de fila processados por telemetria de solicitação.
• O tempo que um cliente levou para concluir a etapa do assistente concluindo a telemetria de eventos.

Você pode consultar medidas personalizadas no Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

• As medidas personalizadas estão associadas ao item de telemetria ao qual pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medições. Para controlar uma medição que tenha um valor independente de outros tipos de telemetria, use a telemetria métrica.
• Não use valores de cadeia de caracteres para medições personalizadas. Apenas valores numéricos são suportados.

Comprimento máximo da chave: 150

Exceção

No Application Insights, uma instância de exceção representa uma exceção manipulada ou não tratada que ocorreu durante a execução do aplicativo monitorado.

ID do problema

O ID do problema identifica onde a exceção foi lançada no código. É usado para agrupamento de exceções. Normalmente, é uma combinação de um tipo de exceção e uma função da pilha de chamadas.

Comprimento máximo: 1.024 caracteres

Nível de gravidade

Este campo é o nível de severidade do rastreio. O valor pode ser Verbose, Information, Warning, Error, ou Critical.

Detalhes da exceção

(A prorrogar)

Propriedades personalizadas

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para estender a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria, como o número do pedido.

• Comprimento máximo da chave: 150
• Comprimento máximo do valor: 8,192

Medidas personalizadas

Coleção de medidas personalizadas: use esta coleção para relatar medidas nomeadas associadas ao item de telemetria. Os casos de uso típicos são:

• O tamanho da carga útil da telemetria de dependência.
• O número de itens de fila processados por telemetria de solicitação.
• O tempo que um cliente levou para concluir a etapa do assistente concluindo a telemetria de eventos.

Você pode consultar medidas personalizadas no Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

• As medidas personalizadas estão associadas ao item de telemetria ao qual pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medições. Para controlar uma medição que tenha um valor independente de outros tipos de telemetria, use a telemetria métrica.
• Não use valores de cadeia de caracteres para medições personalizadas. Apenas valores numéricos são suportados.

Comprimento máximo da chave: 150

Rastreio

A telemetria de rastreamento no Application Insights representa printfinstruções de rastreamento no estilo que são pesquisadas em texto. Log4Net, NLoge outras entradas de arquivo de log baseadas em texto são convertidas em instâncias desse tipo. O traço não tem medidas como extensibilidade.

Mensagem

Mensagem de rastreamento.

Comprimento máximo: 32.768 caracteres

Nível de gravidade

Nível de severidade do rastreio.

Valores: Verbose, Information, Warning, Error, e Critical

Propriedades personalizadas

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para estender a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria, como o número do pedido.

• Comprimento máximo da chave: 150
• Comprimento máximo do valor: 8,192

Evento

Você pode criar itens de telemetria de eventos (no Application Insights) para representar um evento que ocorreu em seu aplicativo. Normalmente, é uma interação do usuário, como um clique no botão ou um checkout de pedido. Também pode ser um evento do ciclo de vida do aplicativo, como inicialização ou uma atualização de configuração.

Semanticamente, os eventos podem ou não estar correlacionados a solicitações. Se usada corretamente, a telemetria de eventos é mais importante do que solicitações ou rastreamentos. Os eventos representam telemetria empresarial e devem ser sujeitos a amostragens separadas e menos agressivas.

Nome

Nome do evento: para permitir o agrupamento adequado e métricas úteis, restrinja seu aplicativo para que ele gere alguns nomes de eventos separados. Por exemplo, não use um nome separado para cada instância gerada de um evento.

Comprimento máximo: 512 caracteres

Propriedades personalizadas

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para estender a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria, como o número do pedido.

• Comprimento máximo da chave: 150
• Comprimento máximo do valor: 8,192

Medidas personalizadas

Coleção de medidas personalizadas: use esta coleção para relatar medidas nomeadas associadas ao item de telemetria. Os casos de uso típicos são:

• O tamanho da carga útil da telemetria de dependência.
• O número de itens de fila processados por telemetria de solicitação.
• O tempo que um cliente levou para concluir a etapa do assistente concluindo a telemetria de eventos.

Você pode consultar medidas personalizadas no Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Nota

• As medidas personalizadas estão associadas ao item de telemetria ao qual pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medições. Para controlar uma medição que tenha um valor independente de outros tipos de telemetria, use a telemetria métrica.
• Não use valores de cadeia de caracteres para medições personalizadas. Apenas valores numéricos são suportados.

Comprimento máximo da chave: 150

Metric

O Application Insights suporta dois tipos de telemetria métrica: medição única e métrica pré-agregada. Uma única medida é apenas um nome e um valor. A métrica pré-agregada especifica o valor mínimo e máximo da métrica no intervalo de agregação e o desvio padrão do mesmo.

A telemetria métrica pré-agregada assume que o período de agregação foi de um minuto.

O Application Insights suporta vários nomes de métricas bem conhecidos. Essas métricas são colocadas na performanceCounters tabela.

A tabela a seguir mostra as métricas que representam os contadores do sistema e do processo.

Nome do .NET	Nome agnóstico da plataforma	Description
\Processor(_Total)\% Processor Time	Trabalhos em curso...	CPU total da máquina.
\Memory\Available Bytes	Trabalhos em curso...	Mostra a quantidade de memória física, em bytes, disponível para processos em execução no computador. É calculado somando a quantidade de espaço nas listas de memória zero, livre e em espera. A memória livre está pronta para uso. A memória zerada consiste em páginas de memória preenchidas com zeros para impedir que processos posteriores vejam dados usados por um processo anterior. Memória em espera é a memória que foi removida do conjunto de trabalho de um processo (sua memória física) a caminho do disco, mas ainda está disponível para ser recuperada. Consulte Objeto de memória.
\Process(??APP_WIN32_PROC??)\% Processor Time	Trabalhos em curso...	CPU do processo que hospeda o aplicativo.
\Process(??APP_WIN32_PROC??)\Private Bytes	Trabalhos em curso...	Memória usada pelo processo que hospeda o aplicativo.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Trabalhos em curso...	Taxa de operações de E/S executadas pelo processo que hospeda o aplicativo.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Trabalhos em curso...	Taxa de pedidos processados por uma aplicação.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Trabalhos em curso...	Taxa de exceções lançadas por um aplicativo.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Trabalhos em curso...	Tempo médio de execução da solicitação.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Trabalhos em curso...	Número de solicitações aguardando o processamento em uma fila.

Para obter mais informações sobre a API REST de métricas, consulte Métricas - obter.

Nome

Este campo é o nome da métrica que você deseja ver no portal e na interface do usuário do Application Insights.

Value

Este campo é o único valor para medição. É a soma de medidas individuais para a agregação.

Count

Este campo é o peso métrico da métrica agregada. Não deve ser definido para uma medição.

Min

Este campo é o valor mínimo da métrica agregada. Não deve ser definido para uma medição.

Máx

Este campo é o valor máximo da métrica agregada. Não deve ser definido para uma medição.

Desvio padrão

Este campo é o desvio padrão da métrica agregada. Não deve ser definido para uma medição.

Propriedades personalizadas

A métrica com a propriedade CustomPerfCounter personalizada definida como true indica que a métrica representa o contador de desempenho do Windows. Essas métricas são colocadas na performanceCounters tabela, não em customMetrics. Além disso, o nome dessa métrica é analisado para extrair nomes de categoria, contador e instância.

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para estender a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria, como o número do pedido.

• Comprimento máximo da chave: 150
• Comprimento máximo do valor: 8,192

PageView

A telemetria PageView (no Application Insights) é registrada quando um usuário do aplicativo abre uma nova página de um aplicativo monitorado. O Page neste contexto é uma unidade lógica que é definida pelo desenvolvedor como sendo uma guia de aplicativo ou uma tela e não está necessariamente correlacionada a um carregamento de página da Web do navegador ou uma ação de atualização. Essa distinção pode ser ainda mais compreendida no contexto de aplicativos de página única (SPAs), onde a alternância entre páginas não está vinculada às ações da página do navegador. O pageViews.duration é o tempo que o aplicativo leva para apresentar a página ao usuário.

Nota

• Por padrão, os SDKs do Application Insights registram eventos únicos PageView em cada ação de carregamento de página da Web do navegador, com pageViews.duration o preenchimento por tempo do navegador. Os desenvolvedores podem estender o acompanhamento adicional de eventos usando a chamada da PageView API trackPageView.
• A retenção de logs padrão é de 30 dias. Se pretender visualizar PageView estatísticas durante um período de tempo mais longo, tem de ajustar a definição.

Meça o browserTiming no Application Insights

Os navegadores modernos expõem medidas para ações de carregamento de página com a API de desempenho. O Application Insights simplifica essas medições consolidando os tempos relacionados em métricas padrão do navegador, conforme definido por estas definições de tempo de processamento:

• Cliente <--> DNS: O cliente entra em contato com o DNS para resolver o nome de host do site e o DNS responde com o endereço IP.

• Cliente <--> Servidor Web: O cliente cria TCP e, em seguida, aperta os handshakes TLS com o servidor Web.

• Cliente <--> Servidor Web: O cliente envia a carga útil da solicitação, aguarda que o servidor execute a solicitação e recebe o primeiro pacote de resposta.

• Cliente <--Servidor Web: O cliente recebe o restante dos bytes de carga útil de resposta do servidor Web.

• Cliente: O cliente agora tem carga útil de resposta completa e tem que renderizar o conteúdo no navegador e carregar o DOM.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = #3

• browserTimings/receiveDuration = #4

• browserTimings/processingDuration = #5

• browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

• pageViews/duration

  • A PageView duração é a partir da interface de tempo de desempenho do navegador, PerformanceNavigationTiming.duration.

  • Se PerformanceNavigationTiming estiver disponível, essa duração é usada.

    Se não for, a interface preterida PerformanceTiming é usada e o delta entre NavigationStart e LoadEventEnd é calculado.

  • O desenvolvedor especifica um valor de duração ao registrar eventos personalizados PageView usando a chamada da API trackPageView.

Contexto

Cada item de telemetria pode ter um campo de contexto fortemente tipado. Cada campo permite um cenário de monitoramento específico. Use a coleção de propriedades personalizadas para armazenar informações contextuais personalizadas ou específicas do aplicativo.

Versão do aplicativo

As informações nos campos de contexto do aplicativo são sempre sobre o aplicativo que está enviando a telemetria. A versão do aplicativo é usada para analisar as mudanças de tendência no comportamento do aplicativo e sua correlação com as implantações.

Comprimento máximo: 1.024

Endereço IP do cliente

Este campo é o endereço IP do dispositivo cliente. São suportados IPv4 e IPv6. Quando a telemetria é enviada de um serviço, o contexto do local é sobre o usuário que iniciou a operação no serviço. O Application Insights extrai as informações de localização geográfica do IP do cliente e, em seguida, trunca-as. O IP do cliente por si só não pode ser usado como informação identificável do usuário.

Comprimento máximo: 46

Tipo de dispositivo

Originalmente, este campo foi usado para indicar o tipo de dispositivo que o usuário do aplicativo está usando. Hoje ele é usado principalmente para distinguir a telemetria JavaScript com o tipo Browser de dispositivo da telemetria do lado do servidor com o tipo PCde dispositivo .

Comprimento máximo: 64

ID da operação

Este campo é o identificador exclusivo da operação raiz. Esse identificador permite agrupar a telemetria em vários componentes. Para obter mais informações, consulte Correlação de telemetria. Uma solicitação ou um modo de exibição de página cria o ID da operação. Todas as outras telemetrias definem esse campo como o valor da solicitação que contém ou da exibição de página.

Comprimento máximo: 128

ID da operação pai

Este campo é o identificador exclusivo do pai imediato do item de telemetria. Para obter mais informações, consulte Correlação de telemetria.

Comprimento máximo: 128

Nome da operação

Este campo é o nome (grupo) da operação. Uma solicitação ou um modo de exibição de página cria o nome da operação. Todos os outros itens de telemetria definem esse campo como o valor da solicitação que contém ou da exibição de página. O nome da operação é usado para localizar todos os itens de telemetria de um grupo de operações (por exemplo, GET Home/Index). Esta propriedade context é usada para responder a perguntas como Quais são as exceções típicas lançadas nesta página?

Comprimento máximo: 1.024

Fonte sintética da operação

Este campo é o nome da fonte sintética. Alguma telemetria do aplicativo pode representar tráfego sintético. Pode ser o rastreador da Web indexando o site, testes de disponibilidade do site ou rastreamentos de bibliotecas de diagnóstico, como o próprio SDK do Application Insights.

Comprimento máximo: 1.024

ID da Sessão

ID de sessão é a instância da interação do usuário com o aplicativo. As informações nos campos de contexto da sessão são sempre sobre o usuário. Quando a telemetria é enviada de um serviço, o contexto da sessão é sobre o usuário que iniciou a operação no serviço.

Comprimento máximo: 64

ID de utilizador anónimo

O ID de usuário anônimo (User.Id) representa o usuário do aplicativo. Quando a telemetria é enviada de um serviço, o contexto do usuário é sobre o usuário que iniciou a operação no serviço.

A amostragem é uma das técnicas para minimizar a quantidade de telemetria coletada. Um algoritmo de amostragem tenta coletar amostras dentro ou fora de toda a telemetria correlacionada. Um ID de usuário anônimo é usado para a geração de pontuação de amostragem, portanto, um ID de usuário anônimo deve ser um valor aleatório o suficiente.

Nota

A contagem de IDs de usuário anônimos não é a mesma que o número de usuários exclusivos do aplicativo. A contagem de IDs de utilizadores anónimos é normalmente maior porque sempre que o utilizador abre a aplicação num dispositivo ou browser diferente ou limpa os cookies do browser, é atribuído um novo ID de utilizador anónimo exclusivo. Esse cálculo pode resultar na contagem dos mesmos usuários físicos várias vezes.

Os IDs de usuário podem ser cruzados com IDs de sessão para fornecer dimensões de telemetria exclusivas e estabelecer a atividade do usuário durante a duração de uma sessão.

Usar um ID de usuário anônimo para armazenar um nome de usuário é um uso indevido do campo. Use um ID de usuário autenticado.

Comprimento máximo: 128

ID de usuário autenticado

Um ID de usuário autenticado é o oposto de um ID de usuário anônimo. Este campo representa o usuário com um nome amigável. Essa ID só é coletada por padrão com o SDK do ASP.NET Framework .AuthenticatedUserIdTelemetryInitializer

Use o SDK do Application Insights para inicializar o ID de usuário autenticado com um valor que identifique o usuário persistentemente em navegadores e dispositivos. Dessa forma, todos os itens de telemetria são atribuídos a esse ID exclusivo. Esse ID permite consultar toda a telemetria coletada para um usuário específico (sujeito a configurações de amostragem e filtragem de telemetria).

Os IDs de usuário podem ser cruzados com IDs de sessão para fornecer dimensões de telemetria exclusivas e estabelecer a atividade do usuário durante a duração de uma sessão.

Comprimento máximo: 1.024

ID de conta

O ID da conta, em aplicativos multilocatário, é o ID da conta do locatário ou o nome com o qual o usuário está atuando. Ele é usado para mais segmentação de usuários quando um ID de usuário e um ID de usuário autenticado não são suficientes. Os exemplos podem ser uma ID de assinatura para o portal do Azure ou o nome do blog para uma plataforma de blog.

Comprimento máximo: 1.024

Função na nuvem

Este campo é o nome da função da qual o aplicativo faz parte. Ele mapeia diretamente para o nome da função no Azure. Ele também pode ser usado para distinguir micro serviços, que fazem parte de um único aplicativo.

Comprimento máximo: 256

Instância de função de cloud

Este campo é o nome da instância em que o aplicativo está sendo executado. Por exemplo, é o nome do computador para o local ou o nome da instância para o Azure.

Comprimento máximo: 256

Interna: versão do SDK

Para obter mais informações, consulte Versão do SDK.

Comprimento máximo: 64

Interna: Nome do nó

Este campo representa o nome do nó usado para fins de cobrança. Use-o para substituir a deteção padrão de nós.

Comprimento máximo: 256

Perguntas mais frequentes

Esta secção fornece respostas a perguntas comuns.

Como mediria o impacto de uma campanha de monitorização?

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

Ocasionalmente, esses dados podem estar ausentes ou imprecisos se o usuário ou a empresa desativar o envio do User Agent nas configurações do navegador. Os regexes do UA Parser podem 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 medição personalizada seria bem-sucedida sem erros, mas o log não aparece?

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

Próximos passos

Saiba como usar a API do Application Insights para eventos e métricas personalizados, incluindo:

• Telemetria de solicitação personalizada
• Telemetria de dependência personalizada
• Telemetria de rastreamento personalizada
• Telemetria de eventos personalizada
• Telemetria métrica personalizada

Configure o acompanhamento de dependência para:

• .NET
• Java

Para saber mais:

• Confira as plataformas suportadas pelo Application Insights.
• Confira a configuração padrão da coleção de propriedades de contexto.
• Explore os logs de rastreamento do .NET no Application Insights.
• Explore os logs de rastreamento Java no Application Insights.
• Saiba mais sobre a integração interna do Azure Functions com o Application Insights para monitorar execuções de funções.
• Saiba como configurar um aplicativo ASP.NET Core com o Application Insights.
• Saiba como diagnosticar exceções em seus aplicativos Web com o Application Insights.
• Saiba como estender e filtrar a telemetria.
• Use a amostragem para minimizar a quantidade de telemetria com base no modelo de dados.