Modelo de datos de telemetría de Application Insights

Application Insights envía telemetría desde la aplicación web a Azure Portal para proporcionar información sobre el rendimiento y el uso de la aplicación y la infraestructura. Para ayudarle a comprender y organizar mejor los datos de telemetría, los clasificamos en tipos distintos.

El modelo de datos de telemetría está estandarizado, lo que permite crear una supervisión independiente del lenguaje y de la plataforma. Nos esforzamos para que el modelo sea simple y compacto para admitir escenarios esenciales y permitir extender el esquema para el uso avanzado.

Los datos recopilados por Application Insights modela este patrón de ejecución de aplicaciones típico:

¹availabilityResults no está disponible de forma predeterminada y requiere que se configuren las pruebas de disponibilidad.
²customEvents y customMetrics solo están disponibles con instrumentación personalizada.

Nota

Application Insights almacena los registros en la tabla traces debido a motivos de compatibilidad con versiones anteriores. Los segmentos de seguimientos distribuidos se almacenan en las tablas requests y dependencies. Tenemos previsto resolver esto en una versión futura para evitar confusiones.

Tipos de telemetría

Los siguientes tipos de telemetría se usan para supervisar la ejecución de la aplicación. La distribución de OpenTelemetry de Azure Monitor y el SDK de JavaScript de Application Insights recopilan:

Tipo de telemetría	Nombre de la tabla (Application Insights)	Nombre de la tabla (Log Analytics)	Descripción
Disponibilidad	availabilityResults	AppAvailabilityResults	Supervisa la disponibilidad y la capacidad de respuesta de la aplicación mediante el envío de solicitudes web a intervalos regulares y le avisa si la aplicación no responde o si el tiempo de respuesta es demasiado lento.
Tiempo del navegador	browserTimings	AppBrowserTimings	Mide el rendimiento de las páginas web, incluidos los tiempos de carga de página y las duraciones de red.
Dependencia	dependencies	AppDependencies	Realiza un seguimiento de las llamadas de la aplicación a un servicio o almacenamiento externo, como una API REST o una base de datos SQL, y mide la duración y el éxito de estas llamadas.
Evento	customEvents	AppEvents	Normalmente se utiliza para capturar interacciones del usuario y otros sucesos significativos dentro de su aplicación, como clics en botones o finalización de pedidos, para analizar los patrones de uso.
Excepción	exceptions	AppExceptions	Captura la información de error crucial para solucionar problemas y comprender los errores.
Métrica	performanceCounters customMetrics	AppPerformanceCounters AppMetrics	Los contadores de rendimiento proporcionan datos numéricos sobre varios aspectos del rendimiento de la aplicación y del sistema, como el uso de CPU y el consumo de memoria. Además, las métricas personalizadas permiten definir y realizar un seguimiento de medidas específicas exclusivas de la aplicación, lo que proporciona flexibilidad para supervisar indicadores de rendimiento personalizados.
Vista de página	pageViews	AppPageViews	Realiza un seguimiento de las páginas que ven los usuarios, lo que proporciona información sobre la navegación del usuario y la interacción dentro de la aplicación.
Solicitud	requests	AppRequests	Registra las solicitudes recibidas por la aplicación, proporcionando detalles como el identificador de la operación, la duración y el estado de éxito o error.
Seguimiento	traces	AppTraces	Registra eventos específicos de la aplicación, como mensajes de diagnóstico personalizados o instrucciones de seguimiento, que son útiles para la depuración y la supervisión del comportamiento de la aplicación a lo largo del tiempo.

Importante

Puede consultar la telemetría de la aplicación desde Application Insights y Log Analytics (recomendado), pero los nombres de tabla y campo son diferentes. Esta distinción conserva la compatibilidad con versiones anteriores, por ejemplo, para asegurarse de que los paneles del cliente con consultas personalizadas creadas antes de que la convención de nomenclatura de Log Analytics continúe funcionando correctamente.

Para comparar nombres de campo en Azure Portal, abraRegistros de Application Insights>, ejecute una consulta y copie el Id de un elemento de telemetría (por ejemplo, 1234a5b6c7de8f90). A continuación, abra una nueva pestaña en el explorador, vaya aRegistros de Log Analytics>, cambie al modo KQL y ejecute la consulta:

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

