Microsoft Azure Monitor Application Insights JavaScript SDK-configuratie

De Azure-toepassing Insights JavaScript SDK biedt configuratie voor het bijhouden, bewaken en opsporen van fouten in uw webtoepassingen.

SDK-configuratie

Deze configuratievelden zijn optioneel en zijn standaard ingesteld op onwaar, tenzij anders vermeld.

Zie SDK-configuratie toevoegen voor instructies over het toevoegen van SDK-configuratie.

Name Type Standaard
accountId

Een optionele account-id, als uw app gebruikers in accounts groepeer. Geen spaties, komma's, puntkomma's, is gelijk aan of verticale balken
tekenreeks Nul
addRequestContext

Bied een manier om afhankelijkhedenlogboeken te verrijken met context aan het begin van de API-aanroep. De standaardwaarde is niet gedefinieerd. U moet controleren of xhr deze bestaat als u gerelateerde context configureert xhr . U moet controleren of fetch request en fetch response bestaat als u gerelateerde context configureert fetch . Anders krijgt u mogelijk niet de gegevens die u nodig hebt.
(requestContext: IRequestionContext) => {[key: string]: any} Ongedefinieerde
ajaxPerfLookupDelay

De standaardwaarde is 25 ms. De hoeveelheid tijd die moet worden gewacht voordat de tijdsinstellingen voor windows.performance voor een Ajax-aanvraag worden gevonden, is de tijd in milliseconden en wordt rechtstreeks doorgegeven aan setTimeout().
numeriek 25
appId

AppId wordt gebruikt voor de correlatie tussen AJAX-afhankelijkheden die plaatsvinden aan de clientzijde met de aanvragen aan de serverzijde. Wanneer Beacon-API is ingeschakeld, kan deze niet automatisch worden gebruikt, maar kan deze handmatig worden ingesteld in de configuratie. De standaardwaarde is null
tekenreeks Nul
autoTrackPageVisitTime

Indien waar, wordt op een paginaweergave de weergavetijd van de vorige geïnstrueerde pagina bijgehouden en verzonden als telemetrie en wordt er een nieuwe timer gestart voor de huidige paginaweergave. Het wordt verzonden als een aangepaste metriek met de naam PageVisitTime in milliseconds en wordt berekend via de functie Date now() (indien beschikbaar) en valt terug op (nieuwe Datum()).getTime() if now() is niet beschikbaar (IE8 of minder). Standaard ingesteld op onwaar.
boolean false
convertUndefined

Geef de gebruiker een optie op om een niet-gedefinieerd veld te converteren naar een door de gebruiker gedefinieerde waarde.
any Ongedefinieerde
cookieCfg

Standaardinstellingen voor cookiegebruik ingeschakeld, zie ICookieCfgConfig-instellingen voor volledige standaardinstellingen.
ICookieCfgConfig
[Optioneel]
(Sinds 2.6.0)
Ongedefinieerde
cookieDomain

Aangepast cookiedomein. Het is handig als u Application Insights-cookies wilt delen tussen subdomeinen.
(Sinds v2.6.0) Als cookieCfg.domain dit is gedefinieerd, heeft deze prioriteit boven deze waarde.
alias voor cookieCfg.domain
[Optioneel]
Nul
cookiePath

Aangepast cookiepad. Het is handig als u Application Insights-cookies wilt delen achter een toepassingsgateway.
Als cookieCfg.path dit is gedefinieerd, heeft deze voorrang.
alias voor cookieCfg.path
[Optioneel]
(Sinds 2.6.0)
Nul
correlationHeaderDomains

Correlatieheaders inschakelen voor specifieke domeinen
tekenreeks[] Ongedefinieerde
correlationHeaderExcludedDomains

Correlatieheaders uitschakelen voor specifieke domeinen
tekenreeks[] Ongedefinieerde
correlationHeaderExcludePatterns

Correlatieheaders uitschakelen met behulp van reguliere expressies
regex[] Ongedefinieerde
createPerfMgr

Met de callback-functie die wordt aangeroepen om een IPerfManager-exemplaar te maken wanneer dat nodig is en enablePerfMgr is ingeschakeld, kunt u het standaard maken van een PerfManager() overschrijven zonder dat u dit hoeft te setPerfMgr() doen na de initialisatie.
(kern: IAppInsightsCore, notificationManager: INotificationManager) => IPerfManager Ongedefinieerde
customHeaders

