Modelo de dados do Application Insights Telemetry

O Application Insights envia telemetria de seu aplicativo Web para o portal do Azure para fornecer insights sobre o desempenho e o uso de seu aplicativo e infraestrutura. Para ajudá-lo a entender e organizar melhor os dados de telemetria, categorizamos-os em tipos distintos.

O modelo de dados de telemetria é padronizado, possibilitando a criação de monitoramento independente de plataforma e idioma. 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.

Os dados coletados pelos modelos do Application Insights são um padrão de execução típico do aplicativo:

¹availabilityResults não está disponível por padrão e exige que os testes de disponibilidade sejam configurados.
²customEvents e customMetrics só estão disponíveis com instrumentação personalizada.

Observação

O Application Insights armazena logs na tabela traces por motivos herdados. Os intervalos para rastreamentos distribuídos são armazenados nas tabelas requests e dependencies. Planejamos resolver isso em uma versão futura para evitar qualquer confusão.

Tipos de telemetria

Os seguintes tipos de telemetria são usados para monitorar a execução do aplicativo. A Distribuição OpenTelemetry do Azure Monitor e o SDK do JavaScript do Application Insights coletam:

Tipo de telemetria	Nome da tabela (Application Insights)	Nome da tabela (Análise de logs)	Descrição
Disponibilidade	availabilityResults	AppAvailabilityResults	Monitora a disponibilidade e a capacidade de resposta do aplicativo enviando solicitações da Web em intervalos regulares e alertando você se o aplicativo não estiver respondendo ou se o tempo de resposta for muito lento.
Tempo do navegador	browserTimings	AppBrowserTimings	Mede o desempenho de páginas da Web, incluindo tempos de carregamento de página e durações de rede.
Dependência	dependencies	AppDependencies	Rastreia chamadas de seu aplicativo para um serviço ou armazenamento externo, como uma API REST ou um banco de dados SQL, e mede a duração e o sucesso dessas chamadas.
Acontecimento	customEvents	AppEvents	Normalmente usado para capturar interações do usuário e outras ocorrências significativas em seu aplicativo, como cliques de botão ou check-outs de pedido, para analisar padrões de uso.
Exceção	exceptions	AppExceptions	Captura informações de erro cruciais para solução de problemas e compreensão de falhas.
Métrica	performanceCounters customMetrics	AppPerformanceCounters AppMetrics	Os contadores de desempenho fornecem dados numéricos sobre vários aspectos do desempenho do aplicativo e do sistema, como uso da CPU e consumo de memória. Além disso, as métricas personalizadas permitem que você defina e acompanhe medidas específicas exclusivas ao seu aplicativo, fornecendo flexibilidade para monitorar indicadores de desempenho personalizados.
Exibição de página	pageViews	AppPageViews	Controla as páginas exibidas pelos usuários, fornecendo insights sobre a navegação e o envolvimento do usuário em seu aplicativo.
Solicitação	requests	AppRequests	Registra solicitações recebidas pelo aplicativo, fornecendo detalhes como ID da operação, duração e êxito ou status de falha.
Rastreamento	traces	AppTraces	Registra eventos específicos do aplicativo, como mensagens de diagnóstico personalizadas ou instruções de rastreamento, que são úteis para depurar e monitorar o comportamento do aplicativo ao longo do tempo.

Importante

Você pode consultar a telemetria do aplicativo tanto do Application Insights quanto do Log Analytics (recomendado), mas os nomes de tabela e de campo são diferentes. Essa distinção preserva a compatibilidade com versões anteriores, por exemplo, para garantir que os painéis do cliente com consultas personalizadas criadas antes da convenção de nomenclatura do Log Analytics continuem funcionando corretamente.

Para comparar nomes de campo no portal do Azure, abraos Logs do Application Insights>, execute uma consulta e copie o Id item de telemetria (por exemplo, 1234a5b6c7de8f90). Em seguida, abra uma nova guia no navegador, vá para Log Analytics>Logs, alterne para o modo KQL e execute a consulta:

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

