Modelo de datos de telemetría de Application Insights

  • Artículo

Application Insights envía telemetría de la aplicación web en Azure Portal, por lo que puede analizar el rendimiento y el uso de la aplicación. El modelo de telemetría está normalizado para que sea posible crear una supervisión independiente del lenguaje y de la plataforma.

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

Diagram that shows an Application Insights telemetry data model.

Los siguientes tipos de telemetría se utilizan para supervisar la ejecución de la aplicación. Mediante el SDK de Application Insights desde la plataforma de aplicación web se recopilan automáticamente tres tipos:

  • Solicitud: generada para registrar una solicitud recibida por la aplicación. Por ejemplo, el SDK web de Application Insights genera automáticamente un elemento de telemetría de solicitud para cada solicitud HTTP que recibe la aplicación web.

    Una operación está formada por subprocesos de ejecución que procesan una solicitud. También puede escribir código para supervisar otros tipos de operación, como un "reactivo" de un trabajo web de trabajo o una función que periódicamente procesa los datos. Cada operación tiene un identificador. Este identificador puede usarse para agrupar toda la telemetría generada mientras la aplicación procesa la solicitud. Cada operación se realiza correctamente o produce un error y tiene una duración de tiempo.

  • Excepción: normalmente representa una excepción que produce un error en una operación.

  • Dependencia: representa una llamada de la aplicación a un servicio o almacenamiento externo como una API de REST o SQL. En ASP.NET las llamadas de dependencia a SQL se definen mediante System.Data. Las llamadas a los puntos de conexión HTTP se definen mediante System.Net.

Application Insights proporciona tres tipos de datos para telemetría personalizada:

  • Seguimiento: se usa directamente o a través de un adaptador que implementa el registro de diagnóstico mediante una plataforma de instrumentación con la que se está familiarizado, como Log4Net o System.Diagnostics.
  • Evento: se usa habitualmente para capturar la interacción del usuario con el servicio para analizar los patrones de uso.
  • Métrica: se usa para notificar las medidas escalares periódicas.

Cada elemento de telemetría puede definir la información de contexto en forma de versión de aplicación o de identificador de sesión de usuario. El contexto es un conjunto de campos fuertemente tipados que desbloquean ciertos escenarios. Cuando la versión de la aplicación se haya inicializado correctamente, Application Insights puede detectar nuevos patrones de comportamiento de la aplicación correlacionados con la reimplementación.

Puede usar el identificador de sesión para calcular una interrupción o un problema que afecte a los usuarios. Calcular recuentos distintivos de valores de identificador de sesión para errores de dependencia, seguimientos de errores o excepciones críticas específicos proporciona información valiosa sobre el impacto.

El modelo de telemetría de Application Insights define una forma de correlacionar la telemetría con la operación de la que es parte. Por ejemplo, una solicitud puede realizar una llamada de SQL Database y registrar información de diagnóstico. Puede establecer el contexto de correlación de los elementos de telemetría que lo vinculan a la telemetría de solicitudes.

Mejoras de esquema

El modelo de datos de Application Insights es una manera básica pero eficaz de modelar la telemetría de la aplicación. Nos esforzamos para que el modelo sea simple y compacto para admitir escenarios esenciales y permitir extender el esquema para el uso avanzado.

Para informar de problemas del esquema o del modelo de datos y proporcionar sugerencias, use el repositorio de GitHub.

Solicitud

Un elemento de telemetría de solicitud en Application Insights 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.

Nota

El 31 de marzo de 2025 finalizará la compatibilidad con la ingesta de claves de instrumentación. La ingesta de claves de instrumentación seguirá funcionando, pero la característica ya no recibirá actualizaciones ni soporte técnico. Transición a las cadenas de conexión para aprovechar las nuevas funcionalidades.

Nombre

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 de HTTP, representa el método HTTP y la plantilla de la ruta URL como GET /values/{id} sin el valor de id real.

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.

Longitud máxima: 1024 caracteres

ID

Id. es el identificador de una instancia de llamada de solicitud. Se utiliza 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.

Longitud máxima: 128 caracteres

URL

URL es la URL de solicitud con todos los parámetros de la cadena de consulta.

Longitud máxima: 2048 caracteres

Source

Origen 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.

Longitud máxima: 1024 caracteres

Duration

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 representa la operación con el principio y el final.

Response code

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.

Longitud máxima: 1024 caracteres

Correcto

Correcto indica si una llamada se realizó correctamente o no. Este campo es obligatorio. Cuando una solicitud no se establezca explícitamente en false, se considerará correcta. Si un código de resultado de error de excepción o 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. Para vínculos rotos, puede implementar 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.

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

Dependencia

La telemetría de dependencias (en Application Insights) representa una interacción del componente supervisado con un componente remoto como SQL o un punto de conexión HTTP.

