Конфигурация пакета SDK JavaScript для Microsoft Azure Monitor Application Insights

Пакет SDK javaScript для приложение Azure Insights предоставляет конфигурацию для отслеживания, мониторинга и отладки веб-приложений.

Конфигурация пакета SDK

Эти поля конфигурации являются необязательными и по умолчанию имеют значение false, если иное не указано.

Инструкции по добавлению конфигурации пакета SDK см. в разделе "Добавление конфигурации пакета SDK".

Распределенная трассировка

Современные архитектуры облачных и микрослужб включили простые, независимо развертываемые службы, которые сокращают затраты при увеличении доступности и пропускной способности. Тем не менее, это сделало всю систему более сложной для анализа и отладки. Распределенная трассировка решает эту проблему, предоставляя профилировщик производительности, который работает как стеки вызовов для облачных архитектур и архитектур микросервисов.

Azure Monitor предоставляет два способа использования распределенных данных трассировки: представление диагностики транзакций для одной транзакции или запроса и представления карты приложения , чтобы показать, как системы взаимодействуют.

Application Insights может отслеживать каждый компонент отдельно и обнаруживать, какой компонент отвечает за сбои или снижение производительности с помощью корреляции распределенной телеметрии. В этой статье объясняется модель данных, методы распространения контекста, протоколы и реализация тактики корреляции на разных языках и платформах, используемых Application Insights.

Активировать распределенную трассировку через Application Insights с помощью автоинструментации или SDK.

Агенты Application Insights и пакеты SDK для .NET, .NET Core, Java, Node.jsи JavaScript поддерживают собственную распределенную трассировку.

Если SDK Application Insights установлено и настроено правильно, то данные трассировки автоматически собираются для популярных фреймворков, библиотек и технологий с помощью автоматических сборщиков зависимостей SDK. Полный список поддерживаемых технологий доступен в документации по автоколлекции зависимостей.

Любые технологии также можно отслеживать вручную с помощью вызова TrackDependency в TelemetryClient.

Модель данных для корреляции телеметрии

Application Insights определяет модель данных для корреляции распределенной телеметрии. Для связывания телеметрии с логической операцией каждый элемент телеметрии имеет поле operation_Idконтекста. Каждый элемент телеметрии в распределенной трассировке использует этот идентификатор. Таким образом, даже если вы теряете данные телеметрии из одного слоя, вы по-прежнему можете связать данные телеметрии, сообщаемые другими компонентами.

Распределенная логическая операция обычно состоит из набора небольших операций, обрабатываемых одним из компонентов. Запрос телеметрии определяет эти операции. Каждый элемент телеметрии запроса имеет свой собственный id идентификатор, определяющий его уникально и глобально. И все элементы телеметрии (например, трассировки и исключения), связанные с запросом, должны установить operation_parentId в значение запроса id.

Телеметрия зависимостей представляет каждую исходящую операцию, например вызов HTTP к другому компоненту. Он также определяет свой собственный id, который является глобально уникальным. Запрос телеметрии, инициированный этим вызовом зависимостей, использует это id как его operation_parentId.

Вы можете создать представление распределенной логической операции с помощью operation_Id, operation_parentId, request.id и dependency.id. Эти поля также определяют причинно-следственный порядок вызовов телеметрии.

В среде микрослужб трассировки из компонентов могут направляться в разные элементы хранилища. Каждый компонент может иметь собственную строку подключения в Application Insights. Чтобы получить данные телеметрии для логической операции, Application Insights запрашивает данные из каждого элемента хранилища.

Если количество элементов хранилища значительное, вам потребуется указание о том, где искать дальше. Модель данных Application Insights определяет два поля для решения этой проблемы: request.source и dependency.target. Первое поле определяет компонент, инициирующий запрос зависимостей. Второе поле определяет, какой компонент вернул ответ вызова зависимостей.

Сведения о запросах из нескольких разрозненных экземпляров см. в разделе "Запрос данных в рабочих пространствах Log Analytics, приложениях и ресурсах в Azure Monitor".

Example