Expanda ambos os itens de telemetria selecionando a divisa à esquerda de cada linha para exibir todas as suas propriedades.

Cada item de telemetria pode incluir informações de contexto , como a versão do aplicativo ou a ID da sessão do usuário. O contexto consiste em um conjunto de campos fortemente tipados que permitem cenários de análise diferentes.

Por exemplo, quando a versão do aplicativo é inicializada corretamente, o Application Insights pode detectar novos padrões no comportamento do aplicativo correlacionados com a reimplantação. Da mesma forma, você pode usar a ID da sessão para avaliar o impacto de interrupções ou problemas nos usuários. Calculando o número de IDs de sessão únicas associadas a dependências com falha, rastros de erro ou exceções críticas, você obtém uma visão mais clara do impacto sobre o usuário.

O modelo de telemetria do Application Insights também dá suporte à correlação de itens de telemetria com as operações às quais pertencem. Por exemplo, se uma solicitação disparar uma chamada do Banco de Dados SQL, a solicitação e a chamada de dependência poderão incluir dados de diagnóstico e ser vinculadas por meio de um contexto de correlação compartilhado, permitindo que você rastreie o fluxo completo da operação.

Este artigo aborda os campos específicos para cada tipo de telemetria. Para exibir a lista completa de campos disponíveis (incluindo campos de contexto) para qualquer tipo de telemetria, siga o link fornecido abaixo de cada tabela relevante.

Telemetria de disponibilidade

A telemetria de disponibilidade envolve o monitoramento sintético, em que os testes simulam interações do usuário para verificar se o aplicativo está disponível e responsivo. Recomendamos configurar testes de disponibilidade padrão para monitorar a disponibilidade do aplicativo de vários pontos ao redor do mundo e enviar suas próprias informações de teste para o Application Insights.

Campos específicos de disponibilidade:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
id	Id	O identificador exclusivo de um resultado de teste de disponibilidade, usado para correlação entre execuções de teste individuais que podem ajudar a rastrear falhas ou padrões específicos ao longo do tempo. Para obter mais informações, consulte Correlação de telemetria no Application Insights.
name	Name	O nome de um teste de disponibilidade. Ele é definido ao criar o teste (por exemplo, "Teste de ping da página inicial").
location	Location	A localização geográfica ou a região do data center da qual um teste de disponibilidade foi executado (por exemplo, Oeste dos EUA, Norte da Europa). Ele ajuda a identificar interrupções regionais ou problemas de latência.
success	Success	Esse campo indica se um teste de disponibilidade foi bem-sucedido ou não. É um valor booliano em true que significa que o teste foi bem-sucedido e false significa que falhou.
message	Message	Uma mensagem descritiva com detalhes sobre o resultado do teste. Geralmente, ele contém detalhes de exceção ou respostas de erro.
duration	Duration	A quantidade de tempo que o teste de disponibilidade levou para ser executado. Ele ajuda a medir o desempenho e identificar problemas de tempo de resposta. A duração normalmente é medida em milissegundos.

Para obter uma lista de todos os campos disponíveis, consulte AppAvailabilityResults.

Telemetria de tempo do navegador

Os navegadores expõem medidas para ações de carregamento de página com a API de Desempenho. O Application Insights simplifica essas medidas consolidando os intervalos relacionados nas métricas padrão do navegador.

Campos específicos do intervalo do navegador:

Nome do campo (Informações do Aplicativo)	Nome do campo (Análise de logs)	Descrição
networkDuration	NetworkDurationMs	O cliente acessa o DNS para resolver o nome do host do site e o DNS responde com o endereço IP. O cliente cria handshakes TCP e TLS com o servidor Web.
sendDuration	SendDurationMs	O cliente envia o conteúdo da solicitação, aguarda o servidor executar a solicitação e recebe o primeiro pacote de resposta.
receiveDuration	ReceiveDurationMs	O cliente recebe o restante dos bytes de conteúdo de resposta do servidor Web.
processingDuration	ProcessingDurationMs	O cliente agora tem carga de resposta completa e precisa renderizar o conteúdo no navegador e carregar o DOM.
totalDuration	TotalDurationMs	A soma de todos os tempos de execução do navegador.

