Configuración del SDK de JavaScript para Application Insights de Microsoft Azure Monitor

La configuración del SDK de JavaScript para Aplicación de Azure Insights proporciona características avanzadas para el seguimiento, la supervisión y la depuración de las aplicaciones web.

Configuración del SDK

Estos campos de configuración son opcionales y adoptan como valor predeterminado false a menos que se indique lo contrario. En las secciones siguientes se agrupan los campos por propósito.

Para obtener instrucciones sobre cómo agregar la configuración del SDK, consulte Agregar configuración del SDK.

Cookies y almacenamiento de sesión

Campos que controlan el uso, la nomenclatura y los nombres de cookies o almacenamiento local usados para las sesiones.

Seguimiento de Ajax y Fetch

Campos que controlan la recopilación automática de solicitudes de Ajax y Fetch, encabezados de solicitud y respuesta, y tiempos de rendimiento del explorador.

Seguimiento distribuido y correlación

Campos que controlan el modo de seguimiento distribuido y la inserción de encabezados de correlación entre los límites del servidor y CORS.

Vistas de página y seguimiento de rutas

Campos que controlan el seguimiento de la visualización de página y los cambios de ruta de la aplicación de una sola página.

Seguimiento de excepciones

Campos que controlan la recopilación automática de excepciones y la notificación de rechazos de promesas no gestionadas.

Muestreo, procesamiento por lotes y almacenamiento

Campos que controlan la velocidad de muestreo, el comportamiento del procesamiento por lotes, el reintento y cómo se almacena en búfer la telemetría sin enviar.

Registro y depuración

Campos que controlan el registro interno del SDK, las excepciones de depuración y el sondeo de diagnóstico.

Administrador de rendimiento

Campos que controlan la colección de eventos de rendimiento internos (perfEvents) dentro del SDK.

Identificadores y duración de la sesión

Campos que controlan los identificadores de sesión, los identificadores de usuario y el tiempo de expiración de la sesión.

Otras opciones de configuración

Activación opcional de funciones, limitación de velocidad, validación de la clave de instrumentación, conversión de telemetría y metadatos de extensión del SDK.

Seguimiento distribuido

Las arquitecturas modernas de nube y microservicios han habilitado servicios sencillos e independientes que reducen los costos al tiempo que aumentan la disponibilidad y el rendimiento. Sin embargo, ha hecho que los sistemas generales sean más difíciles de razonar sobre y depurar. El seguimiento distribuido resuelve este problema proporcionando una herramienta de perfilado de rendimiento que funciona como stack de llamadas para arquitecturas de nube y microservicios.

Azure Monitor proporciona dos experiencias para consumir datos de seguimiento distribuidos: la vista de diagnóstico de transacciones para una sola transacción o solicitud y la vista de mapa de la aplicación para mostrar cómo interactúan los sistemas.

Application Insights puede supervisar cada componente por separado y detectar qué componente es responsable de errores o degradación del rendimiento mediante la correlación de telemetría distribuida. En este artículo se explica el modelo de datos, las técnicas de propagación de contexto, los protocolos y la implementación de tácticas de correlación en diferentes lenguajes y plataformas que usa Application Insights.

Habilitación del seguimiento distribuido a través de Application Insights mediante la implementación automática o los SDK

Se admite la instrumentación de OpenTelemetry en Azure Monitor y el SDK de JavaScript, que emiten datos de seguimiento distribuidos para entornos de desarrollo y bibliotecas habituales.

Con la instrumentación admitida configurada, la información de seguimiento se recopila automáticamente para marcos, bibliotecas y tecnologías comunes.

Se puede realizar un seguimiento manual de cualquier tecnología mediante la creación de intervalos personalizados.

Modelo de datos para la correlación de telemetría

Application Insights define un modelo de datos para la correlación de telemetría distribuida. Para asociar la telemetría a una operación lógica, cada elemento de telemetría tiene un campo de contexto denominado operation_Id. Cada elemento de telemetría del seguimiento distribuido comparte este identificador. Por lo tanto, incluso si pierde la telemetría de una sola capa, todavía puede asociar la telemetría notificada por otros componentes.