Рассмотрим пример. Приложение под названием "Цены акций" показывает текущую рыночную цену акций с помощью внешнего API с именем Stock. Приложение "Цены на акции" имеет страницу с именем "Фондовая страница", которая открывается в веб-браузере клиента с помощью GET /Home/Stock. Приложение запрашивает API stock с помощью http-вызова GET /api/stock/value.

Чтобы проанализировать полученную телеметрию, выполните запрос:

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

В результатах все элементы телеметрии используют общий корень operation_Id. При вызове Ajax на странице новый уникальный идентификатор (qJSXU) назначается телеметрии зависимостей, а идентификатор pageView используется как operation_ParentId. Затем запрос сервера использует идентификатор Ajax в качестве operation_ParentId.

При вызове GET /api/stock/value внешней службы необходимо знать идентификацию сервера, чтобы можно было соответствующим образом установить поле dependency.target. Если внешняя служба не поддерживает мониторинг, target устанавливается в имя узла службы. Примером является stock-prices-api.com. Но если служба идентифицирует себя путем возврата предопределенного заголовка HTTP, target содержит удостоверение службы, позволяющее Application Insights создавать распределенную трассировку путем запроса телеметрии из этой службы.

Заголовки корреляции с помощью W3C TraceContext

Application Insights переходит в контекст трассировки W3C, который определяет:

• traceparent: содержит глобальный уникальный идентификатор операции и уникальный идентификатор вызова.
• tracestate: содержит контекст трассировки для конкретной системы.

Последняя версия пакета SDK Application Insights поддерживает протокол Trace-Context, но может потребоваться принять его. (Поддерживается обратная совместимость с предыдущим протоколом корреляции, поддерживаемым пакетом SDK Application Insights.)

Протокол HTTP корреляции, также называемый Request-Id, устарел. Этот протокол определяет два заголовка:

• Request-Id: несет глобально уникальный идентификатор вызова.
• Correlation-Context: содержит коллекцию пар "имя-значение" свойств распределенной трассировки.

Application Insights также определяет расширение для протокола HTTP корреляции. Он использует Request-Context пары "имя-значение" для распространения коллекции свойств, используемых непосредственным вызывающим или вызываемой стороной. Пакет SDK Application Insights использует этот заголовок для задания полей dependency.target и request.source.

Модели данных W3C Trace-Context и Application Insights сопоставляются следующим образом:

Дополнительные сведения см. в модели данных телеметрии Application Insights.

Включение поддержки распределенной трассировки W3C

Эта функция включена по умолчанию для JavaScript, а заголовки автоматически включаются, когда домен страницы размещения совпадает с доменом, в который отправляются запросы (например, страница размещения и example.com запросы Ajax отправляются в example.com). Чтобы изменить режим распределенной трассировки, используйте distributedTracingMode поле конфигурации. AI_AND_W3C предоставляется по умолчанию для обратной совместимости с любыми устаревшими службами, инструментируемыми Application Insights.

• Настройка на основе npm

  Добавьте следующую конфигурацию.

    distributedTracingMode: DistributedTracingModes.W3C
  

• Настройка скрипта загрузчика пакета SDK для JavaScript (Web)

  Добавьте следующую конфигурацию.

      distributedTracingMode: 2 // DistributedTracingModes.W3C
  

Если запросы XMLHttpRequest или Fetch Ajax отправляются другому узлу домена, включая поддомены, заголовки корреляции по умолчанию не включаются. Чтобы включить эту функцию, задайте значение в поле конфигурации enableCorsCorrelation как true. Если задано значение enableCorsCorrelationtrue, все запросы XMLHttpRequest и Fetch Ajax включают заголовки корреляции. В результате, если приложение на сервере, который вызывается, не поддерживает traceparent заголовок, запрос может завершиться ошибкой в зависимости от того, может ли браузер или версия проверить запрос на основе того, какие заголовки принимает сервер. Можно использовать correlationHeaderExcludedDomains поле конфигурации для исключения домена сервера из внедрения заголовка корреляции между компонентами. Например, вы можете использовать correlationHeaderExcludedDomains: ['*.auth0.com'] для исключения заголовков корреляции из запросов, отправляемых поставщику удостоверений Auth0.