Expanda ambos elementos de telemetría seleccionando el botón de contenido adicional a la izquierda de cada fila para ver todas sus propiedades.

Cada elemento de telemetría puede incluir información de contexto , como la versión de la aplicación o el identificador de sesión de usuario. El contexto consta de un conjunto de campos fuertemente tipados que permiten diferentes escenarios de análisis.

Por ejemplo, cuando se inicializa correctamente la versión de la aplicación, Application Insights puede detectar nuevos patrones en el comportamiento de la aplicación correlacionado con la reimplementación. Del mismo modo, puede usar el identificador de sesión para evaluar el impacto de interrupciones o problemas en los usuarios. Al calcular el número de identificadores de sesión únicos asociados a dependencias con errores, seguimientos de errores o excepciones críticas, obtendrá una imagen más clara del impacto del usuario.

El modelo de telemetría de Application Insights también admite la correlación de elementos de telemetría con las operaciones a las que pertenecen. Por ejemplo, si una solicitud desencadena una llamada a SQL Database, tanto la solicitud como la llamada de dependencia pueden incluir datos de diagnóstico y vincularse a través de un contexto de correlación compartido, lo que le permite realizar un seguimiento del flujo completo de la operación.

En este artículo se tratan los campos específicos de cada tipo de telemetría. Para ver la lista completa de campos disponibles (incluidos los campos de contexto) para cualquier tipo de telemetría, siga el vínculo proporcionado debajo de cada tabla pertinente.

Telemetría de disponibilidad

La telemetría de disponibilidad implica la supervisión sintética, donde las pruebas simulan interacciones del usuario para comprobar que la aplicación está disponible y responde. Se recomienda configurar pruebas de disponibilidad estándar para supervisar la disponibilidad de la aplicación desde varios puntos de todo el mundo y enviar su propia información de prueba a Application Insights.

Campos específicos de disponibilidad:

Nombre del campo (Application Insights)	Nombre del campo (Log Analytics)	Descripción
id	Id	Identificador único de un resultado de prueba de disponibilidad, que se usa para la correlación entre ejecuciones de pruebas individuales que pueden ayudar a realizar un seguimiento de errores o patrones específicos a lo largo del tiempo. Para más información, consulte Correlación de Telemetría en Application Insights.
name	Name	Nombre de una prueba de disponibilidad. Se define al crear la prueba (por ejemplo, "Prueba de ping de página principal").
location	Location	Ubicación geográfica o región del centro de datos desde la que se ejecutó una prueba de disponibilidad (por ejemplo, Oeste de EE. UU., Norte de Europa). Ayuda a identificar interrupciones regionales o problemas de latencia.
success	Success	Este campo indica si una prueba de disponibilidad se realizó correctamente o no. Es un valor booleano donde true significa que la prueba se realizó correctamente y false significa que se produjo un error.
message	Message	Mensaje descriptivo con detalles sobre el resultado de la prueba. A menudo contiene detalles de excepción o respuestas de error.
duration	Duration	Cantidad de tiempo que se tardó en ejecutarse la prueba de disponibilidad. Ayuda a medir el rendimiento e identificar los problemas de tiempo de respuesta. La duración se mide normalmente en milisegundos.

Para obtener una lista de todos los campos disponibles, consulte AppAvailabilityResults.

Telemetría de tiempo del navegador

Los exploradores exponen medidas para acciones de carga de páginas con la API de rendimiento. Application Insights simplifica estas medidas consolidando los tiempos relacionados en las métricas estándar del explorador.

Browser-timing-specific fields:

Nombre del campo (Application Insights)	Nombre del campo (Analítica de registros)	Descripción
networkDuration	NetworkDurationMs	El cliente llega a DNS para resolver el nombre de host del sitio web y DNS responde con la dirección IP. El cliente crea protocolos de enlace TCP y TLS con el servidor web.
sendDuration	SendDurationMs	El cliente envía la carga de solicitud, espera a que el servidor ejecute la solicitud y reciba el primer paquete de respuesta.
receiveDuration	ReceiveDurationMs	El cliente recibe el resto de los bytes de carga de respuesta del servidor web.
processingDuration	ProcessingDurationMs	El cliente ahora tiene carga de respuesta completa y tiene que representar el contenido en el explorador y cargar el DOM.
totalDuration	TotalDurationMs	La suma de todos los tiempos del navegador.

Para obtener una lista de todos los campos disponibles, consulte AppBrowserTimings.

Telemetría de dependencia

Un elemento de telemetría de dependencia representa una interacción del componente supervisado con un componente remoto, como SQL o un punto de conexión HTTP.

Campos específicos de dependencia:

Nombre del campo (Application Insights)	Nombre del campo (Analítica de registros)	Descripción
id	Id	Identificador único de una instancia de llamada de dependencia, usado para correlacionar con el elemento de telemetría de solicitud que corresponde a esta llamada de dependencia. Para más información, consulte Correlación de Telemetría en Application Insights.
target	Target	Sitio de destino de una llamada de dependencia. Algunos ejemplos son el nombre del servidor y la dirección de host. Para más información, consulte Correlación de Telemetría en Application Insights.
type	DependencyType	Nombre del tipo de dependencia. Tiene un valor de cardinalidad bajo para una agrupación lógica de dependencias y la interpretación de otros campos como commandName y resultCode. Algunos ejemplos son SQL, tabla de Azure y HTTP.
name	Name	Nombre del comando iniciado con esta llamada de dependencia. Tiene un valor de cardinalidad bajo. Algunos ejemplos son el nombre del procedimiento almacenado y la plantilla de ruta de URL.
data	Data	Comando iniciado por esta llamada de dependencia. Algunos ejemplos son la instrucción SQL y la dirección URL HTTP con todos los parámetros de consulta.
success	Success	Este campo indica si una llamada se realizó correctamente o no. Es un valor booleano donde true significa que la llamada se realizó correctamente y false significa que se produjo un error.
resultCode	ResultCode	Código de resultado de una llamada de dependencia. Algunos ejemplos son el código de error SQL y el código de estado HTTP.
duration	DurationMs	La duración de la solicitud tiene el formato DD.HH:MM:SS.MMMMMM. Debe ser menor de 1000 días.

Para obtener una lista de todos los campos disponibles, consulte AppDependencies.

Telemetría de eventos

Puede crear elementos de telemetría de eventos para representar un evento que se produjo en la aplicación. Normalmente, se trata de una interacción del usuario, como un clic en el botón o la confirmación de un pedido. También puede ser un evento de ciclo de vida de la aplicación como la inicialización o una actualización de configuración.

Para más información sobre la creación de telemetría de eventos personalizados, consulte Incorporación y modificación de OpenTelemetry de Azure Monitor para .NET, Java, Node.jsy aplicaciones de Python.

Campos específicos del evento:

Nombre del campo (Application Insights)	Nombre del campo (Log Analytics)	Descripción
name	Name	Para permitir la agrupación adecuada y las métricas útiles, restrinja la aplicación para que genere algunos nombres de eventos independientes. Por ejemplo, no utilice un nombre diferente para cada instancia generada de un evento.

Para obtener una lista de todos los campos disponibles, consulte AppEvents.

Telemetría de excepciones

Un elemento de telemetría de excepción representa una excepción controlada o no controlada que se produjo durante la ejecución de la aplicación supervisada.

Campos específicos de la excepción:

Nombre del campo (Application Insights)	Nombre del campo (Log Analytics)	Descripción
problemId	ProblemId	Identifica dónde se produjo la excepción en el código. Se usa para el agrupamiento de las excepciones. Normalmente es una combinación de un tipo de excepción y una función de la pila de llamadas.
type	ExceptionType	Tipo específico de excepción que se produjo. Esto suele incluir el espacio de nombres y el nombre de clase, como System.NullReferenceException o System.InvalidOperationException.
assembly	Assembly	Ensamblado donde se produjo la excepción. Esto resulta útil para identificar el componente de la aplicación responsable de la excepción.
method	Method	Nombre del método dentro del ensamblado donde se produjo la excepción. Esto proporciona información contextual sobre dónde se produjo el error en el código.
outerType	OuterType	Tipo de la excepción externa (encapsulación), si la excepción actual está anidada dentro de otra excepción. Esto es útil para comprender el contexto en el que se produjo la excepción interna y puede ayudar en el seguimiento de la secuencia de errores.
outerMessage	OuterMessage	Este mensaje proporciona una explicación legible de la excepción externa y puede ser útil para comprender el problema más amplio.
outerAssembly	OuterAssembly	Ensamblado donde se originó la excepción externa.
outerMethod	OuterMethod	Método de la excepción externa. Esto proporciona información detallada sobre el punto de error dentro de la excepción externa.
severityLevel	SeverityLevel	El nivel de gravedad de seguimiento puede ser uno de los siguientes valores: Verbose, Information, Warning, Error, o Critical.
details	Details	Contiene información de excepción, como el mensaje de excepción y la pila de llamadas.