Una operación lógica distribuida normalmente consta de un conjunto de operaciones más pequeñas que son solicitudes procesadas por uno de los componentes. La telemetría de solicitud define estas operaciones. Cada elemento de telemetría de solicitud tiene su propio id que lo identifica de forma única y global. Y todos los elementos de telemetría (como seguimientos y excepciones) asociados a la solicitud deben establecer en operation_parentId el valor de la solicitud id.

La telemetría de dependencias representa todas las operaciones salientes, como una llamada HTTP a otro componente. También define su propia id que es única globalmente. La telemetría de solicitudes, que se inicia mediante esta llamada de dependencia, utiliza este id como su operation_parentId.

Puede crear una vista de la operación lógica distribuida mediante operation_Id, operation_parentIdy request.id con dependency.id. Estos campos también definen el orden de causalidad de las llamadas de telemetría.

En un entorno de microservicios, los seguimientos de los componentes pueden ir a diferentes elementos de almacenamiento. Cada componente puede tener su propia cadena de conexión en Application Insights. Para obtener telemetría para la operación lógica, Application Insights consulta los datos de cada elemento de almacenamiento.

Cuando el número de elementos de almacenamiento es grande, necesita una sugerencia sobre dónde buscar a continuación. El modelo de datos de Application Insights define dos campos para resolver este problema: request.source y dependency.target. El primer campo identifica el componente que inició la solicitud de dependencia. El segundo campo identifica qué componente devolvió la respuesta de la llamada de dependencia.

Para obtener información sobre la consulta desde varias instancias dispares, consulte Consulta de datos en áreas de trabajo, aplicaciones y recursos de Log Analytics en Azure Monitor.

Example

Veamos un ejemplo. Una aplicación denominada Precios de acciones muestra el precio actual del mercado de una acción mediante una API externa denominada Stock. La aplicación Precios de acciones tiene una página denominada Página stock que el explorador web cliente abre mediante GET /Home/Stock. La aplicación consulta la API stock mediante la llamada GET /api/stock/valueHTTP.

Puede analizar la telemetría resultante mediante la ejecución de una consulta:

(requests | union dependencies | union pageViews)
| where operation_Id == "STYz"
| project timestamp, itemType, name, id, operation_ParentId, operation_Id

En los resultados, todos los elementos de telemetría comparten la raíz operation_Id. Cuando se realiza una llamada Ajax desde la página, se asigna un nuevo identificador único (qJSXU) a la telemetría de dependencia y el identificador de pageView se usa como operation_ParentId. A continuación, la solicitud de servidor usa el identificador de Ajax como operation_ParentId.

Cuando se realiza la llamada GET /api/stock/value a un servicio externo, debe conocer la identidad de ese servidor para que pueda establecer el dependency.target campo de forma adecuada. Cuando el servicio externo no admite la supervisión, target se establece en el nombre de host del servicio. Un ejemplo es stock-prices-api.com. Pero si el servicio se identifica a sí mismo devolviendo un encabezado HTTP predefinido, target contiene la identidad de servicio que permite a Application Insights crear un seguimiento distribuido consultando telemetría desde ese servicio.

Encabezados de correlación mediante TraceContext de W3C

Application Insights realiza la transición al contexto de seguimiento de W3C, que define:

• traceparent: Contiene el identificador de operación único a nivel global y el identificador único de la llamada.
• tracestate: incluye el contexto de trazabilidad específico del sistema.

La instrumentación admitida usa el protocolo de Contexto de Trazabilidad de W3C para el rastreo distribuido.

El protocolo HTTP de correlación, también denominado Request-Id, está en desuso. Este protocolo define dos encabezados:

• Request-Id: lleva el identificador único global de la llamada.
• Correlation-Context: lleva la colección de pares nombre-valor de las propiedades del seguimiento distribuido.