De mogelijkheid voor de gebruiker om extra headers te bieden bij het gebruik van een aangepast eindpunt. customHeaders worden niet toegevoegd tijdens het afsluiten van de browser wanneer de afzender van het beacon wordt gebruikt. En het toevoegen van aangepaste headers wordt niet ondersteund op IE9 of eerder.
[{header: string, value: string}] Ongedefinieerde
diagnosticLogInterval

(intern) Polling-interval (in ms) voor interne logboekregistratiewachtrij
numeriek 10000
disableAjaxTracking

Indien waar, worden Ajax-aanroepen niet automatisch opgehaald. Standaard ingesteld op onwaar.
boolean false
disableCookiesUsage

Standaard false. Een Booleaanse waarde die aangeeft of het gebruik van cookies door de SDK moet worden uitgeschakeld. Indien waar, slaat de SDK geen gegevens van cookies op of leest deze niet.
(Sinds v2.6.0) Als cookieCfg.enabled deze is gedefinieerd, heeft deze voorrang. Cookiegebruik kan na initialisatie opnieuw worden ingeschakeld via core.getCookieMgr().setEnabled(true).
alias voor cookieCfg.enabled
[Optioneel]
false
disableCorrelationHeaders

Als dit onwaar is, voegt de SDK twee headers ('Request-Id' en 'Request-Context') toe aan alle afhankelijkheidsaanvragen om deze te correleren met overeenkomende aanvragen aan de serverzijde. Standaard ingesteld op onwaar.
boolean false
disableDataLossAnalysis

Als dit onwaar is, worden interne buffers voor telemetriezenders gecontroleerd bij het opstarten van items die nog niet zijn verzonden.
boolean true
disableExceptionTracking

Indien waar, worden uitzonderingen niet automatisch opgehaald. Standaard ingesteld op onwaar.
boolean false
disableFetchTracking

De standaardinstelling disableFetchTracking is false, wat betekent dat deze is ingeschakeld. In versies vóór 2.8.10 was het echter standaard uitgeschakeld. Wanneer dit is ingesteld true, worden ophalen van aanvragen niet automatisch verzameld. De standaardinstelling is gewijzigd van true in false versie 2.8.0.
boolean false
disableFlushOnBeforeUnload

Standaard false. Indien waar, wordt de flush-methode niet aangeroepen wanneer onBeforeUnload-gebeurtenistriggers
boolean false
disableIkeyDeprecationMessage

Foutbericht over afschaffing van instrumentatiesleutel uitschakelen. Indien waar, worden er geen foutberichten verzonden.
boolean true
disableInstrumentationKeyValidation

Indien waar, wordt de validatiecontrole voor instrumentatiesleutels overgeslagen. De standaardwaarde is false.
boolean false
disableTelemetry

Indien waar, wordt telemetrie niet verzameld of verzonden. Standaard ingesteld op onwaar.
boolean false
disableXhr

Gebruik niet standaard XMLHttpRequest of XDomainRequest (voor IE < 9) in plaats daarvan om fetch() of sendBeacon te gebruiken. Als er geen ander transport beschikbaar is, wordt XMLHttpRequest gebruikt
boolean false
gedistribueerdeTracingMode

Hiermee stelt u de gedistribueerde traceringsmodus in. Als AI_AND_W3C- of W3C-modus is ingesteld, worden W3C-contextheaders (traceparent/tracestate) gegenereerd en opgenomen in alle uitgaande aanvragen. AI_AND_W3C wordt geleverd voor back-compatibiliteit met oudere Application Insights-services.
numeriek of DistributedTracingModes DistributedTracing Modes.AI_AND_W3C
enableAjaxErrorStatusText

Standaard false. Indien waar, neemt u de tekst van antwoordfouten op in booleaanse tekst in de afhankelijkheidsgebeurtenis voor mislukte AJAX-aanvragen.
boolean false
enableAjaxPerfTracking

Standaard false. Vlag voor het opzoeken en opnemen van extra tijdsinstellingen voor browservensters.prestaties in de gerapporteerde Ajax (XHR en ophalen) gerapporteerde metrische gegevens.
boolean false
enableAutoRouteTracking