Фильтрация и предварительная обработка телеметрии

Вы можете написать код для фильтрации, изменения или обогащения телеметрии перед отправкой из пакета SDK. Обработка включает данные, отправленные из стандартных модулей телеметрии, таких как сбор HTTP-запросов и сбор зависимостей.

• Фильтрация может изменять или удалять данные телеметрии перед отправкой из пакета SDK путем реализации ITelemetryProcessor. Например, можно уменьшить объем телеметрии, исключив запросы от роботов. В отличие от выборки, у вас есть полный контроль над отправкой или отбрасыванием данных, но это влияет на любые метрики, основанные на агрегированных журналах. В зависимости от способа удаления элементов вы также можете потерять возможность перемещаться между связанными элементами.

• Добавьте или измените свойства для любых данных телеметрии, отправляемых из вашего приложения, путем реализации ITelemetryInitializer. Например, можно добавить вычисляемые значения или номера версий, с помощью которых можно фильтровать данные на портале.

• Выборка уменьшает объем данных телеметрии, не влияя на статистику. Он объединяет связанные точки данных, чтобы можно было перемещаться между ними при диагностике проблемы. На портале общие показатели умножаются, чтобы компенсировать отклонения выборки.

Filtering

Этот метод обеспечивает прямой контроль над тем, что включается или исключается из потока телеметрии. Фильтрация может использоваться для исключения элементов телеметрии из передачи в Application Insights. Фильтрацию можно использовать с сэмплированием или отдельно.

Чтобы отфильтровать данные телеметрии, необходимо написать обработчик телеметрии и зарегистрировать его в TelemetryConfiguration. Все данные телеметрии проходят через процессор. Вы можете удалить его из потока или передать его следующему процессору в цепочке. Данные телеметрии из стандартных модулей, таких как сборщик HTTP-запросов и сборщик зависимостей, а также данные телеметрии, которые вы отслеживали самостоятельно. Например, можно отфильтровать данные телеметрии о запросах от роботов или успешных вызовов зависимостей.

Веб-приложения JavaScript

Данные телеметрии можно фильтровать из веб-приложений JavaScript с помощью ITelemetryInitializer.

1. Создайте функцию обратного вызова инициализатора телеметрии. Функция обратного вызова принимает ITelemetryItem в качестве параметра, который является событием, которое обрабатывается. Возврат false из этого обратного вызова приводит к тому, что элемент телеметрии отфильтровывается.

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

2. Добавьте обратный вызов инициализатора телеметрии:

   appInsights.addTelemetryInitializer(filteringFunction);
   

ITelemetryProcessor и ITelemetryInitializer

Какова разница между процессорами телеметрии и инициализаторами телеметрии?

• Есть некоторые пересечения в том, что вы можете делать с ними. Их можно использовать для добавления или изменения свойств телеметрии, хотя мы рекомендуем использовать инициализаторы для этой цели.
• Инициализаторы телеметрии всегда выполняются перед процессорами телеметрии.
• Инициализаторы телеметрии могут вызываться несколько раз. По соглашению они не задают какое-либо свойство, которое уже было задано.
• Процессоры телеметрии позволяют полностью заменить или отменить элемент телеметрии.
• Все зарегистрированные инициализаторы телеметрии вызываются для каждого элемента телеметрии. Для процессоров телеметрии пакет SDK гарантирует вызов первого процессора телеметрии. Определение того, будут ли вызваны остальные процессоры, осуществляется предыдущими процессорами телеметрии.
• Инициализаторы телеметрии используются для обогащения телеметрии дополнительными свойствами или переопределения существующей. Используйте обработчик телеметрии для фильтрации телеметрии.

Добавление и изменение свойств

Инициализаторы телеметрии используются для обогащения телеметрии дополнительными сведениями или переопределения свойств телеметрии, заданных стандартными модулями телеметрии.

Например, Application Insights для веб-пакета собирает данные телеметрии о HTTP-запросах. По умолчанию он помечает любой запрос с кодом ответа >>=400 как неудачный. Если вместо этого вы хотите рассматривать 400 как успешный, можно предоставить инициализатор телеметрии, который задает свойство успешности.

