Compartilhar via

Modelo de dados do Application Insights Telemetry

  • Artigo

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

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

Diagrama que mostra um modelo de dados telemétricos do Application Insights.

Os seguintes tipos de telemetria são usados para monitorar a execução de 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 Web do Application Insights gera automaticamente um item de telemetria da solicitação para cada solicitação HTTP que seu aplicativo Web recebe.

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

  • Exceção: normalmente representa uma exceção que causa falha em uma operação.

  • Dependência: representa uma chamada do aplicativo para um serviço ou armazenamento externo, como uma API REST ou SQL. No ASP.NET, chamadas de dependência para SQL são definidas por System.Data. 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 registro em 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 o serviço para analisar os padrões de uso.
  • Métrica: usada para relatar medidas escalares periódicas.

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

Você pode usar a ID da sessão para calcular uma interrupção ou problema que impacta os usuários. Calcular a contagem distinta de valores da ID de sessão para dependência com falha, rastreamento de erro ou exceção crítica específicas fornece a você uma boa compreensão de um impacto.

O modelo do telemetria do Application Insights define uma forma de correlacionar telemetria à operação da qual ele 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 esses itens de telemetria aproximam esse contexto novamente da telemetria de solicitação.

Aprimoramentos de esquema

O modelo de dados do Application Insights é uma maneira básica, mas poderosa de modelar a telemetria de aplicativo. Nos esforçamos para manter o modelo simples e reduzido para dar suporte a cenários essenciais e permitir que o esquema seja estendido para uso avançado.

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

Solicitação

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

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

A telemetria de solicitação dá suporte ao modelo de extensibilidade padrão usando properties e measurements personalizadas.

Observação

Em 31 de março de 31, 2025, o suporte à ingestão de chave de instrumentação será encerrado. A ingestão de chave de instrumentação continuará funcionando, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar as novas funcionalidades.

Nome

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

O SDK web do Application Insights envia um nome de solicitação “como está” em relação a diferenciar maiúsculas e minúsculas. O agrupamento na interface do usuário diferencia maiúsculas de minúsculas, então GET /Home/Index é contado separadamente de GET /home/INDEX, embora muitas vezes eles resultem na mesma execução de ação e de controlador. O motivo é que as URLs em geral diferenciam maiúsculas de minúsculas. Talvez você queira ver se todos os 404 erros ocorreram para as URLs digitadas em maiúsculas. Você pode ler mais sobre a coleção de nomes de solicitação de SDK web do ASP.NET na postagem no blog.

Comprimento máximo: 1.024 caracteres

ID

ID é o identificador de uma instância de chamada de solicitação. Ela é usada para a correlação entre a solicitação e outros itens de telemetria. A ID deve ser globalmente exclusiva. 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 consulta.

Comprimento máximo: 2.048 caracteres

Fonte

Origem é a origem da solicitação. Os 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

Duration

A duração da solicitação é formatada como DD.HH:MM:SS.MMMMMM. Deve ser positiva e menor que 1000 dias. Esse campo é obrigatório, pois 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 valor HRESULT ou um tipo de exceção para outros tipos de solicitação.

Comprimento máximo: 1.024 caracteres

Sucesso

Êxito indica se uma chamada foi bem-sucedida ou não. Esse 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 interromper 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 que 400 ou igual a 401. No entanto, há casos em que esse mapeamento padrão não corresponde com a semântica do aplicativo.

O código de resposta 404 pode indicar “nenhum registro”, o que pode ser parte do fluxo regular. Ele também pode indicar um link desfeito. Para os links desfeitos, é possível implementar lógica mais avançada. É possível marcar links desfeitos como falhas somente quando esses links estiverem localizados no mesmo site, analisando o referenciador da URL. Ou então, marcá-los como falhas quando acessados por aplicativos móveis da empresa. Da mesma forma, 301 e 302 indicam falha quando acessados do cliente que não dá suporte a redirecionamento.

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 no lote não foram processados com êxito. Uma taxa crescente de 206 indica um problema que precisa ser investigado. Uma lógica semelhante se aplica ao Status Múltiplo 207, em que o êxito pode ser o pior dos códigos de resposta separados.

Propriedades personalizadas

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

  • Comprimento máximo da chave: 150
  • Comprimento máximo do valor: 8.192

Medidas personalizadas

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

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

