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 | Standaardinstelling |
---|---|---|
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 standaard XMLHttpRequest of XDomainRequest (voor Internet Explorer < versie 9) niet 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 |
Cookiebeheer
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.
Cookieconfiguratie
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 | Default | 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, inclusief Node.JS, zonder dat er een SDK-upgrade nodig is
Koppeling naar Blob Storage-account
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.
Een nieuw opslagaccount en blobcontainer maken
Als u al een bestaand opslagaccount of blobcontainer hebt, kunt u deze stap overslaan.
Maak een blobcontainer in uw opslagaccount. Stel openbaar toegangsniveau in op Privé om ervoor te zorgen dat uw bronkaarten niet openbaar toegankelijk zijn.
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.js
bijvoorbeeld. Wanneer u de naam van een Azure-blobcontainer sourcemaps
opheffen, probeert de pijplijn een brontoewijzing op te halen die zich bevindt in sourcemaps/1.2.3/static/js/main.js.map
.
Bronkaarten uploaden via Azure Pipelines (aanbevolen)
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.
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.
- Bekijk in Azure Portal de details van een uitzondering die wordt geminimificeerd.
- Selecteer Opheffen.
- 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:
Ga naar het tabblad Eigenschappen van uw Application Insights-resource.
Selecteer Blobcontainer voor brontoewijzing wijzigen.
Selecteer een andere blobcontainer als de brontoewijzingscontainer.
Selecteer Toepassen.
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.
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 |
ConnectionStringParser | @microsoft/applicationinsights-common-js |
ConnectionStringParser.parse | parseConnectionString |
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.
Probleemoplossing
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-Context
en 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.