Если вы предоставляете инициализатор телеметрии, он вызывается всякий раз, когда вызывается любой из методов Track*(). Этот инициализатор включает Track() методы, вызываемые стандартными модулями телеметрии. По соглашению эти модули не задают никаких свойств, которые уже были заданы инициализатором. Инициализаторы телеметрии вызываются перед вызовом процессоров телеметрии, поэтому любые обогащения, выполненные инициализаторами, видны процессорам.

Инициализаторы телеметрии JavaScript

При необходимости вставьте инициализатор телеметрии JavaScript. Дополнительные сведения о инициализаторах телеметрии для пакета SDK JavaScript Application Insights см. в разделе " Инициализаторы телеметрии".

<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();

Сводку по нестандартным свойствам, доступным в элементе телеметрии, см. в статье Application Insights Export Data Model.

Вы можете добавить столько инициализаторов, сколько вам нравится. Они вызываются в том порядке, в котором добавлены.

Добавьте имя облачной роли и экземпляр облачной роли

Используйте инициализатор телеметрии для установки тегов ai.cloud.role и ai.cloud.roleInstance. Эти теги определяют, как компонент отображается в схеме приложений в Azure Monitor.

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

Управление файлами cookie

Начиная с версии 2.6.0, SDK JavaScript Azure Application Insights предоставляет управление куками на основе экземпляров, которое можно отключить и повторно включить после инициализации.

Если вы отключили файлы cookie при инициализации с помощью конфигураций disableCookiesUsage или cookieCfg.enabled, вы можете снова включить их, используя функцию setEnabled объекта ICookieMgr.

Управление файлами cookie на основе экземпляров заменяет предыдущие глобальные функции disableCookies()CoreUtils , а setCookie()getCookie()deleteCookie()также .

Чтобы воспользоваться преимуществами оптимизации кода, представленными в версии 2.6.0, рекомендуется больше не использовать глобальные функции.

Конфигурация файла cookie

ICookieMgrConfig — это конфигурация для управления файлами cookie на основе экземпляров, добавленная в версии 2.6.0. Указанные параметры позволяют включить или отключить использование файлов cookie пакетом SDK. Вы также можете настроить пользовательские домены и пути cookie, а также настроить функции для получения, настройки и удаления файлов cookie.

Параметры ICookieMgrConfig определены в следующей таблице.

Исходная карта

Поддержка исходной карты помогает отлаживать минифицированный код JavaScript с возможностью отмены минифицированного вызова телеметрии исключений.

Связь с учетной записью хранилища объектов BLOB

Application Insights поддерживает загрузку карт источников в контейнер блобов учетной записи хранения Azure. С помощью карт исходного кода можно преобразовать стеки вызовов из минифицированного вида, найденные на странице сведений о сквозных транзакциях. Вы также можете использовать карты источников, чтобы отменить любое исключение, отправленное пакетом SDK JavaScript или пакетом SDK для Node.js.

Создание учетной записи для хранения и контейнера для блобов

Если у вас уже есть учетная запись хранения или BLOB-контейнер, вы можете пропустить этот шаг.

1. Создайте новую учетную запись хранения.

2. Создайте контейнер объектов blob в вашей учетной записи хранения. Установите уровень общего доступа на Приватный, чтобы ваши исходные карты не были доступны публично.

   

Отправьте исходные карты в контейнер с BLOB-объектами

Интегрируйте конвейер непрерывного развертывания с вашей учетной записью хранения, настроив его для автоматической отправки карт исходного кода в настроенный контейнер объектов BLOB.

Вы можете передать исходные карты в контейнер Хранилище BLOB-объектов Azure с той же структурой папок, с которыми они были скомпилированы и развернуты. Распространенный вариант использования — добавлять версию перед названием папки развертывания, например 1.2.3/static/js/main.js. При развертывании минифицированного кода через контейнер Azure Blob под названием sourcemaps, конвейер пытается получить исходную карту, расположенную по адресу sourcemaps/1.2.3/static/js/main.js.map.

Рекомендуется загрузить карты исходного кода через Azure Pipelines.

Если вы используете Azure Pipelines для непрерывной сборки и развертывания приложения, добавьте задачу копирования файлов Azure в конвейер для автоматической отправки исходных карт.

Настройте ресурс Application Insights с учетной записью хранения исходных карт.

У вас есть два варианта настройки ресурса Application Insights с учетной записью хранения карт исходного кода.

Вкладка "Информация о сквозных транзакциях от начала до конца"

На вкладке Детали сквозной транзакции выберите Деминифицировать. Настройте ресурс, если он не настроен.

1. На портале Azure просмотрите сведения о минимизированном исключении.
2. Выберите Unminify.
3. Если ресурс не настроен, настройте его.

Вкладка Свойства

Чтобы настроить или изменить учетную запись хранения или контейнер BLOB-объектов, связанный с ресурсом Application Insights:

1. Перейдите на вкладку "Свойства " ресурса Application Insights.

2. Выберите "Изменить исходный контейнер Blob".

3. Выберите другой контейнер Blob в качестве контейнера карты источника.

4. Выберите Применить.

   

Просмотр нераминифицированного стека вызовов

Чтобы просмотреть не минифицированный стек вызовов, выберите элемент телеметрии исключений в портале Azure, найдите исходные карты, соответствующие стеку вызовов, и перетащите исходные карты в стек вызовов в портале Azure. Исходная карта должна иметь то же имя, что и исходный файл кадра стека, но с расширением map .

Если возникают проблемы, связанные с поддержкой карт источника для приложений JavaScript, см. статью "Устранение неполадок с поддержкой карты источника" для приложений JavaScript.

Древовидная тряска

Древовидная тряска устраняет неиспользуемый код из окончательного пакета JavaScript.

Чтобы воспользоваться преимуществами тряски дерева, импортируйте только необходимые компоненты пакета SDK в код. Таким образом, неиспользуемый код не включается в окончательный пакет, уменьшая его размер и повышая производительность.

Усовершенствования и рекомендации по древовидной тряски

В версии 2.6.0 мы объявили устаревшими и удалили внутреннее использование этих статических вспомогательных классов, чтобы улучшить поддержку алгоритмов tree-shaking. Он позволяет пакетам npm безопасно удалять неиспользуемый код.

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

Теперь функции экспортируются в виде корней верхнего уровня из модулей, что упрощает рефакторинг кода для улучшения тряски дерева.

Статические классы были изменены на константные объекты, ссылающиеся на новые экспортированные функции, и будущие изменения планируются для дальнейшего рефакторинга ссылок.

Оптимизация кода с удалением устаревших функций и их замены.

Этот раздел применяется только к вам, если вы используете устаревшие функции и хотите оптимизировать размер пакета. Мы рекомендуем использовать функции замены для уменьшения размера и поддержки всех версий Internet Explorer.

Уведомления службы

Уведомления службы — это функция, встроенная в пакет SDK для предоставления практических рекомендаций, которые помогут обеспечить непрерывность потоков телеметрии в Application Insights. Уведомления можно просмотреть как сообщение об исключении в Application Insights. Мы обеспечиваем, чтобы уведомления были актуальны для вас в соответствии с настройками вашего SDK, и корректируем степень подробности на основе срочности рекомендации. Мы рекомендуем оставлять уведомления о сервисе включенными, однако вы можете отключить их через конфигурацию featureOptIn.

В настоящее время активные уведомления не отправляются.

Уведомления службы управляются пакетом SDK JavaScript, который регулярно опрашивает общедоступный JSON-файл для управления и обновления этих уведомлений. Чтобы отключить опросы, выполняемые SDK для JavaScript, отключите режим featureOptIn.

Устранение неполадок

См. специальные инструкции по устранению неполадок.

Следующие шаги

• Чтобы просмотреть часто задаваемые вопросы о настройке пакета SDK для JavaScript, ознакомьтесь с часто задаваемыми вопросами о настройке пакета SDK для JavaScript.
• Отслеживание использования
• Задача копирования файлов Azure
• Справочник по типам данных Azure Monitor и код пакета SDK для пакета SDK для JavaScript.