Application Insights también usa el contexto de correlación para rellenar campos como dependency.target y request.source cuándo está disponible ese contexto.

Los modelos de datos de W3C Trace-Context y de Application Insights se asignan de la siguiente manera:

Para más información, consulte Modelo de datos de telemetría de Application Insights.

Habilitar el soporte para el seguimiento distribuido de W3C

Esta característica está habilitada de forma predeterminada para JavaScript y los encabezados se incluyen automáticamente cuando el dominio de la página de hospedaje es el mismo que el dominio al que se envían las solicitudes (por ejemplo, la página de hospedaje es example.com y las solicitudes de Ajax se envían a example.com). Para cambiar el modo de seguimiento distribuido, use el distributedTracingMode campo de configuración. El valor predeterminado, AI_AND_W3C, ofrece compatibilidad con versiones anteriores para cualquier servicio heredado instrumentado por Application Insights.

• Configuración basada en npm

  Agregue la siguiente configuración:

    distributedTracingMode: DistributedTracingModes.W3C
  

• Configuración basada en el script del cargador del SDK de JavaScript (Web)

  Agregue la siguiente configuración:

      distributedTracingMode: 2 // DistributedTracingModes.W3C
  

Si las solicitudes XMLHttpRequest o Fetch Ajax van a otro host de dominio, incluidos los subdominios, los encabezados de correlación no se incluyen de forma predeterminada. Para habilitar esta característica, establezca el campo de configuración enableCorsCorrelationtrue. Si establece enableCorsCorrelation a true, todas las solicitudes XMLHttpRequest y Fetch Ajax incluyen los encabezados de correlación. Como resultado, si la aplicación del servidor al que llama la solicitud no admite el traceparent encabezado, es posible que se produzca un error en la solicitud. Este error depende de si el explorador y la versión pueden validar la solicitud en función de los encabezados que acepta el servidor. Puede usar el correlationHeaderExcludedDomains campo de configuración para excluir el dominio del servidor de la inserción de encabezados de correlación entre componentes. Por ejemplo, puede usar correlationHeaderExcludedDomains: ['*.auth0.com'] para excluir los encabezados de correlación de las solicitudes enviadas al proveedor de identidades de Auth0.

Filtrado y preprocesamiento de telemetría

En el caso de las aplicaciones web de JavaScript, use inicializadores de telemetría para filtrar, modificar o enriquecer la telemetría antes de enviarla.

• Devuelva false desde un inicializador para descartar un elemento de telemetría antes de enviarlo.
• Agregue o modifique campos en el elemento de telemetría para enriquecer la telemetría con valores útiles para filtrar y analizar.
• Use la configuración de muestreo del SDK para reducir el volumen de telemetría cuando necesite muestreo estadístico en lugar de filtrado explícito.

Aplicaciones web de JavaScript

Para filtrar la telemetría desde aplicaciones web de JavaScript, use ITelemetryInitializer.

1. Cree una función de devolución de llamada para el inicializador de telemetría. La función de devolución de llamada toma ITelemetryItem como parámetro, que es el evento que se está procesando. Si la función de devolución de llamada devuelve false, se filtra el elemento de telemetría.

   var filteringFunction = (envelope) => {
     if (envelope.data.someField === 'tobefilteredout') {
       return false;
     }
     return true;
   };
   

2. Agregue la devolución de llamada del inicializador de telemetría:

   appInsights.addTelemetryInitializer(filteringFunction);
   

Inicializadores de telemetría de JavaScript

Los inicializadores de telemetría se ejecutan antes de enviar un elemento de telemetría de JavaScript. Úselos para agregar, modificar o quitar la telemetría del explorador. Al volver false desde un inicializador se quita el elemento.

Use inicializadores de telemetría para el enriquecimiento o filtrado dirigido. Use el muestreo cuando necesite reducir el volumen sin excluir explícitamente datos de telemetría específicos.

Inicializadores de telemetría de JavaScript

Inserte un inicializador de telemetría de JavaScript, si es necesario. Para más información sobre los inicializadores de telemetría para el SDK de JavaScript de Application Insights, consulte Inicializadores de telemetría.

