Microsoft Azure Monitor Application Insights JavaScript SDK-konfiguration

  • Artikel

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

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 API-anropet. 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 setPerfMgr() behöva göra 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 IE < 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

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.

Screenshot that shows selecting the option to unminify a call stack by linking with a storage account.

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.

  1. Skapa ett nytt lagringskonto.

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

    Screenshot that shows setting the container access level to Private.

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.

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.

Screenshot that shows adding an Azure file copy task to your pipeline to upload your source maps to Azure Blob Storage.

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.

  1. I Azure-portalen visar du information om ett undantag som har minimerats.
  2. Välj Unminify ( Avminifiera).
  3. 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:

  1. Gå till fliken Egenskaper för application insights-resursen.

  2. Välj Ändra källmappningsblobcontainer.

  3. Välj en annan blobcontainer som källmappningscontainer.

  4. Välj Använd.

    Screenshot that shows reconfiguring your selected Azure blob container on the Properties pane.

Visa den oförminsterade anropsstacken

Om du vill visa den oförminsterade anropsstacken väljer du ett undantagstelemetriobjekt i Azure-portalen, letar upp källkartor som matchar anropsstacken och drar och släpper källkartningarna till anropsstacken i Azure-portalen. 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.

Animation demonstrating unminify feature.

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
Anslut ionStringParser @microsoft/applicationinsights-common-js
Anslut ionStringParser.parse parsa Anslut ionString

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änstaviseringar 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.

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.

Nästa steg