Para obtener una lista de todos los campos disponibles, consulte AppExceptions.

Telemetría métrica

Application Insights admite dos tipos de telemetría de métricas:

• Una sola medida tiene un nombre y un valor.
• Una métrica preagregada toma varias medidas en un período de agregación de 1 minuto.

Contadores de rendimiento

Los contadores de rendimiento siempre son métricas de medida únicas con name y , valuepero vienen con los campos categoryadicionales , countery para las aplicaciones de Windows también instance.

Campos específicos del contador de rendimiento:

Nombre del campo (Application Insights)	Nombre del campo (Log Analytics)	Descripción
name	Name	Nombre de la métrica que desea ver en el portal de Application Insights.
value	Value	Valor único para la medida. Es la suma de las mediciones individuales para la agregación.
category	Category	Representa un grupo de contadores de rendimiento relacionados (por ejemplo, Process).
counter	Counter	Especifica la métrica de rendimiento determinada que se mide dentro de una categoría (por ejemplo, IO Data Bytes/sec).
instance	Instance	Identifica una aparición específica de un contador dentro de una categoría (por ejemplo, ??APP_WIN32_PROC??).

Para obtener una lista de todos los campos disponibles, consulte AppPerformanceCounters.

Para más información sobre las métricas, consulte Métricas en Application Insights. Para obtener más información sobre la API REST de Métricas, consulte Metrics - Get.

Métricas del contador de procesos y del sistema

Nombre de .NET	Descripción
\Processor(_Total)\% Processor Time	CPU total del equipo.
\Memory\Available Bytes	Muestra la cantidad de memoria física, en bytes, disponible para procesos que se ejecutan en el equipo. Se calcula sumando la cantidad de espacio en las listas de memoria cero, libre y en espera. La memoria libre está lista para su uso. La memoria de cero consta de páginas de memoria rellenadas con ceros para evitar que los procesos posteriores vean los datos usados por un proceso anterior. La memoria en espera es la memoria que se ha quitado del espacio de trabajo de un proceso (su memoria física) en ruta al disco, pero sigue estando disponible para recuperarse. Consulte Objeto de memoria.
\Process(??APP_WIN32_PROC??)\% Processor Time	CPU del proceso que hospeda la aplicación.
\Process(??APP_WIN32_PROC??)\Private Bytes	Memoria que usa el proceso que hospeda la aplicación.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Tasa de operaciones de E/S ejecutadas por el proceso que hospeda la aplicación.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Tasa de solicitudes procesadas por una aplicación.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Tasa de excepciones producidas por una aplicación.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Tiempo medio de ejecución de solicitudes.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Número de peticiones en espera de procesamiento en una cola.

Propiedades personalizadas

La métrica con la propiedad personalizada CustomPerfCounter establecida en true indica que la métrica representa el contador de rendimiento de Windows. Estas métricas se colocan en la tabla performanceCounters, no en customMetrics. Además, se analiza el nombre de esta métrica para extraer la categoría, el contador y los nombres de instancia.

Métricas personalizadas

Las métricas personalizadas son indicadores de rendimiento o métricas específicas de la empresa que se definen y recopilan para obtener información que no están cubiertas por métricas estándar. Para más información sobre las métricas personalizadas, consulte Métricas personalizadas en Azure Monitor (versión preliminar).

Campos específicos de métricas personalizados:

Nombre del campo (Application Insights)	Nombre del campo (Log Analytics)	Medida única	Métrica preagregada
name	Name	Este campo es el nombre de la métrica que desea ver en el portal y la interfaz de usuario de Application Insights.
value	Value	Este campo es el valor único para la medida. Es la suma de las mediciones individuales para la agregación.	Para una métrica preagregada, Value es igual a Sum.
Max	Max	Para una sola métrica de medida, Max es igual a Value.	Este campo es el valor máximo de la métrica agregada. No se debe establecer para una medida.
Min	Min	Para una sola métrica de medida, Min es igual a Value.	Este campo es el valor mínimo de la métrica agregada. No se debe establecer para una medida.
Sum	Sum	Para una métrica de medida única, Sum es igual a Value.	Suma de todos los valores de la métrica agregada. No se debe establecer para una medida.
Count	Count	Para una sola métrica de medida, Count es 1.	Número de medidas en un período de agregación de 1 minuto. No se debe establecer para una medida.

Para obtener una lista de todos los campos disponibles, consulte AppMetrics.

Nota

Para calcular el promedio, divida La suma por recuento.

Telemetría de vista de página

La telemetría de la vista de página se registra cuando un usuario de la aplicación abre una nueva página de una aplicación supervisada. El elemento Page, en este contexto, es una unidad lógica definida por el desarrollador para que sea una pestaña o una pantalla de la aplicación, y no está necesariamente correlacionada con una acción de carga o una actualización de una página web del explorador.

Esta distinción se puede entender aún más en el contexto de aplicaciones de página única (SPA), donde el cambio entre páginas no está vinculado a acciones de página del explorador. pageViews.duration es el tiempo que tarda la aplicación en presentar la página al usuario.

Campos específicos de la vista de página:

Nombre del campo (Application Insights)	Nombre del campo (Log Analytics)	Descripción
name	Name	Nombre de la página que vio el usuario (por ejemplo, "Home" o "Shopping Cart").
url	Url	Dirección URL completa de la página que se ha visto. Este campo es fundamental para analizar el tráfico y el comportamiento del usuario en toda la aplicación.
duration	DurationMs	La duración de PageView procede de la interfaz de tiempos de rendimiento del explorador, PerformanceNavigationTiming.duration. Si PerformanceNavigationTiming está disponible, se usa esa duración. Si no lo está, se usa la interfaz en desusoPerformanceTiming y se calcula la diferencia entre NavigationStart y LoadEventEnd. El desarrollador especifica un valor de duración al registrar eventos personalizados de PageView mediante la llamada API trackPageView.

Para obtener una lista de todos los campos disponibles, vea AppPageViews.

Nota

• De forma predeterminada, el SDK de JavaScript de Application Insights registra eventos únicos PageView en cada acción de carga de página web del explorador, con pageViews.duration rellenado por tiempo del explorador. Los desarrolladores pueden ampliar el seguimiento adicional de los eventos de PageView mediante la llamada API trackPageView.

• El período de retención de registros predeterminado es de 30 días. Si quiere ver las estadísticas de PageView durante un período de tiempo más largo, debe ajustar la configuración.

Solicitud de telemetría

La telemetría de solicitud representa información relacionada con las solicitudes HTTP entrantes a la aplicación. Este tipo de telemetría le ayuda a supervisar el rendimiento y el éxito de los servicios basados en web de la aplicación. Un elemento de telemetría de solicitud representa la secuencia lógica de ejecución desencadenada por una solicitud externa a la aplicación. Todas las ejecuciones de solicitud se identifican mediante un id y url únicos que contienen todos los parámetros de ejecución.

Puede agrupar las solicitudes por name lógico y definir el source de esta solicitud. La ejecución de código puede ser success o fail, y tiene una duration determinada. Puede agrupar aún más las ejecuciones de éxito y error mediante resultCode. La hora de inicio de la telemetría de solicitudes se define en el nivel de sobre. La telemetría de solicitudes admite el modelo de extensibilidad estándar mediante el uso de , properties y measurements personalizadas.

Campos específicos de la solicitud:

Nombre del campo (Application Insights)	Nombre del campo (Analítica de registros)	Descripción
id	Id	Identificador único de una instancia de llamada de solicitud, que se usa para la correlación entre la solicitud y otros elementos de telemetría. El identificador debería ser único en todo el mundo. Para más información, consulte Correlación de Telemetría en Application Insights.
source	Source	La fuente es el origen de la solicitud. Algunos ejemplos son la clave de instrumentación del autor de la llamada o la dirección IP del autor de la llamada. Para más información, consulte Correlación de Telemetría en Application Insights.
name	Name	Este campo es el nombre de la solicitud y representa la ruta de código seguida para procesar la solicitud. Un valor de cardinalidad bajo permite una mejor agrupación de las solicitudes. En las solicitudes HTTP, representa el método HTTP y la plantilla de ruta URL como GET /values/{id}, sin el valor real de id. El SDK web de Application Insights envía un nombre de solicitud "tal cual" en mayúsculas y minúsculas. El agrupamiento de la IU distingue entre mayúsculas y minúsculas, de modo que GET /Home/Index se cuenta por separado de GET /home/INDEX, incluso aunque a menudo produzcan la misma ejecución de controlador y acción. El motivo es que las URL suelen distinguir entre mayúsculas y minúsculas. Es posible que desee ver si ocurrieron todos los errores 404 para las URL escritas en mayúsculas. En la entrada de blog encontrará más información sobre la colección de nombres de solicitud del SDK web de ASP.NET.
url	Url	URL es la URL de solicitud con todos los parámetros de la cadena de consulta.
success	Success	Éxito indica si una llamada tuvo éxito o no. Este campo es obligatorio. Cuando una solicitud no se establezca explícitamente en false, se considerará correcta. Si una excepción o un código de resultado de error devuelto interrumpió la operación, establezca este valor en false. Para aplicaciones web, Application Insights define una solicitud como correcta cuando el código de respuesta es menor que 400 o igual a 401. Sin embargo, hay casos en los que esta asignación predeterminada no coincide con la semántica de la aplicación. El código de respuesta 404 podría indicar que "no hay registros", lo cual podría formar parte de un flujo regular. También podría indicar un vínculo roto. En el caso de vínculos rotos, puede implementar una lógica más avanzada. Puede marcar vínculos rotos como errores solo cuando estos se encuentren en el mismo sitio mediante el análisis del origen de referencia de URL. O también puede marcarlos como errores accediendo a ellos desde la aplicación para dispositivos móviles de la empresa. De modo similar, 301 y 302 indican un error al acceder a ellos desde el cliente que no admite redireccionamiento. El contenido aceptado parcialmente 206 podría indicar un error de una solicitud general. Por ejemplo, un punto de conexión de Application Insights podría recibir un lote de elementos de telemetría como una solicitud única. Devuelve el error 206 cuando algunos elementos del lote no se han procesado correctamente. Un aumento de la frecuencia del error 206 indicará la presencia de un problema que será necesario investigar. Se aplica una lógica similar al de varios estados de 207, en el cual el estado correcto podría ser el peor de los códigos de respuesta separados.
resultCode	ResultCode	El código de respuesta es el resultado de una ejecución de solicitud. Es el código de estado de HTTP para solicitudes HTTP. Podría ser un valor HRESULT o un tipo de excepción para otros tipos de solicitudes.
duration	DurationMs	La duración de la solicitud tiene el formato DD.HH:MM:SS.MMMMMM. Deberá ser positiva y tener menos de 1000 días. Este campo es obligatorio porque la telemetría de solicitudes abarca desde el principio hasta el final de la operación.

Para obtener una lista de todos los campos disponibles, consulte AppRequests.

Telemetría de seguimiento

La telemetría de seguimientos representa las instrucciones de seguimiento de estilo de printf en las que se busca el texto. Log4Net, NLog y las demás entradas de archivo de registro basadas en texto se convierten a instancias de este tipo. El seguimiento no tiene medidas como extensibilidad.

Campos específicos de seguimiento:

Nombre del campo (Application Insights)	Nombre del campo (Análisis de registros)	Descripción
message	Message	Mensaje de seguimiento.
severityLevel	SeverityLevel	El nivel de gravedad del seguimiento.

Para obtener una lista de todos los campos disponibles, consulte AppTraces.

Nota

Los valores de severityLevel se enumeran y son específicos de la plataforma.

Propiedades y medidas personalizadas

Propiedades personalizadas

Colección de pares nombre-valor de propiedades personalizadas: esta colección se usa para extender la telemetría estándar con las dimensiones personalizadas. Algunos ejemplos son la ranura de implementación que generó la telemetría o la propiedad específica del elemento de telemetría, como el número de pedido.

• Longitud máxima de clave: 150
• Longitud máxima de valor: 8192

Medidas personalizadas

Colección de medidas personalizadas: use esta colección para notificar medidas con nombre asociadas al elemento de telemetría. Casos de uso típicos:

• El tamaño de carga útil de la telemetría de dependencia.
• El número de elementos en la cola procesados por la telemetría de solicitudes.
• El tiempo que tardó un cliente en finalizar el paso del asistente completando la telemetría de eventos.

Puede consultar las medidas personalizadas en el análisis de aplicaciones:

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

Nota

• Las medidas personalizadas están asociadas al elemento de telemetría al que pertenecen. Están sujetas a muestreo con el elemento de telemetría que contiene esas mediciones. Para realizar el seguimiento de una medida que tiene un valor independiente de otros tipos de telemetría, use la telemetría de métricas.
• No use valores de cadena para medidas personalizadas. Solo se admiten valores numéricos.

Longitud máxima de clave: 150

Contexto

Cada elemento de telemetría puede tener un campo de contexto fuertemente tipado. Cada campo permite un escenario de supervisión específico. Use la recopilación de propiedades personalizadas para guardar información contextual personalizada o específica de aplicaciones.

Nombre del campo (Informes de Aplicación)	Nombre del campo (Log Analytics)	Descripción
account_ID	user_AccountId	En aplicaciones multiinquilino, el identificador de cuenta es el identificador de la cuenta de inquilino o el nombre con el que actúa el usuario. Se usa para la segmentación adicional de usuarios cuando un identificador de usuario y un identificador de usuario autenticado no son suficientes. Por ejemplo, un id. de suscripción del Azure Portal o el nombre de un blog de una plataforma de creación de blogs.
application_Version	AppVersion	La información de los campos de contexto de la aplicación siempre trata sobre la aplicación que envía la telemetría. La versión de la aplicación se usa para analizar cambios de tendencia en el comportamiento de la aplicación y su correlación con las implementaciones.
appId	ResourceGUID	Identificador único del recurso de Application Insights para distinguir la telemetría de las distintas aplicaciones.
appName	No disponible	En Application Insights, appName es igual que _ResourceId.
client_Browser	ClientBrowser	Nombre del explorador web usado por el cliente.
client_City	ClientCity	La ciudad donde se encontraba el cliente cuando se recopiló la telemetría (basada en la geolocalización ip).
client_CountryOrRegion	ClientCountryOrRegion	El país o región donde se encontraba el cliente cuando se recopiló la telemetría (en función de la geolocalización ip).
client_IP	ClientIP	Dirección IP del dispositivo cliente. Se admiten IPv4 e IPv6. Al enviar telemetría de un servicio, el contexto de ubicación se refiere al usuario que inició la operación en dicho servicio. Application Insights extrae la información de ubicación geográfica de la dirección IP del cliente y, a continuación, la trunca. La IP del cliente no puede usarse por sí sola a modo de información de identificación del usuario.
client_OS	ClientOS	Indica el sistema operativo del cliente que generó la telemetría.
client_StateorProvince	ClientStateOrProvince	Estado o provincia donde se encuentra el cliente cuando se recopiló la telemetría (en función de la geolocalización ip).
client_Type	ClientType	Describe el tipo de dispositivo cliente que envió la telemetría (por ejemplo, Browser o PC.
cloud_RoleInstance	AppRoleInstance	Nombre de la instancia en la que se ejecuta la aplicación. Por ejemplo, es el nombre de equipo para el entorno local o el nombre de instancia de Azure.
cloud_RoleName	AppRoleName	Nombre del rol del que forma parte la aplicación. Corresponde directamente al nombre del rol en Azure. También puede usarse para distinguir microservicios, que forman parte de una única aplicación.
iKey	IKey	Identificador único heredado que se usa para asociar datos de telemetría a un recurso específico de Application Insights.
itemId	No disponible	Identificador único de un elemento de telemetría específico.
itemCount	ItemCount	Número de repeticiones o recuentos asociados a un único evento de telemetría.
operation_Id	OperationId	Identificador único de la operación raíz. Este identificador permite agrupar la telemetría de varios componentes. Para obtener más información, vea Correlación de telemetría. Mediante una solicitud o mediante una vista de página, se crea el identificador de la operación. El resto de telemetría establece este campo en el valor de la solicitud o la vista de página que la contienen.
operation_Name	OperationName	Nombre (grupo) de la operación. Mediante una solicitud o mediante una vista de página, se crea el nombre de la operación. El resto de los elementos de telemetría establece este campo en el valor de la solicitud o la vista de página que la contienen. El nombre de la operación se usa para localizar todos los elementos de telemetría de un grupo de operaciones (por ejemplo, GET Home/Index). Esta propiedad del contexto se usa para contestar a preguntas como la siguiente: ¿cuáles son las excepciones habituales que se producen en esta página?
operation_ParentId	ParentId	Es el identificador único del primario inmediato del elemento de telemetría. Para obtener más información, vea Correlación de telemetría.
operation_SyntheticSource	SyntheticSource	Nombre del origen sintético. Alguna telemetría de la aplicación puede representar tráfico sintético. Puede tratarse del robot de búsqueda que esté indexando el sitio web, de pruebas de disponibilidad del sitio o de seguimientos de bibliotecas de diagnóstico, como el propio SDK de Application Insights.
sdkVersion	SDKVersion	Versión del SDK de Application Insights que envía datos de telemetría. Para más información, consulte Versión del SDK.
session_Id	SessionId	El id. de sesión es la instancia de la interacción del usuario con la aplicación. La información de los campos de contexto de la sesión siempre trata sobre el usuario. Al enviar telemetría desde un servicio, el contexto de la sesión trata sobre el usuario que inició la operación en el servicio.
user_AuthenticatedId	UserAuthenticatedId	Un identificador de usuario autenticado es lo opuesto a un identificador de usuario anónimo. Este campo representa al usuario con un nombre amigable. Este identificador solo se recopila de forma predeterminada mediante el parámetro AuthenticatedUserIdTelemetryInitializer del SDK de ASP.NET Framework. Use el SDK de Application Insights para inicializar el identificador de usuario autenticado con un valor que identifique al usuario de forma persistente entre exploradores y dispositivos. De este modo, todos los elementos de telemetría se atribuyen a ese identificador único. Este identificador permite consultar todos los datos de telemetría recopilados para un usuario específico (sujeto a configuraciones de muestreo y filtrado de telemetría). Se pueden hacer referencias cruzadas entre los identificadores de usuarios y los identificadores de sesión para proporcionar dimensiones de telemetría únicas y establecer la actividad del usuario durante la duración de una sesión.
user_Id	UserId	El identificador de usuario anónimo representa al usuario de la aplicación. Al enviar telemetría desde un servicio, el contexto del usuario se refiere al usuario que ha iniciado la operación dentro del servicio. El muestreo es una de las técnicas mediante las cuales se reduce al mínimo la cantidad de telemetría recopilada. Un algoritmo de muestreo intenta muestrear toda la telemetría correlacionada para aceptarla o rechazarla. Se usa un identificador de usuario anónimo para la generación de puntuación de muestreo, por lo que un id. de usuario anónimo debe ser un valor lo suficientemente aleatorio. El recuento de identificadores de usuario anónimos no es el mismo que el número de usuarios únicos de la aplicación. El recuento de identificadores de usuario anónimos suele ser mayor porque cada vez que el usuario abre la aplicación en otro dispositivo o explorador, o limpia las cookies del explorador, se asigna un nuevo identificador de usuario anónimo único. Este cálculo puede dar lugar a que se cuenten los mismos usuarios físicos varias veces. Se pueden hacer referencias cruzadas entre los identificadores de usuarios y los identificadores de sesión para proporcionar dimensiones de telemetría únicas y establecer la actividad del usuario durante la duración de una sesión. Usar un identificador del usuario anónimo para almacenar un nombre de usuario es usar el campo de forma incorrecta. Use un identificador de usuario autenticado.
_ResourceId	_ResourceId	Identificador completo de recurso de Azure del componente de Application Insights, que incluye la suscripción, el grupo de recursos y el nombre del recurso.

Pasos siguientes

• Consulte las preguntas más frecuentes (P+F): Preguntas más frecuentes sobre el modelo de datos de telemetría
• Consulte las plataformas compatibles con Application Insights.
• Aprenda a recopilar datos de telemetría personalizados mediante la distribución openTelemetry de Azure Monitor.
• Aprenda a usar la API de Application Insights para eventos y métricas personalizados.
• Obtenga información sobre cómo ampliar y filtrar la telemetría.
• Aprenda a usar el muestreo para minimizar la cantidad de telemetría basada en el modelo de datos.