Para obter uma lista de todos os campos disponíveis, consulte AppBrowserTimings.

Telemetria de dependência

Um item de telemetria de dependência representa uma interação do componente monitorado com um componente remoto, como um banco de dados SQL ou uma conexão HTTP.

Campos específicos de dependência:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
id	Id	O identificador exclusivo 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.
target	Target	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.
type	DependencyType	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.
name	Name	O nome do comando iniciado com esta 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.
data	Data	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.
success	Success	Esse campo indica se uma chamada foi bem-sucedida ou não. É um valor booliano em true que significa que a chamada foi bem-sucedida e false significa que falhou.
resultCode	ResultCode	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.
duration	DurationMs	A duração da solicitação está no formato DD.HH:MM:SS.MMMMMM. Ela deve ser menor que 1000 dias.

Para obter uma lista de todos os campos disponíveis, consulte AppDependencies.

Telemetria de eventos

Você pode criar itens de telemetria de evento 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.

Para saber mais sobre como criar telemetria de eventos personalizada, consulte Adicionar e modificar o OpenTelemetry do Azure Monitor para aplicativos .NET, Java, Node.jse Python.

Campos específicos do evento:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
name	Name	Para permitir agrupamento adequado e métricas úteis, restrinja seu aplicativo para que ele gere alguns nomes de evento separados. Por exemplo, não use um nome à parte para cada instância gerado de um evento.

Para obter uma lista de todos os campos disponíveis, consulte AppEvents.

Telemetria de exceção

Um item de telemetria de exceção representa uma exceção manipulada ou sem tratamento que ocorreu durante a execução do aplicativo monitorado.

Campos específicos de exceção:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
problemId	ProblemId	Identifica onde a exceção foi lançada 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.
type	ExceptionType	O tipo específico de exceção que ocorreu. Isso normalmente inclui o namespace e o nome da classe, como System.NullReferenceException ou System.InvalidOperationException.
assembly	Assembly	O assembly em que a exceção foi lançada. Isso é útil para identificar o componente do aplicativo responsável pela exceção.
method	Method	O nome do método dentro do assembly em que a exceção foi gerada. Isso fornece informações contextuais sobre onde no código o erro ocorreu.
outerType	OuterType	O tipo da exceção externa (encapsulamento), se a exceção atual estiver aninhada em outra exceção. Isso é útil para entender o contexto no qual a exceção interna ocorreu e pode ajudar no rastreamento da sequência de erros.
outerMessage	OuterMessage	Esta mensagem fornece uma explicação legível pelo ser humano da exceção externa e pode ser útil para entender a questão mais ampla.
outerAssembly	OuterAssembly	O assembly de origem da exceção externa.
outerMethod	OuterMethod	O método da exceção externa. Isso fornece informações detalhadas sobre o ponto de falha dentro da exceção externa.
severityLevel	SeverityLevel	O nível de gravidade do rastreamento pode ser um dos seguintes valores: Verbose, Information, Warning, Error ou Critical.
details	Details	Contém informações de exceção, como a mensagem de exceção e a pilha de chamadas.

Para obter uma lista de todos os campos disponíveis, consulte AppExceptions.

Telemetria de métrica:

O Application Insights dá suporte a dois tipos de telemetria de métrica:

• Uma única medida tem um nome e um valor.
• Uma métrica pré-configurada usa várias medidas em um período de agregação de 1 minuto.

Contadores de desempenho

Contadores de desempenho são sempre métricas de medição única com um name e um value, mas vêm com os campos adicionais category, counter, e, para aplicativos do Windows, também instance.

Campos específicos do contador de desempenho:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
name	Name	O nome da métrica que você deseja ver no portal do Application Insights.
value	Value	O valor único para medição. É a soma de medidas individuais para a agregação.
category	Category	Representa um grupo de contadores de desempenho relacionados (por exemplo, Process).
counter	Counter	Especifica a métrica de desempenho específica que está sendo medida dentro de uma categoria (por exemplo, IO Data Bytes/sec).
instance	Instance	Identifica uma ocorrência específica de um contador dentro de uma categoria (por exemplo, ??APP_WIN32_PROC??).