Você pode consultar medidas personalizadas na Análise do Aplicativo:

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

Observação

  • As medidas personalizadas são associadas ao item de telemetria ao qual estas pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medidas. Para controlar a medida que possui valor independente de outros tipos de telemetria, use telemetria de métrica.
  • Não use valores de cadeia de caracteres para medidas personalizadas. Há suporte apenas para valores numéricos.

Comprimento máximo da chave: 150

Dependência

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

Esse campo é o nome do comando iniciado com essa chamada de dependência. Ele tem um valor de baixa cardinalidade. Os exemplos são o nome do procedimento armazenado e o modelo do caminho da URL.

ID

ID é o identificador de uma instância de chamada de dependência. É 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

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

Tipo

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

Destino

Esse campo é o site de destino de uma chamada de dependência. Os 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 da solicitação está no formato DD.HH:MM:SS.MMMMMM. Ela deve ser menor que 1000 dias.

Código de Resultado

Esse campo é o código de resultado de uma chamada de dependência. Os exemplos são o código de erro do SQL e o código de status HTTP.

Êxito

Esse 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 ampliar a telemetria padrão com as dimensões personalizadas. São exemplos o slot de implantação que produziu a telemetria ou a propriedade específica do item de telemetria como o número da ordem.

  • Comprimento máximo da chave: 150
  • Comprimento máximo do valor: 8.192

Medidas personalizadas

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

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

Você pode consultar medidas personalizadas na Análise do Aplicativo:

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

Observação

  • As medidas personalizadas são associadas ao item de telemetria ao qual estas pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medidas. Para controlar a medida que possui valor independente de outros tipos de telemetria, use telemetria de métrica.
  • Não use valores de cadeia de caracteres para medidas personalizadas. Há suporte apenas para valores numéricos.

Comprimento máximo da chave: 150

Exceção

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

ID do Problema

A ID do problema identifica onde a exceção foi gerada no código. Ele é 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 severidade

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

Detalhes da exceção

(A ser estendido)

Propriedades personalizadas

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

  • Comprimento máximo da chave: 150
  • Comprimento máximo do valor: 8.192

Medidas personalizadas

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

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

Você pode consultar medidas personalizadas na Análise do Aplicativo:

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

Observação

  • As medidas personalizadas são associadas ao item de telemetria ao qual estas pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medidas. Para controlar a medida que possui valor independente de outros tipos de telemetria, use telemetria de métrica.
  • Não use valores de cadeia de caracteres para medidas personalizadas. Há suporte apenas para valores numéricos.

Comprimento máximo da chave: 150

Trace

A telemetria de rastreamento no Application Insights representa as instruções de rastreamento de estilo printf, que são pesquisadas em texto. Log4Net, NLog e outras entradas do arquivo de log baseadas em texto são convertidas em instâncias desse tipo. O rastreamento não possui medidas como extensibilidade.

Mensagem

Mensagem de rastreamento.

Comprimento máximo: 32.768 caracteres

Nível de severidade

Nível de severidade de rastreamento.

Valores: Verbose, Information, Warning, Error e Critical

Propriedades personalizadas

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

  • Comprimento máximo da chave: 150
  • Comprimento máximo do valor: 8.192

Evento

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

Semanticamente, eventos podem ou não ser correlacionados às solicitações. Se usada corretamente, a telemetria de eventos é mais importante que solicitações ou rastreamentos. Os eventos representam a telemetria de negócios e devem estar sujeitos a amostragem separada e menos agressiva.

Nome

Nome do evento: Para permitir um 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 à parte para cada instância gerado de um evento.

Comprimento máximo: 512 caracteres

Propriedades personalizadas

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

  • Comprimento máximo da chave: 150
  • Comprimento máximo do valor: 8.192

Medidas personalizadas

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

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

Você pode consultar medidas personalizadas na Análise do Aplicativo:

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

Observação

  • As medidas personalizadas são associadas ao item de telemetria ao qual estas pertencem. Eles estão sujeitos a amostragem com o item de telemetria que contém essas medidas. Para controlar a medida que possui valor independente de outros tipos de telemetria, use telemetria de métrica.
  • Não use valores de cadeia de caracteres para medidas personalizadas. Há suporte apenas para valores numéricos.

Comprimento máximo da chave: 150

Métrica