Routewijzigingen automatisch bijhouden in toepassingen met één pagina (BEVEILIGD-WACHTWOORDVERIFICATIE). Indien waar, stuurt elke routewijziging een nieuwe Pageview naar Application Insights. Wijzigingen in hashroute (example.com/foo#bar) worden ook vastgelegd als nieuwe paginaweergaven.
Opmerking: Als u dit veld inschakelt, schakelt u het history object niet in voor react-routerconfiguratie omdat u meerdere paginaweergave-gebeurtenissen krijgt.
boolean false
enableCorsCorrelation

Indien waar, voegt de SDK twee headers ('Request-Id' en 'Request-Context') toe aan alle CORS-aanvragen om uitgaande AJAX-afhankelijkheden te correleren met bijbehorende aanvragen aan de serverzijde. De standaardwaarde is onwaar
boolean false
enableDebug

Indien waar, worden interne foutopsporingsgegevens gegenereerd als een uitzondering in plaats van te worden vastgelegd, ongeacht de instellingen voor SDK-logboekregistratie. Standaard ingesteld op onwaar.
Opmerking: het inschakelen van deze instelling resulteert in verwijderde telemetrie wanneer er een interne fout optreedt. Dit kan handig zijn voor het snel identificeren van problemen met uw configuratie of het gebruik van de SDK. Als u geen telemetrie wilt verliezen tijdens foutopsporing, kunt u overwegen loggingLevelConsole of loggingLevelTelemetry in plaats van enableDebug.
boolean false
enablePerfMgr

Als deze optie is ingeschakeld (waar), worden lokale perfEvents gemaakt voor code die is geïnstrueerd om perfEvents (via de doPerf()-helper te verzenden. Het kan worden gebruikt om prestatieproblemen in de SDK te identificeren op basis van uw gebruik of optioneel in uw eigen geïnstrueerde code.
boolean false
enableRequestHeaderTracking

Indien waar, wordt AJAX & Fetch-aanvraagheaders bijgehouden, is de standaardwaarde onwaar. Als ignoreHeaders niet is geconfigureerd, worden autorisatie- en X-API-sleutelheaders niet geregistreerd.
boolean false
enableResponseHeaderTracking

Indien waar, worden de antwoordheaders van AJAX & Fetch-aanvragen bijgehouden, is de standaardwaarde onwaar. Als ignoreHeaders niet is geconfigureerd, wordt de header WWW-Authenticate niet geregistreerd.
boolean false
enableSessionStorageBuffer

Standaard waar. Indien waar, wordt de buffer met alle niet-verzonden telemetrie opgeslagen in sessieopslag. De buffer wordt hersteld bij het laden van pagina's
boolean true
enableUnhandledPromiseRejectionTracking

Indien waar, worden onverwerkte beloftes geweigerd als een JavaScript-fout. Wanneer disableExceptionTracking waar is (uitzonderingen niet bijhouden), wordt de configuratiewaarde genegeerd en worden niet-verwerkte beloftes afgewezen.
boolean false
eventsLimitInMem

Het aantal gebeurtenissen dat in het geheugen kan worden bewaard voordat de SDK begint met het verwijderen van gebeurtenissen wanneer sessieopslag niet wordt gebruikt (de standaardinstelling).
Nummer 10000
excludeRequestFromAutoTrackingPatterns

Een manier bieden om specifieke route uit te sluiten van automatische tracering voor XMLHttpRequest of Fetch-aanvraag. Indien gedefinieerd, wordt automatisch bijhouden uitgeschakeld voor een Ajax/fetch-aanvraag die de aanvraag-URL overeenkomt met de regex-patronen. De standaardwaarde is niet gedefinieerd.
tekenreeks[] | RegExp[] Ongedefinieerde
featureOptIn

Stel de functie-opt in details in.

Dit configuratieveld is alleen beschikbaar in versie 3.0.3 en hoger.
IFeatureOptIn Ongedefinieerde
idLength

Identificeert de standaardlengte die wordt gebruikt voor het genereren van nieuwe willekeurige sessie- en gebruikers-id's. De standaardwaarde is standaard ingesteld op 22, de vorige standaardwaarde was 5 (v2.5.8 of minder), als u de vorige maximumlengte wilt behouden, moet u de waarde instellen op 5.
numeriek 22
ignoreHeaders

AJAX & Fetch-aanvraag- en antwoordheaders die moeten worden genegeerd in logboekgegevens. Als u de standaardwaarde wilt overschrijven of negeren, voegt u een matrix toe met alle koppen die moeten worden uitgesloten of een lege matrix aan de configuratie.
tekenreeks[] ["Authorization", "X-API-Key", "WWW-Authenticate"]
isBeaconApiDisabled

Als dit onwaar is, verzendt de SDK alle telemetrie met behulp van de Beacon-API
boolean true
isBrowserLinkTrackingEnabled

Standaard ingesteld op onwaar. Indien waar, houdt de SDK alle browserkoppelingsaanvragen bij.
boolean false
isRetryDisabled

Standaard false. Als dit onwaar is, probeert u het opnieuw op 206 (gedeeltelijk geslaagd), 408 (time-out), 429 (te veel aanvragen), 500 (interne serverfout), 503 (service niet beschikbaar) en 0 (alleen als deze is gedetecteerd)
boolean false
isStorageUseDisabled

Indien waar, slaat de SDK geen gegevens op uit lokale en sessieopslag of leest deze. Standaard ingesteld op onwaar.
boolean false
loggingLevelConsole

Registreert interne Application Insights-fouten in de console.
0: uit,
1: Alleen kritieke fouten,
2: Alles (fouten en waarschuwingen)
numeriek 0
loggingLevelTelemetry

Hiermee worden interne Application Insights-fouten als telemetrie verzonden.
0: uit,
1: Alleen kritieke fouten,
2: Alles (fouten en waarschuwingen)
numeriek 1
maxAjaxCallsPerView

Standaard 500 : bepaalt hoeveel Ajax-aanroepen per paginaweergave worden bewaakt. Ingesteld op -1 om alle (onbeperkte) Ajax-aanroepen op de pagina te bewaken.
numeriek 500
maxAjaxPerfLookupAttempts

Standaardwaarde is 3. Het maximum aantal keren dat moet worden gezocht naar de tijdsinstellingen van window.performance (indien beschikbaar) is vereist. Niet alle browsers vullen het window.performance voordat het einde van de XHR-aanvraag wordt gerapporteerd. Voor het ophalen van aanvragen wordt deze toegevoegd nadat deze is voltooid.
numeriek 3
maxBatchInterval

Hoe lang moet ik telemetrie batchgewijs uitvoeren voordat ze worden verzonden (milliseconden)
numeriek 15000
maxBatchSizeInBytes

Maximale grootte van telemetriebatch. Als een batch deze limiet overschrijdt, wordt deze onmiddellijk verzonden en wordt er een nieuwe batch gestart
numeriek 10000
namePrefix

Een optionele waarde die wordt gebruikt als naampostsel voor localStorage en sessiecookienaam.
tekenreeks Ongedefinieerde
onunloadDisableBeacon

Standaard false. wanneer het tabblad is gesloten, verzendt de SDK alle resterende telemetrie met behulp van de Beacon-API
boolean false
onunloadDisableFetch

Als ophalen keepalive wordt ondersteund, wordt deze niet gebruikt voor het verzenden van gebeurtenissen tijdens het uitladen, kan het nog steeds terugvallen om op te halen() zonder keepalive
boolean false
OverridePageViewDuration

Indien waar, wordt het standaardgedrag van trackPageView gewijzigd in het recordtijdsinterval voor het einde van de paginaweergave wanneer trackPageView wordt aangeroepen. Als er onwaar is en er geen aangepaste duur wordt opgegeven omPageView bij te houden, worden de prestaties van de paginaweergave berekend met behulp van de API voor navigatietijdsinstellingen. Standaard ingesteld op onwaar.
boolean false
perfEvtsSendAll

Wanneer enablePerfMgr is ingeschakeld en de IPerfManager een INotificationManager.perfEvent() activeert, bepaalt deze vlag of een gebeurtenis wordt geactiveerd (en naar alle listeners wordt verzonden) voor alle gebeurtenissen (waar) of alleen voor 'bovenliggende' gebeurtenissen (standaard onwaar<>).
Een bovenliggende IPerfEvent is een gebeurtenis waarbij geen andere IPerfEvent nog steeds wordt uitgevoerd op het moment dat de gebeurtenis wordt gemaakt en de bovenliggende eigenschap niet null of niet gedefinieerd is. Sinds v2.5.7
boolean false
samplingPercentage

Percentage gebeurtenissen dat wordt verzonden. De standaardwaarde is 100, wat betekent dat alle gebeurtenissen worden verzonden. Stel deze in als u uw gegevenslimiet wilt behouden voor grootschalige toepassingen.
numeriek 100
sdkExtension

Hiermee stelt u de naam van de SDK-extensie in. Alleen alfabetische tekens zijn toegestaan. De extensienaam wordt toegevoegd als voorvoegsel aan de tag ai.internal.sdkVersion (bijvoorbeeld 'ext_javascript:2.0.0'). De standaardwaarde is null.
tekenreeks Nul
sessionCookiePostfix

Een optionele waarde die wordt gebruikt als naampostsel voor de sessiecookynaam. Als dit niet is gedefinieerd, wordt namePrefix gebruikt als naampostvoegsel voor de sessiecookynaam.
tekenreeks Ongedefinieerde
sessionExpirationMs

Een sessie wordt geregistreerd als deze gedurende deze tijd in milliseconden is voortgezet. De standaardwaarde is 24 uur
numeriek 86400000
sessionRenewalMs

Een sessie wordt geregistreerd als de gebruiker gedurende deze tijd in milliseconden inactief is. De standaardwaarde is 30 minuten
numeriek 1800000
throttleMgrCfg

Stel de configuratie van de vertragingsbeheerset in op sleutel.

Dit configuratieveld is alleen beschikbaar in versie 3.0.3 en hoger.
{[key: number]: IThrottleMgrConfig} Ongedefinieerde
userCookiePostfix

Een optionele waarde die wordt gebruikt als naampostvoegsel voor de gebruikersnaam. Als dit niet is gedefinieerd, wordt er geen postfix toegevoegd aan de cookienaam van de gebruiker.
tekenreeks Ongedefinieerde

Vanaf versie 2.6.0 biedt de Azure-toepassing Insights JavaScript SDK op basis van cookies die na de initialisatie kunnen worden uitgeschakeld en opnieuw kunnen worden ingeschakeld.

Als u cookies tijdens de initialisatie hebt uitgeschakeld met behulp van de disableCookiesUsage of cookieCfg.enabled configuraties, kunt u ze opnieuw inschakelen met behulp van de setEnabled functie van het ICookieMgr-object.

Het cookiebeheer op basis van een exemplaar vervangt de vorige algemene functies van CoreUtils van disableCookies(), setCookie()en deleteCookie()getCookie().

Als u wilt profiteren van de verbeteringen die zijn geïntroduceerd in versie 2.6.0, is het raadzaam om de globale functies niet meer te gebruiken.

ICookieMgrConfig is een cookieconfiguratie voor op exemplaren gebaseerd cookiebeheer dat is toegevoegd in 2.6.0. Met de beschikbare opties kunt u het gebruik van cookies door de SDK in- of uitschakelen. U kunt ook aangepaste cookiedomeinen en paden instellen en de functies aanpassen voor het ophalen, instellen en verwijderen van cookies.

De ICookieMgrConfig-opties worden gedefinieerd in de volgende tabel.

Name Type Standaard Beschrijving
enabled boolean true Het huidige exemplaar van de SDK gebruikt deze Booleaanse waarde om aan te geven of het gebruik van cookies is ingeschakeld. Als dit onwaar is, slaat het exemplaar van de SDK die door deze configuratie is geïnitialiseerd, geen gegevens van cookies op of leest deze niet.
domain tekenreeks Nul Aangepast cookiedomein. Het is handig als u Application Insights-cookies wilt delen tussen subdomeinen. Als dit niet wordt opgegeven, wordt de waarde uit de hoofdwaarde cookieDomain gebruikt.
path tekenreeks / Hiermee geeft u het pad op dat moet worden gebruikt voor de cookie, indien niet op voorwaarde dat er een waarde uit de hoofdwaarde cookiePath wordt gebruikt.
ignoreCookies tekenreeks[] Ongedefinieerde Geef de cookienaam(en) op die moeten worden genegeerd, waardoor een overeenkomende cookienaam nooit wordt gelezen of geschreven. Ze kunnen nog steeds expliciet worden verwijderd of verwijderd. U hoeft de naam in de blockedCookies configuratie niet te herhalen. (sinds v2.8.8)
blockedCookies tekenreeks[] Ongedefinieerde Geef de cookienaam(en) op die nooit moeten worden geschreven. Het voorkomt dat er cookienaam wordt gemaakt of bijgewerkt, maar ze kunnen nog steeds worden gelezen, tenzij ze ook in de ignoreCookies zijn opgenomen. Ze kunnen nog steeds worden verwijderd of expliciet worden verwijderd. Indien niet opgegeven, wordt standaard dezelfde lijst in ignoreCookies gebruikt. (Sinds v2.8.8)
getCookie (name: string) => string Nul Functie om de benoemde cookiewaarde op te halen, indien niet opgegeven, wordt de interne cookieparsering/caching gebruikt.
setCookie (name: string, value: string) => void Nul Functie voor het instellen van de benoemde cookie met de opgegeven waarde, alleen aangeroepen bij het toevoegen of bijwerken van een cookie.
delCookie (name: string, value: string) => void Nul Functie voor het verwijderen van de benoemde cookie met de opgegeven waarde, gescheiden van setCookie om te voorkomen dat de waarde moet worden geparseerd om te bepalen of de cookie wordt toegevoegd of verwijderd. Als dit niet is opgegeven, wordt gebruikgemaakt van het interne parseren/opslaan van cookies.

Bronkaart

Ondersteuning voor brontoewijzing helpt u bij het opsporen van fouten in minified JavaScript-code met de mogelijkheid om de minified callstack van uw uitzonderingstelemetrie te vergroten.

  • Compatibel met alle huidige integraties in het deelvenster Uitzonderingsdetails
  • Ondersteunt alle huidige en toekomstige JavaScript SDK's, waaronder Node.JS, zonder dat er een SDK-upgrade nodig is

Application Insights ondersteunt het uploaden van brontoewijzingen naar de blobcontainer van uw Azure Storage-account. U kunt brontoewijzingen gebruiken om aanroepstacks op de pagina met end-to-end transactiegegevens te vergroten. U kunt brontoewijzingen ook gebruiken om elke uitzondering die is verzonden door de JavaScript SDK of de Node.js SDK te vergroten.

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

Een nieuw opslagaccount en blobcontainer maken

Als u al een bestaand opslagaccount of blobcontainer hebt, kunt u deze stap overslaan.

  1. Maak een nieuw opslagaccount.

  2. Maak een blobcontainer in uw opslagaccount. Stel openbaar toegangsniveau in op Privé om ervoor te zorgen dat uw bronkaarten niet openbaar toegankelijk zijn.

    Screenshot that shows setting the container access level to Private.

Uw brontoewijzingen pushen naar uw blobcontainer

Integreer uw pijplijn voor continue implementatie met uw opslagaccount door deze te configureren om uw brontoewijzingen automatisch te uploaden naar de geconfigureerde blobcontainer.

U kunt brontoewijzingen uploaden naar uw Azure Blob Storage-container met dezelfde mapstructuur waarmee ze zijn gecompileerd en geïmplementeerd. Een veelvoorkomend gebruiksvoorbeeld is het voorvoegsel van een implementatiemap met de bijbehorende versie, 1.2.3/static/js/main.jsbijvoorbeeld. Wanneer u de naam van een Azure-blobcontainer sourcemapsopheffen, probeert de pijplijn een brontoewijzing op te halen die zich bevindt in sourcemaps/1.2.3/static/js/main.js.map.

Als u Azure Pipelines gebruikt om uw toepassing continu te bouwen en te implementeren, voegt u een Azure-bestandskopietaak toe aan uw pijplijn om uw brontoewijzingen automatisch te uploaden.

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

Uw Application Insights-resource configureren met een opslagaccount voor brontoewijzingen

U hebt twee opties voor het configureren van uw Application Insights-resource met een opslagaccount voor brontoewijzingen.

Tabblad Details van end-to-end transactie

Selecteer Op het tabblad Details van end-to-end transactie de optie Unminify. Configureer uw resource als deze niet is geconfigureerd.

  1. Bekijk in Azure Portal de details van een uitzondering die wordt geminimificeerd.
  2. Selecteer Opheffen.
  3. Als uw resource niet is geconfigureerd, configureert u deze.
Tabblad Eigenschappen

Ga als volgt te werk om het opslagaccount of de blobcontainer te configureren of te wijzigen die is gekoppeld aan uw Application Insights-resource:

  1. Ga naar het tabblad Eigenschappen van uw Application Insights-resource.

  2. Selecteer Blobcontainer voor brontoewijzing wijzigen.

  3. Selecteer een andere blobcontainer als de brontoewijzingscontainer.

  4. Selecteer Toepassen.

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

De niet-gecontroleerde callstack weergeven

Als u de niet-geverifieerde aanroepstack wilt weergeven, selecteert u een uitzonderingstelemetrie-item in Azure Portal, zoekt u de brontoewijzingen die overeenkomen met de aanroepstack en sleept u de brontoewijzingen naar de aanroepstack in Azure Portal. De bronkaart moet dezelfde naam hebben als het bronbestand van een stackframe, maar met een map extensie.

Als u problemen ondervindt met ondersteuning voor brontoewijzingen voor JavaScript-toepassingen, raadpleegt u Ondersteuning voor brontoewijzingen oplossen voor JavaScript-toepassingen.

Animation demonstrating unminify feature.

Boom schudden

Het schudden van structuur elimineert ongebruikte code uit de uiteindelijke JavaScript-bundel.

Als u wilt profiteren van boomschudden, importeert u alleen de benodigde onderdelen van de SDK in uw code. Door dit te doen, wordt ongebruikte code niet opgenomen in de uiteindelijke bundel, waardoor de grootte wordt verkleind en de prestaties worden verbeterd.

Verbeteringen en aanbevelingen voor boomschudden

In versie 2.6.0 hebben we het interne gebruik van deze statische helperklassen afgeschaft en verwijderd om de ondersteuning voor algoritmen voor het schudden van bomen te verbeteren. Hiermee kunnen npm-pakketten ongebruikte code veilig verwijderen.

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

De functies worden nu geëxporteerd als hoofdmappen op het hoogste niveau van de modules, waardoor u uw code gemakkelijker kunt herstructureren voor betere structuurschudding.

De statische klassen zijn gewijzigd in const-objecten die verwijzen naar de nieuwe geëxporteerde functies en toekomstige wijzigingen worden gepland om de verwijzingen verder te herstructureren.

Boomschudende afgeschafte functies en vervangingen

Deze sectie is alleen van toepassing op u als u de afgeschafte functies gebruikt en u de pakketgrootte wilt optimaliseren. U wordt aangeraden de vervangende functies te gebruiken om de grootte te verkleinen en alle versies van Internet Explorer te ondersteunen.

Bestaand Vervanging
Coreutils @microsoft/applicationinsights-core-js
CoreUtils._canUseCookies Geen. Gebruik niet omdat dit ervoor zorgt dat alle CoreUtils-verwijzingen worden opgenomen in uw uiteindelijke code.
Herstructureer uw cookieafhandeling om de appInsights.getCookieMgr().setEnabled(true/false) waarde in te stellen en appInsights.getCookieMgr().isEnabled() om de waarde te controleren.
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 is Booleaanse waarde
CoreUtils.toISOString toISOString of 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
Als u verwijst naar een van beide oorzaken, wordt naar CoreUtils verwezen voor compatibiliteit met eerdere versies.
Uw cookieafhandeling herstructureren om de 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.Loskoppelen loskoppelen Vanvent
EventHelper.DetachEvent loskoppelen Vanvent
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
Als u verwijst naar een van beide oorzaken, wordt naar CoreUtils verwezen voor compatibiliteit met eerdere versies.
Uw cookieafhandeling herstructureren om de appInsights.getCookieMgr().setEnabled(false)
Util.canUseCookies canUseCookies
Als u verwijst naar een van beide oorzaken, wordt naar CoreUtils verwezen voor compatibiliteit met eerdere versies.
Uw cookieafhandeling herstructureren om de appInsights.getCookieMgr().isEnabled()
Util.disallowsSameSiteNone uaDisallowsSameSiteNone
Util.setCookie coreSetCookie
Verwijzing zorgt ervoor dat Naar CoreUtils wordt verwezen voor compatibiliteit met eerdere versies.
Uw cookieafhandeling herstructureren om de appInsights.getCookieMgr().set(name: string, value: string)
Util.stringToBoolOrDefault stringToBoolOrDefault
Util.getCookie coreGetCookie
Verwijzing zorgt ervoor dat Naar CoreUtils wordt verwezen voor compatibiliteit met eerdere versies.
Uw cookieafhandeling herstructureren om de appInsights.getCookieMgr().get(name: string)
Util.deleteCookie coreDeleteCookie
Verwijzing zorgt ervoor dat Naar CoreUtils wordt verwezen voor compatibiliteit met eerdere versies.
Uw cookieafhandeling herstructureren om de appInsights.getCookieMgr().del(name: string, path?: string)
Util.trim strTrim
Util.newId newId
Util.random32 ---
Geen vervanging, herstructureer uw code om de kern random32(true) te gebruiken
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
Verbinding maken ionStringParser @microsoft/applicationinsights-common-js
Verbinding maken ionStringParser.parse parseren Verbinding maken ionString

Servicemeldingen

Servicemeldingen is een functie die is ingebouwd in de SDK om praktische aanbevelingen te bieden om ervoor te zorgen dat uw telemetriestromen ononderbroken naar Application Insights stromen. U ziet de meldingen als een uitzonderingsbericht in Application Insights. We zorgen ervoor dat meldingen relevant zijn voor u op basis van uw SDK-instellingen en we passen de uitgebreidheid aan op basis van de urgentie van de aanbeveling. We raden u aan servicemeldingen aan te laten, maar u kunt zich afmelden via de featureOptIn configuratie. Zie hieronder voor een lijst met actieve meldingen.

Momenteel worden er geen actieve meldingen verzonden.

Problemen oplossen

Zie het speciale artikel over probleemoplossing.

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Hoe kan ik mijn serverconfiguratie van derden bijwerken voor de JavaScript SDK?

De serverzijde moet verbindingen met deze headers kunnen accepteren. Afhankelijk van de configuratie aan de Access-Control-Allow-Headers serverzijde is het vaak nodig om de lijst aan de serverzijde uit te breiden door handmatig , Request-Contexten traceparent (W3C gedistribueerde header) toe te voegenRequest-Id.

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

Hoe kan ik gedistribueerde tracering uitschakelen voor de JavaScript SDK?

Gedistribueerde tracering kan worden uitgeschakeld in de configuratie.

Worden de HTTP 502- en 503-antwoorden altijd vastgelegd door Application Insights?

Nee De fouten '502 ongeldige gateway' en '503-service niet beschikbaar' worden niet altijd vastgelegd door Application Insights. Als alleen JavaScript aan de clientzijde wordt gebruikt voor bewaking, wordt dit gedrag verwacht omdat het foutbericht wordt geretourneerd vóór de pagina met de HTML-header met het bewakingsscriptfragment dat wordt weergegeven.

Als het 502- of 503-antwoord is verzonden vanaf een server waarop bewaking aan de serverzijde is ingeschakeld, worden de fouten verzameld door de Application Insights SDK.

Zelfs wanneer bewaking aan de serverzijde is ingeschakeld op de webserver van een toepassing, wordt er soms geen 502- of 503-fout vastgelegd door Application Insights. Veel moderne webservers staan niet toe dat een client rechtstreeks communiceert. In plaats daarvan maken ze gebruik van oplossingen zoals omgekeerde proxy's om informatie heen en weer door te geven tussen de client en de front-endwebservers.

In dit scenario kan een 502- of 503-antwoord worden geretourneerd naar een client vanwege een probleem op de reverse proxy-laag, zodat het niet wordt vastgelegd door Application Insights. Als u problemen op deze laag wilt detecteren, moet u mogelijk logboeken van uw omgekeerde proxy doorsturen naar Log Analytics en een aangepaste regel maken om te controleren op 502- of 503-antwoorden. Voor meer informatie over veelvoorkomende oorzaken van 502- en 503-fouten raadpleegt u HTTP-fouten van '502 ongeldige gateway' en '503-service niet beschikbaar' in Azure-app Service oplossen.

Volgende stappen