<script type="text/javascript">
!(function (cfg){function e(){cfg.onInit&&cfg.onInit(n)}var x,w,D,t,E,n,C=window,O=document,b=C.location,q="script",I="ingestionendpoint",L="disableExceptionTracking",j="ai.device.";"instrumentationKey"[x="toLowerCase"](),w="crossOrigin",D="POST",t="appInsightsSDK",E=cfg.name||"appInsights",(cfg.name||C[t])&&(C[t]=E),n=C[E]||function(g){var f=!1,m=!1,h={initialize:!0,queue:[],sv:"8",version:2,config:g};function v(e,t){var n={},i="Browser";function a(e){e=""+e;return 1===e.length?"0"+e:e}return n[j+"id"]=i[x](),n[j+"type"]=i,n["ai.operation.name"]=b&&b.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(h.sv||h.version),{time:(i=new Date).getUTCFullYear()+"-"+a(1+i.getUTCMonth())+"-"+a(i.getUTCDate())+"T"+a(i.getUTCHours())+":"+a(i.getUTCMinutes())+":"+a(i.getUTCSeconds())+"."+(i.getUTCMilliseconds()/1e3).toFixed(3).slice(2,5)+"Z",iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}},ver:undefined,seq:"1",aiDataContract:undefined}}var n,i,t,a,y=-1,T=0,S=["js.monitor.azure.com","js.cdn.applicationinsights.io","js.cdn.monitor.azure.com","js0.cdn.applicationinsights.io","js0.cdn.monitor.azure.com","js2.cdn.applicationinsights.io","js2.cdn.monitor.azure.com","az416426.vo.msecnd.net"],o=g.url||cfg.src,r=function(){return s(o,null)};function s(d,t){if((n=navigator)&&(~(n=(n.userAgent||"").toLowerCase()).indexOf("msie")||~n.indexOf("trident/"))&&~d.indexOf("ai.3")&&(d=d.replace(/(\/)(ai\.3\.)([^\d]*)$/,function(e,t,n){return t+"ai.2"+n})),!1!==cfg.cr)for(var e=0;e<S.length;e++)if(0<d.indexOf(S[e])){y=e;break}var n,i=function(e){var a,t,n,i,o,r,s,c,u,l;h.queue=[],m||(0<=y&&T+1<S.length?(a=(y+T+1)%S.length,p(d.replace(/^(.*\/\/)([\w\.]*)(\/.*)$/,function(e,t,n,i){return t+S[a]+i})),T+=1):(f=m=!0,s=d,!0!==cfg.dle&&(c=(t=function(){var e,t={},n=g.connectionString;if(n)for(var i=n.split(";"),a=0;a<i.length;a++){var o=i[a].split("=");2===o.length&&(t[o[0][x]()]=o[1])}return t[I]||(e=(n=t.endpointsuffix)?t.location:null,t[I]="https://"+(e?e+".":"")+"dc."+(n||"services.visualstudio.com")),t}()).instrumentationkey||g.instrumentationKey||"",t=(t=(t=t[I])&&"/"===t.slice(-1)?t.slice(0,-1):t)?t+"/v2/track":g.endpointUrl,t=g.userOverrideEndpointUrl||t,(n=[]).push((i="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",o=s,u=t,(l=(r=v(c,"Exception")).data).baseType="ExceptionData",l.baseData.exceptions=[{typeName:"SDKLoadFailed",message:i.replace(/\./g,"-"),hasFullStack:!1,stack:i+"\nSnippet failed to load ["+o+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(b&&b.pathname||"_unknown_")+"\nEndpoint: "+u,parsedStack:[]}],r)),n.push((l=s,i=t,(u=(o=v(c,"Message")).data).baseType="MessageData",(r=u.baseData).message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+l+")").replace(/\"/g,"")+'"',r.properties={endpoint:i},o)),s=n,c=t,JSON&&((u=C.fetch)&&!cfg.useXhr?u(c,{method:D,body:JSON.stringify(s),mode:"cors"}):XMLHttpRequest&&((l=new XMLHttpRequest).open(D,c),l.setRequestHeader("Content-type","application/json"),l.send(JSON.stringify(s)))))))},a=function(e,t){m||setTimeout(function(){!t&&h.core||i()},500),f=!1},p=function(e){var n=O.createElement(q),e=(n.src=e,t&&(n.integrity=t),n.setAttribute("data-ai-name",E),cfg[w]);return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=a,n.onerror=i,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||a(0,t)},cfg.ld&&cfg.ld<0?O.getElementsByTagName("head")[0].appendChild(n):setTimeout(function(){O.getElementsByTagName(q)[0].parentNode.appendChild(n)},cfg.ld||0),n};p(d)}cfg.sri&&(n=o.match(/^((http[s]?:\/\/.*\/)\w+(\.\d+){1,5})\.(([\w]+\.){0,2}js)$/))&&6===n.length?(d="".concat(n[1],".integrity.json"),i="@".concat(n[4]),l=window.fetch,t=function(e){if(!e.ext||!e.ext[i]||!e.ext[i].file)throw Error("Error Loading JSON response");var t=e.ext[i].integrity||null;s(o=n[2]+e.ext[i].file,t)},l&&!cfg.useXhr?l(d,{method:"GET",mode:"cors"}).then(function(e){return e.json()["catch"](function(){return{}})}).then(t)["catch"](r):XMLHttpRequest&&((a=new XMLHttpRequest).open("GET",d),a.onreadystatechange=function(){if(a.readyState===XMLHttpRequest.DONE)if(200===a.status)try{t(JSON.parse(a.responseText))}catch(e){r()}else r()},a.send())):o&&r();try{h.cookie=O.cookie}catch(k){}function e(e){for(;e.length;)!function(t){h[t]=function(){var e=arguments;f||h.queue.push(function(){h[t].apply(h,e)})}}(e.pop())}var c,u,l="track",d="TrackPage",p="TrackEvent",l=(e([l+"Event",l+"PageView",l+"Exception",l+"Trace",l+"DependencyData",l+"Metric",l+"PageViewPerformance","start"+d,"stop"+d,"start"+p,"stop"+p,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),h.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4},(g.extensionConfig||{}).ApplicationInsightsAnalytics||{});return!0!==g[L]&&!0!==l[L]&&(e(["_"+(c="onerror")]),u=C[c],C[c]=function(e,t,n,i,a){var o=u&&u(e,t,n,i,a);return!0!==o&&h["_"+c]({message:e,url:t,lineNumber:n,columnNumber:i,error:a,evt:C.event}),o},g.autoExceptionInstrumented=!0),h}(cfg.cfg),(C[E]=n).queue&&0===n.queue.length?(n.queue.push(e),n.trackPageView({})):e();})({
src: "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js",
crossOrigin: "anonymous", // When supplied this will add the provided value as the cross origin attribute on the script tag
onInit: function (sdk) {
    sdk.addTelemetryInitializer(function (envelope) {
    envelope.data = envelope.data || {};
    envelope.data.someField = 'This item passed through my telemetry initializer';
    });
}, // Once the application insights instance has loaded and initialized this method will be called
// sri: false, // Custom optional value to specify whether fetching the snippet from integrity file and do integrity check
cfg: { // Application Insights Configuration
    connectionString: "YOUR_CONNECTION_STRING"
}});
</script>

import { ApplicationInsights } from '@microsoft/applicationinsights-web'

const appInsights = new ApplicationInsights({ config: {
  connectionString: 'YOUR_CONNECTION_STRING'
  /* ...Other Configuration Options... */
} });
appInsights.loadAppInsights();
// To insert a telemetry initializer, uncomment the following code.
/** var telemetryInitializer = (envelope) => { envelope.data = envelope.data || {}; envelope.data.someField = 'This item passed through my telemetry initializer';
 };
appInsights.addTelemetryInitializer(telemetryInitializer); **/
appInsights.trackPageView();

Para obtener un resumen de las propiedades no personalizadas disponibles en el elemento de telemetría, consulte Modelo de exportación de datos de Application Insights.

Puede agregar tantos inicializadores como desee. Se invocan en el orden en que se agregan.

Adición de un nombre de rol en la nube y una instancia de rol en la nube

Use un inicializador de telemetría para establecer las etiquetas ai.cloud.role y ai.cloud.roleInstance. Estas etiquetas definen cómo aparece el componente en el mapa de aplicaciones en Azure Monitor.

appInsights.queue.push(() => {
appInsights.addTelemetryInitializer((envelope) => {
  envelope.tags["ai.cloud.role"] = "your role name";
  envelope.tags["ai.cloud.roleInstance"] = "your role instance";
});
});

Administración de cookies

A partir de la versión 2.6.0, el SDK de JavaScript de Aplicación de Azure Insights proporciona administración de cookies basada en instancias que puede deshabilitar y volver a habilitar después de la inicialización.

Si deshabilita las cookies durante la inicialización mediante las disableCookiesUsage configuraciones o cookieCfg.enabled , puede volver a habilitarlas mediante la setEnabled función del objeto ICookieMgr.

La administración de cookies basada en instancias reemplaza las funciones globales CoreUtils anteriores de disableCookies(), setCookie()getCookie() y deleteCookie().

Para aprovechar las mejoras de vibración de árbol introducidas en la versión 2.6.0, deje de usar las funciones globales.

Configuración de cookies

ICookieMgrConfig es una configuración de cookies para la administración de cookies basada en instancias agregada en la versión 2.6.0. Las opciones que proporciona le permiten habilitar o deshabilitar el uso de cookies por parte del SDK. También puede establecer rutas de acceso y dominios de cookies personalizados y personalizar las funciones para capturar, establecer y eliminar cookies.

En la tabla siguiente se definen las ICookieMgrConfig opciones.

Mapa de origen

El soporte para mapas de origen le ayuda a depurar código JavaScript minificado al desminificar la pila de llamadas minificada de su telemetría de excepciones.

Vínculo a la cuenta de Blob Storage

Application Insights permite cargar mapas de origen en el contenedor de blobs de su cuenta de Azure Storage. Utilice mapas de origen para desofuscar las trazas de llamadas que se encuentran en la página Detalles de la transacción de extremo a extremo. También se pueden usar mapas de origen para desminificar cualquier excepción enviada por el SDK de JavaScript o el SDK de Node.js.

Creación de una cuenta de almacenamiento y un contenedor de blobs

Si ya tiene una cuenta de almacenamiento o un contenedor de blobs, puede omitir este paso.

1. Creación de una nueva cuenta de almacenamiento.

2. Cree un contenedor de blobs en la cuenta de almacenamiento. Establezca Nivel de acceso público en Privado para asegurarse de que los mapas de origen no sean accesibles públicamente.

   

Inserción de mapas de origen en el contenedor de blobs

Integre la canalización de implementación continua con la cuenta de almacenamiento configurándola para cargar automáticamente los mapas de origen en el contenedor de blobs configurado.

Se pueden cargar mapas de origen en el contenedor de Azure Blob Storage con la misma estructura de carpetas con la que se compilaron e implementaron. Un caso de uso común es prefijar una carpeta de implementación con su versión. Por ejemplo: 1.2.3/static/js/main.js. Al desminificar mediante un contenedor de blobs de Azure denominado sourcemaps, la canalización intenta capturar un mapa de origen ubicado en sourcemaps/1.2.3/static/js/main.js.map.

Carga de mapas de origen mediante Azure Pipelines (recomendado)

Si usa Azure Pipelines para compilar e implementar de forma continua la aplicación, agregue una tarea Copia de archivos de Azure a la canalización para cargar automáticamente los mapas de origen.

Configura tu recurso de Application Insights con una cuenta de almacenamiento de mapas de origen

Tiene dos opciones para configurar el recurso de Application Insights con una cuenta de almacenamiento del mapa de origen.

Hoja de detalles Transacción completa

En la pestaña Detalles de transacciones de un extremo a otro, seleccione Desminificar. Configura tu recurso si no está configurado.

1. En Azure Portal, consulte los detalles de una excepción que está minificada.
2. Seleccione Desminificar.
3. Si el recurso no estuviera configurado, configúrelo.

Pestaña Propiedades

Para configurar o cambiar la cuenta de almacenamiento o el contenedor de blobs vinculados al recurso de Application Insights:

1. Vaya a la pestaña Propiedades del recurso de Application Insights.

2. Seleccione Cambiar el contenedor de blobs del mapa de origen.

3. Seleccione un contenedor de blobs diferente como contenedor de mapas de origen.

4. Seleccione Aplicar.

   

Ver la pila de llamadas sin minimizar

Para ver la pila de llamadas no minimizada, seleccione un elemento de telemetría de excepciones en el portal de Azure, busque los mapas de origen que coincidan con la pila de llamadas y arrastre y suelte los mapas de origen sobre la pila de llamadas en el portal de Azure. El mapa de origen debe tener el mismo nombre que el archivo de origen de un marco de pila, pero con una extensión map.

Si experimenta problemas relacionados con la compatibilidad con mapas de código fuente para aplicaciones JavaScript, consulte Solución de problemas de compatibilidad con mapas de código fuente para aplicaciones JavaScript.

Agitación de árboles

El tree shaking elimina el código no utilizado del bundle final de JavaScript.

Para utilizar la agitación de árboles, importe solo los componentes necesarios del SDK en el código. Al hacerlo, se excluye el código sin usar de la agrupación final, lo que reduce su tamaño y mejora el rendimiento.

Mejoras y recomendaciones de la agitación de árboles

En la versión 2.6.0, el SDK marcó como obsoleto y eliminó el uso interno de estas clases auxiliares estáticas para mejorar la compatibilidad con los algoritmos de tree-shaking. Este cambio permite que los paquetes de npm quiten código sin usar de forma segura.

• CoreUtils
• EventHelper
• Util
• UrlHelper
• DateTimeUtils
• ConnectionStringParser

Las funciones ahora se exportan como raíces de nivel superior desde los módulos, lo que facilita la refactorización del código para mejorar la agitación de árboles.

Las clases estáticas ahora son objetos const que hacen referencia a las nuevas funciones exportadas.

Funciones y reemplazos en desuso de la agitación de árboles

Esta sección solo se aplica si usa las funciones en desuso y desea optimizar el tamaño del paquete. Para reducir el tamaño y admitir todas las versiones de Internet Explorer, use las funciones de reemplazo.

Notificaciones de servicio

El SDK incluye notificaciones de servicio que proporcionan recomendaciones accionables para ayudar a garantizar que la telemetría fluye sin interrupciones a Application Insights. Verá las notificaciones como un mensaje de excepción en Application Insights. El SDK se asegura de que las notificaciones sean relevantes para ti en función de la configuración del SDK y ajusta el nivel de detalle según la urgencia de la recomendación. Mantén activadas las notificaciones de servicio, pero puedes desactivarlas a través de la configuración featureOptIn.

Actualmente, no se están enviando notificaciones activas.

El SDK de JavaScript administra las notificaciones del servicio y sondea periódicamente un archivo JSON público para controlar y actualizar estas notificaciones. Para deshabilitar el sondeo realizado por el SDK de JavaScript, deshabilite el modo featureOptIn.

Solución de problemas

Consulte el artículo de solución de problemas dedicado.

Pasos siguientes

• Para revisar las preguntas más frecuentes (P+F), consulte Preguntas más frecuentes sobre la configuración del SDK de JavaScript.
• Realizar un seguimiento del uso.
• Tarea de copia de archivos de Azure.
• Referencia de tipos de datos de Azure Monitor y código del SDK para el SDK de JavaScript.