O Application Insights dá suporte a dois tipos de telemetria de métrica: medida única e métrica pré-agregada. A medida única é apenas um nome e valor. A métrica agregada previamente especifica os valores mínimo e máximo da métrica no intervalo de agregação e o desvio padrão desses valores.

A telemetria de métrica agregada previamente supõe que o período de agregação foi de um minuto.

O Application Insights dá suporte a vários nomes de métrica conhecidos. Essas métricas são colocadas na tabela performanceCounters.

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

Nome do .NET Nome independente da plataforma DESCRIÇÃO
\Processor(_Total)\% Processor Time Trabalho em andamento... Total de CPU do computador.
\Memory\Available Bytes Trabalho em andamento... 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 em espera, livre e zero. A memória livre está pronta para uso. A memória zero consiste em páginas de memória preenchidas com zeros para impedir que processos posteriores vejam os 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 recuperado. Consulte Objeto de Memória.
\Process(??APP_WIN32_PROC??)\% Processor Time Trabalho em andamento... CPU do processo que hospeda o aplicativo.
\Process(??APP_WIN32_PROC??)\Private Bytes Trabalho em andamento... Memória usada pelo processo que hospeda o aplicativo.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec Trabalho em andamento... Taxa de operações de E/S executadas pelo processo que hospeda o aplicativo.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec Trabalho em andamento... Taxa de solicitações processadas por um aplicativo.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Trabalho em andamento... Taxa de exceções geradas por um aplicativo.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time Trabalho em andamento... Tempo médio de execução da solicitação.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue Trabalho em andamento... Número de solicitações aguardando processamento em uma fila.

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

Nome

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

Valor

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

Contagem

Esse campo é o peso da métrica agregada. Ele não deve ser definido para uma medida.

Min

Esse campo é o valor mínimo da métrica agregada. Ele não deve ser definido para uma medida.

Max

Esse campo é o valor máximo da métrica agregada. Ele não deve ser definido para uma medida.

Desvio padrão

Esse campo é o desvio padrão da métrica agregada. Ele não deve ser definido para uma medida.

Propriedades personalizadas

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

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

  • Comprimento máximo da chave: 150
  • Comprimento máximo do valor: 8.192

PageView

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

Observação

  • Por padrão, os SDKs do Application Insights registram eventos individuais do PageView em cada ação de carregamento da página da Web do navegador, com pageViews.duration populado pelo tempo do navegador. Os desenvolvedores podem estender o acompanhamento adicional de eventos do PageView usando a chamada à API trackPageView.
  • A retenção de logs padrão é 30 dias. Se você quiser exibir estatísticas PageView por um período maior de tempo, deverá ajustar a configuração.

Medir browserTiming no Application Insights

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

  • Cliente<--> DNS: o cliente acessa o DNS para resolver o nome do host do site, e o DNS responde com o endereço IP.

  • Cliente<--> Servidor Web: o cliente cria handshakes TCP e TLS com o servidor Web.

  • Cliente<--> Servidor Web: o cliente envia o conteúdo da solicitação, aguarda o servidor executar a solicitação e recebe o primeiro pacote de resposta.

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

  • Cliente: o cliente agora tem o conteúdo de resposta completo e precisa 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

Captura de tela que mostra a página Métricas no Application Insights mostrando exibições gráficas de dados de métricas para um aplicativo Web.

Contexto

Cada item de telemetria pode ter um campo de contexto fortemente tipado. Cada campo habilita 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 de aplicativo sempre são sobre o aplicativo que está enviando a telemetria. A versão do aplicativo é usada para analisar as alterações de tendências no comportamento do aplicativo e sua correlação com as implantações.

Comprimento máximo: 1,024

Endereço IP do cliente

Esse campo é o endereço IP do dispositivo cliente. Há suporte para IPv4 e IPv6. Quando a telemetria é enviada de um serviço, o contexto de 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 as trunca. O IP do cliente não pode ser usado como informações de identificação do usuário.

Comprimento máximo: 46

Tipo de dispositivo

Originalmente, esse campo era usado para indicar o tipo do dispositivo que o usuário final do aplicativo estava usando. Hoje, é usado principalmente para distinguir a telemetria JavaScript com o tipo de dispositivo Browser da telemetria do lado do servidor com o tipo de dispositivo PC.

Comprimento máximo: 64

ID da Operação