Para obter uma lista de todos os campos disponíveis, consulte AppPerformanceCounters.

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

Métricas do contador do sistema e do processo

nome do .NET	Descrição
\Processor(_Total)\% Processor Time	Total de CPU do computador.
\Memory\Available Bytes	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	CPU do processo que hospeda o aplicativo.
\Process(??APP_WIN32_PROC??)\Private Bytes	Memória usada pelo processo que hospeda o aplicativo.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Taxa de operações de E/S executadas pelo processo que hospeda o aplicativo.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Taxa de solicitações processadas por um aplicativo.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Taxa de exceções geradas por um aplicativo.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Tempo médio de execução da solicitação.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Número de solicitações aguardando processamento em uma fila.

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.

Métricas personalizadas

Métricas personalizadas são indicadores de desempenho ou métricas específicas de negócios que você define e coleta para obter insights que não são cobertos por métricas padrão. Para saber mais sobre métricas personalizadas, consulte métricas personalizadas no Azure Monitor (versão prévia).

Campos específicos da métrica personalizada:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Medida única	Métrica pré-agregada
name	Name	Esse campo é o nome da métrica que você deseja ver no portal do Application Insights e na interface do usuário.
value	Value	Esse campo é o valor único para medição. É a soma de medidas individuais para a agregação.	Para uma métrica pré-configurada, Valor é igual a Soma.
Max	Max	Para uma única métrica de medida, Max é igual a Valor.	Esse campo é o valor máximo da métrica agregada. Ele não deve ser definido para uma medida.
Min	Min	Para uma única métrica de medida, Min é igual a Valor.	Esse campo é o valor mínimo da métrica agregada. Ele não deve ser definido para uma medida.
Sum	Sum	Para uma única métrica de medida, Soma é igual a Valor.	A soma de todos os valores da métrica agregada. Ele não deve ser definido para uma medida.
Count	Count	Quanto à uma única métrica de medida, a Contagem é 1.	O número de medidas em um período de agregação de 1 minuto. Ele não deve ser definido para uma medida.

Para obter uma lista de todos os campos disponíveis, consulte AppMetrics.

Observação

Para calcular a média, divida Soma por Contagem.

Telemetria de exibição de página

A telemetria de exibição de página é 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.

Campos específicos de exibição da página:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
name	Name	O nome da página que foi exibida pelo usuário (por exemplo, "Home" ou "Shopping Cart").
url	Url	A URL completa da página que foi exibida. Esse campo é crucial para analisar o tráfego e o comportamento do usuário em todo o aplicativo.
duration	DurationMs	A duração do PageView é proveniente da interface de tempo de desempenho do navegador, PerformanceNavigationTiming.duration. Se PerformanceNavigationTiming estiver disponível, essa duração será usada. Se não estiver, a interface preteridaPerformanceTiming será usada e o delta entre NavigationStart e LoadEventEnd será calculado. O desenvolvedor especifica um valor de duração ao registrar eventos do PageView personalizados usando a chamada à API trackPageView.

Para obter uma lista de todos os campos disponíveis, consulte AppPageViews.

Observação

• Por padrão, o SDK de JavaScript do Application Insights loga eventos únicos PageView em cada ação de carregamento da página da Web no navegador, com pageViews.duration preenchido pelo tempo de carregamento 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.

Solicitar telemetria

A telemetria de solicitação representa informações relacionadas a solicitações HTTP de entrada para seu aplicativo. Esse tipo de telemetria ajuda você a monitorar o desempenho e o sucesso dos serviços baseados na Web do aplicativo. Um item de telemetria de solicitação representa a sequência lógica de execução disparada por uma solicitação externa ao 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 personalizadas properties e measurements.

Campos específicos da solicitação:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
id	Id	O identificador exclusivo de uma instância de chamada de solicitação, usado para 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.
source	Source	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.
name	Name	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.
url	Url	URL é a URL de solicitação com todos os parâmetros de cadeia de consulta.
success	Success	Ê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.
resultCode	ResultCode	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.
duration	DurationMs	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.

Para obter uma lista de todos os campos disponíveis, consulte AppRequests.

Telemetria de rastreamento

A telemetria de rastreamento representa instruções de rastreamento de printf-style 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.

Campos específicos de rastreamento:

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
message	Message	Mensagem de rastreamento.
severityLevel	SeverityLevel	Nível de severidade de rastreamento.

Para obter uma lista de todos os campos disponíveis, consulte AppTraces.

Observação

Os valores de severityLevel são enumerados e específicos da plataforma.

Propriedades e medidas personalizadas

Propriedades personalizadas

Coleção nome-valor de propriedades personalizadas: essa coleção é usada para ampliar a telemetria padrão com as dimensões personalizadas. Exemplos são o slot de implantação que gerou 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

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.

Nome do campo (Application Insights)	Nome do campo (Análise de logs)	Descrição
account_ID	user_AccountId	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.
application_Version	AppVersion	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.
appId	ResourceGUID	Um identificador exclusivo para o recurso do Application Insights para distinguir a telemetria de diferentes aplicativos.
appName	Não aplicável	No Application Insights, appName é o mesmo que _ResourceId.
client_Browser	ClientBrowser	O nome do navegador da Web usado pelo cliente.
client_City	ClientCity	A cidade onde o cliente estava localizado quando a telemetria foi coletada (com base na localização geográfica de IP).
client_CountryOrRegion	ClientCountryOrRegion	O país ou região em que o cliente estava localizado quando a telemetria foi coletada (com base na localização geográfica de IP).
client_IP	ClientIP	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, em seguida, trunca-as. O IP do cliente não pode ser usado como informações de identificação do usuário.
client_OS	ClientOS	Indica o sistema operacional do cliente que gerou a telemetria.
client_StateorProvince	ClientStateOrProvince	O estado ou província em que o cliente estava localizado quando a telemetria foi coletada (com base na localização geográfica de IP).
client_Type	ClientType	Descreve o tipo de dispositivo cliente que enviou a telemetria (por exemplo, Browser ou PC.)
cloud_RoleInstance	AppRoleInstance	O nome da instância em que o aplicativo está em execução. Por exemplo, é o nome do computador para o local ou o nome da instância do Azure.
cloud_RoleName	AppRoleName	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.
iKey	IKey	Um identificador exclusivo herdado usado para associar dados de telemetria a um recurso específico do Application Insights.
itemId	Não aplicável	Um identificador exclusivo para um item de telemetria específico.
itemCount	ItemCount	O número de ocorrências ou contagens associadas a um único evento de telemetria.
operation_Id	OperationId	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.
operation_Name	OperationName	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?".
operation_ParentId	ParentId	O identificador exclusivo do pai imediato do item de telemetria. Para obter mais informações, consulte Correlação de telemetria.
operation_SyntheticSource	SyntheticSource	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.
sdkVersion	SDKVersion	A versão do SDK do Application Insights que está enviando dados de telemetria. Para obter mais informações, consulte Versão do SDK.
session_Id	SessionId	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.
user_AuthenticatedId	UserAuthenticatedId	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.
user_Id	UserId	A ID de usuário anônimo 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. 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.
_ResourceId	_ResourceId	A ID completa do Recurso do Azure do componente Application Insights, que inclui a assinatura, o grupo de recursos e o nome do recurso.

Próximas etapas

• Perguntas frequentes (perguntas frequentes): Perguntas frequentes sobre o modelo de dados de telemetria
• Confira as plataformas com suporte do Application Insights.
• Saiba como coletar telemetria personalizada usando a Distribuição OpenTelemetry do Azure Monitor.
• Saiba como usar a API do Application Insights para eventos e métricas personalizados.
• Saiba como estender e filtrar a telemetria.
• Saiba como usar a amostragem para minimizar a quantidade de telemetria com base no modelo de dados.