Nombre

Este campo es el nombre del comando que se inició 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 acceso de dirección URL.

id

El Id. es el identificador de una instancia de llamada de dependencia. Se usa para la correlación 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.

data

Este campo es el 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.

Tipo

Este campo es el 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.

Destino

Este campo es el 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.

Duration

La duración de la solicitud tiene el formato DD.HH:MM:SS.MMMMMM. Debe ser menor de 1000 días.

Código de resultado

Este campo es el 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.

Correcto

Este campo es la indicación de una llamada correcta o incorrecta.

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

Excepción

En Application Insights, una instancia de excepción representa una excepción controlada o no controlada que se produjo durante la ejecución de la aplicación supervisada.

Id. del problema

El identificador del problema 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.

Longitud máxima: 1 024 caracteres

Nivel de gravedad

Este campo es el nivel de gravedad del seguimiento. El valor puede ser Verbose, Information, Warning, Error o Critical.

Detalles de la excepción

(Se ampliará)

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

Seguimiento

La telemetría de seguimiento (en Application Insights) representa instrucciones de seguimiento de estilo printf en las que se pueden realizar búsquedas de 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.

Message

Mensaje de seguimiento.

Longitud máxima: 32 768 caracteres

Nivel de gravedad

El nivel de gravedad del seguimiento.

Valores: Verbose, Information, Warning, Error y Critical

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 del valor: 8 192

Evento

Puede crear elementos de telemetría de eventos (en Application Insights) para representar un evento producido en la aplicación. Normalmente es una interacción del usuario como un clic de botón o la desprotección de un pedido. También puede ser un evento de ciclo de vida de la aplicación como la actualización de la inicialización o una configuración.

Semánticamente, los eventos pueden estar correlacionados o no con las solicitudes. Si se usa correctamente, la telemetría de eventos es más importante que las solicitudes o los seguimientos. Los eventos representan la telemetría de negocio y deberían estar sujetos a un muestreo independiente, menos agresivo.

Nombre

Nombre de evento: para permitir la agrupación adecuada y métricas útiles, restrinja la aplicación para que genere unos pocos nombres de evento independientes. Por ejemplo, no utilice un nombre diferente para cada instancia generada de un evento.

Longitud máxima: 512 caracteres

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

Métrica

Application Insights admite dos tipos de telemetría de métricas: la medida única y la métrica previamente agregada. La medida única es simplemente un nombre y un valor. La métrica previamente agregada especifica el valor mínimo y máximo de la métrica en el intervalo de agregación y la desviación estándar del mismo.

La telemetría de métricas previamente agregadas da por supuesto que el período de agregación es de un minuto.

Application Insights admite varios nombres de métrica conocidos. Estas métricas aparecen en la tabla performanceCounters.

En la tabla siguiente se muestran las métricas que representan contadores del sistema y del proceso.

Nombre de .NET Nombre independiente de la plataforma Descripción
\Processor(_Total)\% Processor Time Trabajo en curso... CPU total del equipo.
\Memory\Available Bytes Trabajo en curso... 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 Trabajo en curso... CPU del proceso que hospeda la aplicación.
\Process(??APP_WIN32_PROC??)\Private Bytes Trabajo en curso... Memoria que usa el proceso que hospeda la aplicación.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec Trabajo en curso... Tasa de operaciones de E/S ejecutadas por el proceso que hospeda la aplicación.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec Trabajo en curso... Tasa de solicitudes procesadas por una aplicación.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Trabajo en curso... Tasa de excepciones producidas por una aplicación.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time Trabajo en curso... Tiempo medio de ejecución de solicitudes.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue Trabajo en curso... Número de peticiones en espera de procesamiento en una cola.

Para obtener más información sobre la API de REST de métricas, consulte Métricas: obtención.

Nombre

Este campo es el nombre de la métrica que desea ver en el portal y la interfaz de usuario de Application Insights.

Value

Este campo es el valor único para la medida. Es la suma de las mediciones individuales para la agregación.

Count

Este campo es el peso de la métrica agregada. No se debe establecer para una medida.

Min

Este campo es el valor mínimo de la métrica agregada. No se debe establecer para una medida.

Max

Este campo es el valor máximo de la métrica agregada. No se debe establecer para una medida.

Desviación estándar

Este campo es la desviación estándar de la métrica agregada. No se debe establecer para una medida.

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.

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 del valor: 8 192

VistaPágina

La telemetría de visualización de páginas (en Application Insights) 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.

Nota

  • De manera predeterminada, los SDK de Application Insights registran eventos de PageView únicos en cada acción de carga de página web del explorador, con el elemento pageViews.duration rellenado con los tiempos del exploradorweb. 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.

Medida de los tiempos del explorador en Application Insights