Esse campo é o identificador exclusivo da operação raiz. Esse identificador permite a telemetria de agrupamento em vários componentes. Para obter mais informações, consulte Correlação de telemetria. Uma solicitação ou uma exibição de página cria a ID da operação. Toda a outra telemetria define esse campo como o valor para a solicitação que a contém ou a exibição de página.

Comprimento máximo: 128

ID de operação pai

Esse 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

Esse campo é o nome (grupo) da operação. Uma solicitação ou uma exibição de página cria o nome da operação. Todos os outros itens de telemetria definem esse campo como o valor para a solicitação que a contém ou uma 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). Essa propriedade de contexto é usada para responder a perguntas como "quais são as exceções típica lançadas nesta página?".

Comprimento máximo: 1,024

Origem sintética da operação

Esse campo é o nome da fonte sintética. Parte da telemetria do aplicativo pode representar o tráfego sintético. Pode ser o rastreador da Web que está indexando o site, testes de disponibilidade de site ou rastreamentos de bibliotecas de diagnóstico como o SDK do Application Insights em si.

Comprimento máximo: 1,024

ID da sessão

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

Comprimento máximo: 64

ID de usuário anônimo

A ID de usuário anônima (User.Id) representa o usuário do aplicativo. Quando a telemetria é enviada de um serviço, o contexto de 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 fazer a amostragem de toda a telemetria correlacionada. Uma ID de usuário anônima é usada para geração de pontuação de amostragem, portanto, uma ID de usuário anônima deve ser um valor aleatório o suficiente.

Observação

A contagem de IDs de usuário anônimas não é igual ao número de usuários exclusivos do aplicativo. A contagem de IDs de usuário anônimo normalmente é maior porque, sempre que o usuário abre o aplicativo em um dispositivo ou navegador diferente ou limpa os cookies do navegador, uma nova ID de usuário anônima exclusiva é alocada. Esse cálculo pode fazer com que os mesmos usuários físicos sejam contados várias vezes.

As IDs de usuário podem ter referência cruzada com IDs de sessão para fornecer dimensões de telemetria exclusivas e estabelecer a atividade do usuário pela duração de uma sessão.

O uso da ID de usuário anônima para armazenar o nome de usuário é um uso indevido do campo. Usar uma ID de usuário autenticada.

Comprimento máximo: 128

ID de usuário Autenticado

Uma ID de usuário autenticada é o oposto de uma ID de usuário anônima. Esse campo representa o usuário com um nome amigável. Essa ID é coletada apenas por padrão com o do SDK do Framework ASP.NET AuthenticatedUserIdTelemetryInitializer.

Use o SDK do Application Insights para inicializar a ID do usuário autenticada com um valor que identifica o usuário persistentemente entre navegadores e dispositivos. Dessa forma, todos os itens de telemetria são atribuídos a essa ID exclusiva. Essa ID permite consultar todas as telemetrias coletadas para um usuário específico (sujeito a configurações de amostragem e filtragem de telemetria).

As IDs de usuário podem ter referência cruzada com IDs de sessão para fornecer dimensões de telemetria exclusivas e estabelecer a atividade do usuário pela duração de uma sessão.

Comprimento máximo: 1,024

ID da Conta

A ID da conta, em aplicativos multilocatários, é a ID ou o nome da conta do locatário que o usuário está utilizando. É usada para mais segmentação de usuário quando a ID de usuário e a ID de usuário autenticado não são suficientes. Os exemplos podem ser uma ID da assinatura do portal do Azure ou o nome do blog de uma plataforma de blogs.

Comprimento máximo: 1,024

Função de nuvem

Esse campo é o nome da função da qual o aplicativo faz parte. Ele é mapeado diretamente para o nome da função no Azure. Também pode ser usado para distinguir microsserviços, que fazem parte de um único aplicativo.

Comprimento máximo: 256

Instância de função de nuvem

Esse 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 do Azure.

Comprimento máximo: 256

Interno: versão de SDK

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

Comprimento máximo: 64

Interno: nome do nó

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

Comprimento máximo: 256

Perguntas frequentes

Esta seção fornece respostas para perguntas comuns.

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

A Telemetria de Visualizações de Página 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. As expressões regulares do Analisador do agente do usuário 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 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.

Próximas etapas

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

Configurar o rastreamento de dependências para:

Para saber mais: