Microsoft Azure Monitor Application Insights JavaScript SDK-konfiguration

Artikel
01/31/2025

Azure Application Insights JavaScript SDK tillhandahåller konfiguration för spårning, övervakning och felsökning av dina webbprogram.

SDK-konfiguration
Cookiehantering och konfiguration
Stöd för att avminifiera källkarta
Trädskakningsoptimerad kod

SDK-konfiguration

De här konfigurationsfälten är valfria och standardvärdet false om inget annat anges.

Anvisningar om hur du lägger till SDK-konfiguration finns i Lägga till SDK-konfiguration.

Namn	Type	Standardvärde
accountId Ett valfritt konto-ID om appen grupperar användare till konton. Inga blanksteg, kommatecken, semikolon, lika med eller lodräta staplar	sträng	NULL
addRequestContext Ge ett sätt att utöka beroendeloggar med kontext i början av ett API-anrop. Standardvärdet är odefinierat. Du måste kontrollera om `xhr` det finns någon `xhr` relaterad kontext. Du måste kontrollera om `fetch request` och `fetch response` finns om du konfigurerar `fetch` relaterad kontext. Annars kanske du inte får de data du behöver.	(requestContext: IRequestionContext) => {[key: string]: any}	odefinierad
ajaxPerfLookupDelay Standardvärdet är 25 ms. Hur lång tid det tar att vänta innan du försöker igen för att hitta tidsinställningar för windows.performance för en Ajax-begäran, tiden är i millisekunder och skickas direkt till setTimeout().	numeric	25
appId AppId används för korrelationen mellan AJAX-beroenden som sker på klientsidan med begäranden på serversidan. När Beacon API är aktiverat kan det inte användas automatiskt, men kan anges manuellt i konfigurationen. Standardvärdet är null	sträng	NULL
autoTrackPageVisitTime Om det är sant i en sidvy spåras den tidigare instrumenterade sidans visningstid och skickas som telemetri och en ny timer startas för den aktuella sidvyn. Det skickas som ett anpassat mått med namnet `PageVisitTime` i `milliseconds` och beräknas via funktionen Date now() (om tillgängligt) och återgår till (nytt datum()).getTime() om now() inte är tillgänglig (IE8 eller mindre). Standardvärdet är falskt.	boolean	falskt
convertUndefined Ge användaren ett alternativ för att konvertera odefinierat fält till användardefinierat värde.	`any`	odefinierad
cookieCfg Standardvärden för cookieanvändning aktiverad finns i ICookieCfgConfig-inställningar för fullständiga standardinställningar.	ICookieCfgConfig [Valfritt] (Sedan 2.6.0)	odefinierad
cookieDomain Anpassad cookiedomän. Det är användbart om du vill dela Application Insights-cookies mellan underdomäner. (Sedan v2.6.0) Om `cookieCfg.domain` definieras har det företräde framför det här värdet.	alias för `cookieCfg.domain` [Valfritt]	NULL
cookiePath Anpassad cookiesökväg. Det är användbart om du vill dela Application Insights-cookies bakom en programgateway. Om `cookieCfg.path` har definierats har det företräde.	alias för `cookieCfg.path` [Valfritt] (Sedan 2.6.0)	NULL
correlationHeaderDomains Aktivera korrelationshuvuden för specifika domäner	string[]	odefinierad
correlationHeaderExcludedDomains Inaktivera korrelationshuvuden för specifika domäner	string[]	odefinierad
correlationHeaderExcludePatterns Inaktivera korrelationshuvuden med reguljära uttryck	regex[]	odefinierad
createPerfMgr Återanropsfunktionen som anropas för att skapa en IPerfManager-instans när det behövs och `enablePerfMgr` är aktiverad gör att du kan åsidosätta standardskapandet av en PerfManager() utan att behöva göra `setPerfMgr()` det efter initieringen.	(kärna: IAppInsightsCore, notificationManager: INotificationManager) => IPerfManager	odefinierad
customHeaders Möjligheten för användaren att ange extra rubriker när du använder en anpassad slutpunkt. customHeaders läggs inte till i webbläsarens avstängningsmoment när beacon-avsändare används. Och att lägga till anpassade rubriker stöds inte på IE9 eller tidigare.	`[{header: string, value: string}]`	odefinierad
diagnosticLogInterval (internt) Avsökningsintervall (i ms) för intern loggningskö	numeric	10000
disableAjaxTracking Om det är sant hämtas inte Ajax-anrop automatiskt. Standardvärdet är falskt.	boolean	falskt
disableCookiesUsage Standard falskt. Ett booleskt värde som anger om du vill inaktivera användningen av cookies av SDK:et. Om det är sant lagrar eller läser inte SDK:t några data från cookies. (Sedan v2.6.0) Om `cookieCfg.enabled` definieras har det företräde. Cookieanvändning kan återaktiveras efter initiering via core.getCookieMgr().setEnabled(true).	alias för `cookieCfg.enabled` [Valfritt]	falskt
disableCorrelationHeaders Om det är falskt lägger SDK:t till två huvuden ("Request-Id" och "Request-Context") till alla beroendebegäranden för att korrelera dem med motsvarande begäranden på serversidan. Standardvärdet är falskt.	boolean	falskt
disableDataLossAnalysis Om det är falskt kontrolleras interna telemetrisändarbuffertar vid start för objekt som ännu inte har skickats.	boolean	true
disableExceptionTracking Om det är sant hämtas inte undantag automatiskt. Standardvärdet är falskt.	boolean	falskt
disableFetchTracking Standardinställningen för `disableFetchTracking` är `false`, vilket innebär att den är aktiverad. Men i versioner före 2.8.10 inaktiverades den som standard. När värdet `true`är inställt på samlas inte Fetch-begäranden in automatiskt. Standardinställningen ändrades från `true` till `false` i version 2.8.0.	boolean	falskt
disableFlushOnBeforeUnload Standard falskt. Om sant anropas inte flush-metoden när onBeforeUnload-händelseutlösare	boolean	falskt
disableIkeyDeprecationMessage Inaktivera felmeddelande om utfasning av instrumentationsnyckel. Om sant skickas inte felmeddelanden.	boolean	true
disableInstrumentationKeyValidation Om sant kringgås verifieringskontrollen av instrumenteringsnyckeln. Standardvärdet är "falsk".	boolean	falskt
disableTelemetry Om sant samlas inte telemetri in eller skickas. Standardvärdet är falskt.	boolean	falskt
disableXhr Använd inte XMLHttpRequest eller XDomainRequest (för Internet Explorer < version 9) som standard i stället för att försöka använda fetch() eller sendBeacon. Om ingen annan transport är tillgänglig använder den XMLHttpRequest	boolean	falskt
distributedTracingMode Anger det distribuerade spårningsläget. Om AI_AND_W3C läge eller W3C-läge har angetts genereras W3C-kontextrubriker (traceparent/tracestate) och inkluderas i alla utgående begäranden. AI_AND_W3C tillhandahålls för backkompatibilitet med alla äldre Application Insights-instrumenterade tjänster.	numerisk eller `DistributedTracingModes`	`DistributedTracing Modes.AI_AND_W3C`
enableAjaxErrorStatusText Standard falskt. Om sant, inkludera svarsfeldata text boolesk i beroendehändelse på misslyckade AJAX-begäranden.	boolean	falskt
enableAjaxPerfTracking Standard falskt. Flagga för att aktivera att söka upp och inkludera extra webbläsarfönster.prestandatider i rapporterade Ajax-mått (XHR och hämtning).	boolean	falskt
enableAutoRouteTracking Spåra routningsändringar automatiskt i ensidesprogram (SPA). Om det är sant skickar varje vägändring en ny sidvisning till Application Insights. Ändringar av hash-väg (`example.com/foo#bar`) registreras också som nya sidvyer. Obs! Om du aktiverar det här fältet aktiverar `history` du inte objektet för React-routerkonfigurationen eftersom du får flera sidvisningshändelser.	boolean	falskt
enableCorsCorrelation Om det är sant lägger SDK:t till två huvuden ("Request-Id" och "Request-Context") till alla CORS-begäranden för att korrelera utgående AJAX-beroenden med motsvarande begäranden på serversidan. Standardvärdet är falskt	boolean	falskt
enableDebug Om det är sant genereras interna felsökningsdata som ett undantag i stället för att loggas, oavsett SDK-loggningsinställningar. Standardvärdet är falskt. Obs! Om du aktiverar den här inställningen blir telemetrin borttagen när ett internt fel inträffar. Det kan vara användbart för att snabbt identifiera problem med din konfiguration eller användning av SDK. Om du inte vill förlora telemetri vid felsökning kan du överväga att använda `loggingLevelConsole` eller `loggingLevelTelemetry` i stället för `enableDebug`.	boolean	falskt
enablePerfMgr När det är aktiverat (sant) skapas lokala perfEvents för kod som har instrumenterats för att generera perfEvents (via doPerf()-hjälpen). Den kan användas för att identifiera prestandaproblem i SDK:t baserat på din användning eller eventuellt i din egen instrumenterade kod.	boolean	falskt
enableRequestHeaderTracking Om sant, AJAX och Hämta begärandehuvuden spåras är standardvärdet falskt. Om ignoreHeaders inte har konfigurerats loggas inte auktoriserings- och X-API-key-huvuden.	boolean	falskt
enableResponseHeaderTracking Om det är sant spåras SVARshuvuden för AJAX och Fetch-begäran. Standardvärdet är falskt. Om ignoreHeaders inte har konfigurerats loggas inte WWW-Authenticate-huvudet.	boolean	falskt
enableSessionStorageBuffer Standard sant. Om sant lagras bufferten med all oentlig telemetri i sessionslagringen. Bufferten återställs vid sidinläsning	boolean	true
enableUnhandledPromiseRejectionTracking Om det är sant samlas ohanterade löftesavslag automatiskt in som ett JavaScript-fel. När disableExceptionTracking är sant (spåra inte undantag) ignoreras konfigurationsvärdet och ohanterade löftesavslag rapporteras inte.	boolean	falskt
eventsLimitInMem Antalet händelser som kan sparas i minnet innan SDK:et börjar släppa händelser när du inte använder Sessionslagring (standard).	Nummer	10000
excludeRequestFromAutoTrackingPatterns Ange ett sätt att undanta en specifik väg från automatisk spårning för XMLHttpRequest- eller Fetch-begäran. Om det definieras inaktiveras automatisk spårning för en Ajax-/hämtningsbegäran om att begärande-URL:en matchar regex-mönstren. Standardvärdet är odefinierat.	string[] \| RegExp[]	odefinierad
featureOptIn Ange information om att välja funktion. Det här konfigurationsfältet är endast tillgängligt i version 3.0.3 och senare.	IFeatureOptIn	odefinierad
idLength Identifierar standardlängden som används för att generera nya slumpmässiga sessioner och användar-ID:n. Standardvärdet är 22, tidigare standardvärde är 5 (v2.5.8 eller mindre), om du behöver behålla den tidigare maximala längden bör du ange värdet till 5.	numeric	22
ignoreHeaders AJAX & Hämta begärande- och svarshuvuden som ska ignoreras i loggdata. Om du vill åsidosätta eller ta bort standardvärdet lägger du till en matris med alla rubriker som ska undantas eller en tom matris i konfigurationen.	string[]	["Authorization", "X-API-Key", "WWW-Authenticate"]
isBeaconApiDisabled Om det är falskt skickar SDK:n all telemetri med hjälp av Beacon-API:et	boolean	true
isBrowserLinkTrackingEnabled Standardvärdet är falskt. Om det är sant spårar SDK:et alla Browser Link-begäranden .	boolean	falskt
isRetryDisabled Standard falskt. Om det är falskt försöker du igen 206 (delvis lyckad), 408 (timeout), 429 (för många begäranden), 500 (internt serverfel), 503 (tjänsten är inte tillgänglig) och 0 (offline, endast om det upptäcks)	boolean	falskt
isStorageUseDisabled Om det är sant lagrar eller läser SDK inte några data från lokal lagring och sessionslagring. Standardvärdet är falskt.	boolean	falskt
loggningLevelConsole Loggar interna Application Insights-fel till konsolen. 0: av, 1: Endast kritiska fel, 2: Allt (fel och varningar)	numeric	0
loggningLevelTelemetry Skickar interna Application Insights-fel som telemetri. 0: av, 1: Endast kritiska fel, 2: Allt (fel och varningar)	numeric	1
maxAjaxCallsPerView Standard 500 – styr hur många Ajax-anrop som övervakas per sidvy. Ange till -1 för att övervaka alla (obegränsade) Ajax-anrop på sidan.	numeric	500
maxAjaxPerfLookupAttempts Standardvärdet är 3. Det maximala antalet gånger som du vill söka efter tidsinställningar för window.performance (om tillgängligt) krävs. Alla webbläsare fyller inte i window.performance innan de rapporterar slutet av XHR-begäran. För hämtningsbegäranden läggs den till när den är klar.	numeric	3
maxBatchInterval Hur länge du ska batchtelemetri för innan du skickar (millisekunder)	numeric	15000
maxBatchSizeInBytes Maximal storlek på telemetribatch. Om en batch överskrider den här gränsen skickas den omedelbart och en ny batch startas	numeric	10000
namePrefix Ett valfritt värde som används som namnpostfix för localStorage och sessionscookienamn.	sträng	odefinierad
onunloadDisableBeacon Standard falskt. när fliken stängs skickar SDK:n all återstående telemetri med hjälp av Beacon-API:et	boolean	falskt
onunloadDisableFetch Om hämtning av keepalive inte stöds använder den inte för att skicka händelser under avlastning, kan den fortfarande återgå till fetch() utan keepalive	boolean	falskt
overridePageViewDuration Om det är sant ändras standardbeteendet för trackPageView så att varaktighetsintervallet för vyns slut registreras när trackPageView anropas. Om false och ingen anpassad varaktighet anges för trackPageView beräknas sidvisningsprestandan med api:et för navigeringstid. Standardvärdet är falskt.	boolean	falskt
perfEvtsSendAll När enablePerfMgr är aktiverat och IPerfManager utlöser en INotificationManager.perfEvent() avgör den här flaggan om en händelse utlöses (och skickas till alla lyssnare) för alla händelser (sant) eller endast för "överordnade" händelser (falskt <standardvärde>). En överordnad IPerfEvent är en händelse där ingen annan IPerfEvent fortfarande körs när händelsen skapas och dess överordnade egenskap inte är null eller odefinierad. Sedan v2.5.7	boolean	falskt
samplingPercentage Procentandel händelser som skickas. Standardvärdet är 100, vilket innebär att alla händelser skickas. Ange det om du vill behålla datataket för storskaliga program.	numeric	100
sdkExtension Anger SDK-tilläggets namn. Endast alfabetiska tecken tillåts. Tilläggsnamnet läggs till som ett prefix till taggen "ai.internal.sdkVersion" (till exempel "ext_javascript:2.0.0"). Standardvärdet är null.	sträng	NULL
sessionCookiePostfix Ett valfritt värde som används som namnpostfix för sessionscookienamn. Om det är odefinierat används namePrefix som namnpostfix för sessionscookienamn.	sträng	odefinierad
sessionExpirationMs En session loggas om den har fortsatt under den här tiden i millisekunder. Standardvärdet är 24 timmar	numeric	86400000
sessionRenewalMs En session loggas om användaren är inaktiv under den här tiden i millisekunder. Standardvärdet är 30 minuter	numeric	1800000
throttleMgrCfg Ange konfiguration av begränsnings mgr per nyckel. Det här konfigurationsfältet är endast tillgängligt i version 3.0.3 och senare.	`{[key: number]: IThrottleMgrConfig}`	odefinierad
userCookiePostfix Ett valfritt värde som används som namnpostfix för användarens cookienamn. Om det är odefinierat läggs inget postfix till på användarens cookienamn.	sträng	odefinierad

Från och med version 2.6.0 tillhandahåller Azure Application Insights JavaScript SDK instansbaserad cookiehantering som kan inaktiveras och återaktiveras efter initieringen.

Om du inaktiverade cookies under initieringen med hjälp av disableCookiesUsage konfigurationerna eller cookieCfg.enabled kan du återaktivera dem med hjälp setEnabled av funktionen för ICookieMgr-objektet.

Den instansbaserade cookiehanteringen ersätter de tidigare globala CoreUtils-funktionerna disableCookies()i , setCookie(), getCookie()och deleteCookie().

Om du vill dra nytta av de trädskakningsförbättringar som introducerades i version 2.6.0 rekommenderar vi att du inte längre använder de globala funktionerna.

ICookieMgrConfig är en cookiekonfiguration för instansbaserad cookiehantering som läggs till i 2.6.0. Med de angivna alternativen kan du aktivera eller inaktivera användningen av cookies av SDK:t. Du kan också ange anpassade cookiedomäner och sökvägar och anpassa funktionerna för att hämta, ställa in och ta bort cookies.

Alternativen för ICookieMgrConfig definieras i följande tabell.

Namn	Type	Standardvärde	beskrivning
enabled	boolean	true	Den aktuella instansen av SDK använder det här booleska värdet för att ange om användningen av cookies är aktiverad. Om det är falskt lagrar eller läser inte instansen av SDK:t som initieras av den här konfigurationen några data från cookies.
domain	sträng	NULL	Anpassad cookiedomän. Det är användbart om du vill dela Application Insights-cookies mellan underdomäner. Om det inte anges används värdet från rotvärdet `cookieDomain` .
path	sträng	/	Anger sökvägen som ska användas för cookien, om den inte anges använder den något värde från rotvärdet `cookiePath` .
ignoreCookies	string[]	odefinierad	Ange vilka cookienamn som ska ignoreras, det gör att alla matchande cookienamn aldrig läses eller skrivs. De kan fortfarande rensas eller tas bort uttryckligen. Du behöver inte upprepa namnet i konfigurationen `blockedCookies` . (sedan v2.8.8)
blockedCookies	string[]	odefinierad	Ange de cookienamn som aldrig ska skrivas. Det förhindrar att cookienamn skapas eller uppdateras, men de kan fortfarande läsas om de inte också ingår i ignoreCookies. De kan fortfarande rensas eller tas bort explicit. Om den inte tillhandahålls är den standard samma lista i ignoreCookies. (Sedan v2.8.8)
getCookie	`(name: string) => string`	NULL	Funktion för att hämta det namngivna cookievärdet, om det inte anges använder den interna cookieparsing /cachelagring.
setCookie	`(name: string, value: string) => void`	NULL	Funktion för att ange den namngivna cookien med det angivna värdet, som bara anropas när du lägger till eller uppdaterar en cookie.
delCookie	`(name: string, value: string) => void`	NULL	Funktion för att ta bort den namngivna cookien med det angivna värdet, avgränsat från setCookie för att undvika behovet av att parsa värdet för att avgöra om cookien läggs till eller tas bort. Om den inte tillhandahålls använder den den interna cookieparsingen/cachelagringen.

Källkarta

Stöd för källkarta hjälper dig att felsöka minifierad JavaScript-kod med möjligheten att förena den minifierade anropstacken för undantagstelemetrin.

Kompatibel med alla aktuella integreringar på panelen Undantagsinformation
Stöder alla aktuella och framtida JavaScript-SDK:er, inklusive Node.JS, utan att behöva uppgradera SDK

Länk till Blob Storage-konto

Application Insights stöder uppladdning av källkartor till din Azure Storage-kontoblobcontainer. Du kan använda källkartor för att förena anropsstackar som finns på sidan Transaktionsinformation från slutpunkt till slutpunkt. Du kan också använda källkartor för att minimera alla undantag som skickas av JavaScript SDK eller Node.js SDK.

Skapa ett nytt lagringskonto och en blobcontainer

Om du redan har ett befintligt lagringskonto eller en blobcontainer kan du hoppa över det här steget.

Skapa ett nytt lagringskonto.
Skapa en blobcontainer i ditt lagringskonto. Ange Offentlig åtkomstnivå till Privat för att säkerställa att källkartningarna inte är offentligt tillgängliga.

Skicka källkartor till din blobcontainer

Integrera pipelinen för kontinuerlig distribution med ditt lagringskonto genom att konfigurera den för att automatiskt ladda upp källkartor till den konfigurerade blobcontainern.

Du kan ladda upp källkartor till din Azure Blob Storage-container med samma mappstruktur som de kompilerades och distribuerades med. Ett vanligt användningsfall är att prefixa en distributionsmapp med dess version, till exempel 1.2.3/static/js/main.js. När du avminifierar via en Azure-blobcontainer med namnet sourcemapsförsöker pipelinen hämta en källkarta som finns på sourcemaps/1.2.3/static/js/main.js.map.

Ladda upp källkartor via Azure Pipelines (rekommenderas)

Om du använder Azure Pipelines för att kontinuerligt skapa och distribuera ditt program lägger du till en Azure-filkopieringsuppgift i pipelinen för att automatiskt ladda upp källkartor.

Konfigurera Application Insights-resursen med ett källmappningslagringskonto

Du har två alternativ för att konfigurera application insights-resursen med ett lagringskonto för källkarta.

Fliken Transaktionsinformation från slutpunkt till slutpunkt

På fliken Transaktionsinformation från slutpunkt till slutpunkt väljer du Unminify. Konfigurera resursen om den är okonfigurerad.

I Azure Portal visar du information om ett undantag som har minimerats.
Välj Unminify ( Avminifiera).
Om resursen inte har konfigurerats konfigurerar du den.

Fliken Egenskaper

Så här konfigurerar eller ändrar du lagringskontot eller blobcontainern som är länkad till din Application Insights-resurs:

Gå till fliken Egenskaper för application insights-resursen.
Välj Ändra källmappningsblobcontainer.
Välj en annan blobcontainer som källmappningscontainer.
Välj Använd.

Visa den oförminsterade anropsstacken

Om du vill visa den oförminsterade anropsstacken väljer du ett undantagstelemetriobjekt i Azure Portal, letar upp källkartor som matchar anropsstacken och drar och släpper källkartningarna till anropsstacken i Azure Portal. Källkartan måste ha samma namn som källfilen för en stackram, men med ett map tillägg.

Om det uppstår problem med stöd för källkartor för JavaScript-program kan du läsa Felsöka stöd för källkartor för JavaScript-program.

Trädskakningar

Trädskakning eliminerar oanvänd kod från det slutliga JavaScript-paketet.

Om du vill dra nytta av trädskakning importerar du bara de nödvändiga komponenterna i SDK:n till koden. På så sätt ingår inte oanvänd kod i det slutliga paketet, vilket minskar dess storlek och förbättrar prestandan.

Förbättringar och rekommendationer för trädskakning

I version 2.6.0 tog vi bort den interna användningen av dessa statiska hjälpklasser för att förbättra stödet för trädskakningsalgoritmer. Det gör att npm-paket på ett säkert sätt kan släppa oanvänd kod.

CoreUtils
EventHelper
Util
UrlHelper
DateTimeUtils
ConnectionStringParser

Funktionerna exporteras nu som toppnivårötter från modulerna, vilket gör det enklare att omstrukturera koden för bättre trädskakning.

De statiska klasserna ändrades till const-objekt som refererar till de nya exporterade funktionerna, och framtida ändringar planeras för att ytterligare omstrukturera referenserna.

Trädskakning för inaktuella funktioner och ersättningar

Det här avsnittet gäller bara för dig om du använder de inaktuella funktionerna och vill optimera paketstorleken. Vi rekommenderar att du använder ersättningsfunktionerna för att minska storleken och stödja alla versioner av Internet Explorer.

Befintlig	Ersättning
CoreUtils	@microsoft/applicationinsights-core-js
CoreUtils._canUseCookies	Inga. Använd inte eftersom det gör att alla CoreUtils-referenser inkluderas i den slutliga koden. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().setEnabled(true/false)` för att ange värdet och `appInsights.getCookieMgr().isEnabled()` för att kontrollera värdet.
CoreUtils.isTypeof	isTypeof
CoreUtils.isUndefined	isUndefined
CoreUtils.isNullOrUndefined	isNullOrUndefined
CoreUtils.hasOwnProperty	hasOwnProperty
CoreUtils.isFunction	isFunction
CoreUtils.isObject	isObject
CoreUtils.isDate	isDate
CoreUtils.isArray	isArray
CoreUtils.isError	isError
CoreUtils.isString	isString
CoreUtils.isNumber	isNumber
CoreUtils.isBoolean	isBoolean
CoreUtils.toISOString	toISOString eller getISOString
CoreUtils.arrForEach	arrForEach
CoreUtils.arrIndexOf	arrIndexOf
CoreUtils.arrMap	arrMap
CoreUtils.arrReduce	arrReduce
CoreUtils.strTrim	strTrim
CoreUtils.objCreate	objCreateFn
CoreUtils.objKeys	objKeys
CoreUtils.objDefineAccessors	objDefineAccessors
CoreUtils.addEventHandler	addEventHandler
CoreUtils.dateNow	dateNow
CoreUtils.isIE	isIE
CoreUtils.disableCookies	disableCookies Om du refererar till någon av dem refereras CoreUtils till bakåtkompatibilitet. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().setEnabled(false)`
CoreUtils.newGuid	newGuid
CoreUtils.perfNow	perfNow
CoreUtils.newId	newId
CoreUtils.randomValue	randomValue
CoreUtils.random32	random32
CoreUtils.mwcRandomSeed	mwcRandomSeed
CoreUtils.mwcRandom32	mwcRandom32
CoreUtils.generateW3CId	generateW3CId
EventHelper	@microsoft/applicationinsights-core-js
EventHelper.Attach	attachEvent
EventHelper.AttachEvent	attachEvent
EventHelper.Detach	detachEvent
EventHelper.DetachEvent	detachEvent
Util	@microsoft/applicationinsights-common-js
Util.NotSpecified	strNotSpecified
Util.createDomEvent	createDomEvent
Util.disableStorage	utlDisableStorage
Util.isInternalApplicationInsightsEndpoint	isInternalApplicationInsightsEndpoint
Util.canUseLocalStorage	utlCanUseLocalStorage
Util.getStorage	utlGetLocalStorage
Util.setStorage	utlSetLocalStorage
Util.removeStorage	utlRemoveStorage
Util.canUseSessionStorage	utlCanUseSessionStorage
Util.getSessionStorageKeys	utlGetSessionStorageKeys
Util.getSessionStorage	utlGetSessionStorage
Util.setSessionStorage	utlSetSessionStorage
Util.removeSessionStorage	utlRemoveSessionStorage
Util.disableCookies	disableCookies Om du refererar till någon av dem refereras CoreUtils till bakåtkompatibilitet. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().setEnabled(false)`
Util.canUseCookies	canUseCookies Om du refererar till någon av dem refereras CoreUtils till bakåtkompatibilitet. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().isEnabled()`
Util.disallowsSameSiteNone	uaDisallowsSameSiteNone
Util.setCookie	coreSetCookie Referenser gör att CoreUtils refereras till för bakåtkompatibilitet. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().set(name: string, value: string)`
Util.stringToBoolOrDefault	stringToBoolOrDefault
Util.getCookie	coreGetCookie Referenser gör att CoreUtils refereras till för bakåtkompatibilitet. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().get(name: string)`
Util.deleteCookie	coreDeleteCookie Referenser gör att CoreUtils refereras till för bakåtkompatibilitet. Omstrukturera din cookiehantering för att använda `appInsights.getCookieMgr().del(name: string, path?: string)`
Util.trim	strTrim
Util.newId	newId
Util.random32	--- Ingen ersättning, omstrukturera koden för att använda core random32(true)
Util.generateW3CId	generateW3CId
Util.isArray	isArray
Util.isError	isError
Util.isDate	isDate
Util.toISOStringForIE8	toISOString
Util.getIEVersion	getIEVersion
Util.msToTimeSpan	msToTimeSpan
Util.isCrossOriginError	isCrossOriginError
Util.dump	dumpObj
Util.getExceptionName	getExceptionName
Util.addEventHandler	attachEvent
Util.IsBeaconApiSupported	isBeaconApiSupported
Util.getExtension	getExtensionByName
UrlHelper	@microsoft/applicationinsights-common-js
UrlHelper.parseUrl	urlParseUrl
UrlHelper.getAbsoluteUrl	urlGetAbsoluteUrl
UrlHelper.getPathName	urlGetPathName
UrlHelper.getCompeteUrl	urlGetCompleteUrl
UrlHelper.parseHost	urlParseHost
UrlHelper.parseFullHost	urlParseFullHost
DateTimeUtils	@microsoft/applicationinsights-common-js
DateTimeUtils.Now	dateTimeUtilsNow
DateTimeUtils.GetDuration	dateTimeUtilsDuration
ConnectionStringParser	@microsoft/applicationinsights-common-js
ConnectionStringParser.parse	parseConnectionString

Tjänstmeddelanden

Tjänstmeddelanden är en funktion som är inbyggd i SDK för att ge användbara rekommendationer för att säkerställa att dina telemetriflöden avbryts till Application Insights. Du ser meddelandena som ett undantagsmeddelande i Application Insights. Vi ser till att meddelanden är relevanta för dig baserat på dina SDK-inställningar, och vi justerar verbositeten baserat på hur brådskande rekommendationen är. Vi rekommenderar att du lämnar tjänstmeddelanden på, men du kan välja bort via konfigurationen featureOptIn . Se nedan för en lista över aktiva meddelanden.

För närvarande skickas inga aktiva meddelanden.

Tjänstmeddelanden hanteras av JavaScript SDK, som regelbundet avsöker en offentlig JSON-fil för att styra och uppdatera dessa meddelanden. Inaktivera funktionenOptIn-läge om du vill inaktivera avsökningen som gjorts av JavaScript SDK.

Felsökning

Se den dedikerade felsökningsartikeln.

Vanliga frågor och svar

Det här avsnittet innehåller svar på vanliga frågor.

Hur uppdaterar jag min serverkonfiguration från tredje part för JavaScript SDK?

Serversidan måste kunna acceptera anslutningar med de huvuden som finns. Beroende på konfigurationen Access-Control-Allow-Headers på serversidan är det ofta nödvändigt att utöka listan på serversidan genom att manuellt lägga till Request-Id, Request-Contextoch traceparent (W3C-distribuerat huvud).

Access-Control-Allow-Headers: Request-Id, traceparent, Request-Context, <your header>

Hur inaktiverar jag distribuerad spårning för JavaScript SDK?

Distribuerad spårning kan inaktiveras i konfigurationen.

Samlas HTTP 502- och 503-svaren alltid in av Application Insights?

Nej. Felen "502 bad gateway" och "503 service unavailable" registreras inte alltid av Application Insights. Om endast JavaScript på klientsidan används för övervakning skulle det här beteendet förväntas eftersom felsvaret returneras innan sidan som innehåller HTML-huvudet med javascript-övervakningsfragmentet återges.

Om svaret 502 eller 503 skickades från en server med övervakning på serversidan aktiverat samlas felen in av Application Insights SDK.

Även när övervakning på serversidan är aktiverad på ett programs webbserver, registreras ibland inte ett 502- eller 503-fel av Application Insights. Många moderna webbservrar tillåter inte att en klient kommunicerar direkt. I stället använder de lösningar som omvända proxyservrar för att skicka information fram och tillbaka mellan klienten och klientwebbservrarna.

I det här scenariot kan ett 502- eller 503-svar returneras till en klient på grund av ett problem på det omvända proxylagret, så det fångas inte in direkt av Application Insights. För att identifiera problem på det här lagret kan du behöva vidarebefordra loggar från den omvända proxyn till Log Analytics och skapa en anpassad regel för att söka efter 502- eller 503-svar. Mer information om vanliga orsaker till 502- och 503-fel finns i Felsöka HTTP-fel med "502 felaktig gateway" och "503-tjänsten är inte tillgänglig" i Azure App Service.

Dela via

Microsoft Azure Monitor Application Insights JavaScript SDK-konfiguration

SDK-konfiguration