Los exploradores modernos exponen medidas para las acciones de carga de páginas con la API de rendimiento. Application Insights simplifica estas medidas mediante la consolidación de los tiempos relacionados en métricas estándar del explorador, tal como se define en estas definiciones de tiempo de procesamiento:

  • Cliente <--> DNS: el cliente accede a DNS para resolver el nombre de host del sitio web y DNS responde con la dirección IP.

  • Cliente <--> servidor web: el cliente crea protocolos de enlace TCP y TLS con el servidor web.

  • Cliente <--> servidor web: el cliente envía la carga de la solicitud, espera a que el servidor ejecute la solicitud y recibe el primer paquete de respuesta.

  • Cliente <-- servidor web: el cliente recibe el resto de los bytes de la carga de respuesta del servidor web.

  • Cliente: el cliente ahora tiene una carga de respuesta completa y tiene que representar el contenido en el explorador y cargar el DOM.

  • browserTimings/networkDuration = Nº 1 + Nº 2

  • browserTimings/sendDuration = Nº 3

  • browserTimings/receiveDuration = Nº 4

  • browserTimings/processingDuration = Nº 5

  • browsertimings/totalDuration = Nº 1 + Nº 2 + Nº 3 + Nº 4 + Nº 5

  • pageViews/duration

Screenshot that shows the Metrics page in Application Insights showing graphic displays of metrics data for a web application.

Context

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.

Versión de la aplicación

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.

Longitud máxima: 1,024

Dirección IP de cliente

Este campo es la dirección IP del dispositivo del cliente. Se admiten IPv4 e IPv6. Al enviar telemetría desde un servicio, el contexto de la ubicación trata sobre el usuario que inició la operación en el servicio. Application Insights extrae la información de geolocalización de la IP del cliente y seguidamente la trunca. La IP del cliente no puede usarse por sí sola a modo de información de identificación del usuario.

Longitud máxima: 46

Tipo de dispositivo

Originalmente, este campo se usaba para indicar el tipo de dispositivo que usaba el usuario de la aplicación. Hoy se usa principalmente para distinguir la telemetría de JavaScript con el tipo de dispositivo Browserde la telemetría del lado del servidor con el tipo de dispositivo PC.

Longitud máxima: 64

Id. de operación

Este campo es el 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.

Longitud máxima: 128

Identificador de la operación principal

Este campo es el identificador único del objeto primario inmediato del elemento de telemetría. Para obtener más información, vea Correlación de telemetría.

Longitud máxima: 128

Nombre de operación

Este campo es el 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?

Longitud máxima: 1,024

Origen sintético de la operación

Este campo es el 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.

Longitud máxima: 1,024

Identificador de sesión

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.

Longitud máxima: 64

Identidad de usuario anónimo

El identificador de usuario anónimo (User.Id) representa al usuario de la aplicación. Al enviar telemetría desde un servicio, el contexto del usuario trata sobre el usuario que inició la operación en el 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.

Nota

El recuento de identificador 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.

Longitud máxima: 128

Id. de usuario autenticado

Un identificador de usuario autenticado es lo opuesto a un identificador de usuario anónimo. Este campo representa al usuario con un nombre descriptivo. 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.

Longitud máxima: 1,024

Identificador de cuenta

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.

Longitud máxima: 1,024

Rol en la nube

Este campo es el nombre del rol del que forma parte la aplicación. Se asigna directamente al nombre del rol de Azure. También puede usarse para distinguir microservicios, que forman parte de una única aplicación.

Longitud máxima: 256

Instancia de rol en la nube

Este campo es el 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.

Longitud máxima: 256

Interno: Versión del SDK

Para más información, consulte Versión del SDK.

Longitud máxima: 64

Interno: nombre del nodo

Este campo representa el nombre del nodo que se usa para la facturación. Úselo para invalidar la detección estándar de nodos.

Longitud máxima: 256

Preguntas más frecuentes

Esta sección proporciona respuestas a preguntas comunes.

¿Cómo medirías el impacto de una campaña de supervisión?

La telemetría pageView incluye la dirección URL y podría analizar el parámetro UTM mediante una función regex en Kusto.

Ocasionalmente, estos datos podrían faltar o ser inexactos si el usuario o la empresa deshabilita el envío de un agente de usuario en la configuración del explorador. Es posible que las expresiones regulares del analizador de UA no incluyan toda la información del dispositivo. O bien, es posible que Application Insights no haya adoptado las actualizaciones más recientes.

¿Por qué una medición personalizada se realiza correctamente pero no aparece el registro?

Esto puede ocurrir si usa valores de cadena. Solo los valores numéricos funcionan con medidas personalizadas.

Pasos siguientes

Obtenga información sobre cómo usar la API de Application Insights para eventos y métricas personalizados, como:

Configure el seguimiento de dependencias para:

Para obtener más información: