Share via

Microsoft Azure Monitor-alkalmazás Elemzések JavaScript SDK-konfiguráció

  • Cikk

A Azure-alkalmazás Elemzések JavaScript SDK konfigurációt biztosít a webalkalmazások nyomon követéséhez, monitorozásához és hibakereséséhez.

SDK konfigurálása

Ezek a konfigurációs mezők nem kötelezőek, és alapértelmezés szerint hamisak, hacsak másként nem rendelkeznek.

Az SDK-konfiguráció hozzáadására vonatkozó utasításokért lásd: SDK-konfiguráció hozzáadása.

Name Type Alapértelmezett
accountId

Nem kötelező fiókazonosító, ha az alkalmazás a felhasználókat fiókokba csoportosítja. Nincsenek szóközök, vesszők, pontosvesszők, egyenlőségek vagy függőleges sávok		 sztring null
addRequestContext

Adjon módot a függőségi naplók környezettel való bővítésére az API-hívás elején. Az alapértelmezett érték nincs definiálva. Ellenőriznie kell, hogy létezik-e xhr , ha a kapcsolódó környezetet konfigurálja xhr . Ellenőriznie kell, hogy konfigurálja-e fetch requestfetch a kapcsolódó környezetet, és fetch response létezik-e. Ellenkező esetben előfordulhat, hogy nem kapja meg a szükséges adatokat.		 (requestContext: IRequestionContext) => {[key: string]: any} Meghatározatlan
ajaxPerfLookupDelay

Alapértelmezés szerint 25 ms. Az Ajax-kérések windows.performance időzítéseinek megkereséséhez szükséges várakozási idő ezredmásodpercben van, és közvetlenül a setTimeout() értéknek lesz átadva.		 Numerikus 25
appId

Az AppId az ügyféloldali AJAX-függőségek és a kiszolgálóoldali kérések közötti korrelációhoz használatos. Ha a Beacon API engedélyezve van, az nem használható automatikusan, de manuálisan is beállítható a konfigurációban. Az alapértelmezett érték null		 sztring null
autoTrackPageVisitTime

Ha igaz, egy oldalmegtekintésen a rendszer nyomon követi és telemetriaként küldi el az előző rendszerállapotú lap nézetidejét, és elindít egy új időzítőt az aktuális oldalmegtekintéshez. A rendszer egyéni metrikaként PageVisitTimemilliseconds küldi el, amely a Date now() függvénnyel van kiszámítva (ha elérhető), és visszavált az (új Dátum()) értékre.getTime() ha most() nem érhető el (IE8 vagy kisebb). Az alapértelmezett érték a false (hamis).		 Logikai false
convertUndefined

Adjon meg egy lehetőséget a felhasználónak, hogy a nem definiált mezőt felhasználó által megadott értékké konvertálja.		 any Meghatározatlan
cookieCfg

A cookie-használat alapértelmezett beállításaiért tekintse meg az ICookieCfgConfig teljes alapértelmezett beállításait.		 ICookieCfgConfig
[Nem kötelező]
(2.6.0 óta)		 Meghatározatlan
cookieDomain

Egyéni cookie-tartomány. Hasznos, ha meg szeretné osztani az alkalmazás Elemzések cookie-kat az altartományokban.
(2.6.0-s verzió óta) Ha cookieCfg.domain definiálva van, az elsőbbséget élvez ezzel az értékkel szemben.		 alias a következőhöz: cookieCfg.domain
[Nem kötelező]		 null
cookiePath

Egyéni cookie elérési útja. Hasznos, ha meg szeretné osztani az Application Elemzések cookie-kat egy Application Gateway mögött.
Ha cookieCfg.path meg van adva, elsőbbséget élvez.		 alias a következőhöz: cookieCfg.path
[Nem kötelező]
(2.6.0 óta)		 null
correlationHeaderDomains

Korrelációs fejlécek engedélyezése adott tartományokhoz		 sztring[] Meghatározatlan
correlationHeaderExcludedDomains

Adott tartományok korrelációs fejléceinek letiltása		 sztring[] Meghatározatlan
correlationHeaderExcludePatterns

Korrelációs fejlécek letiltása reguláris kifejezések használatával		 regex[] Meghatározatlan
createPerfMgr

A visszahívási függvény, amely szükség esetén IPerfManager-példány létrehozásához lesz meghívva, és enablePerfMgr engedélyezve van, lehetővé teszi a PerfManager() alapértelmezett létrehozásának felülbírálását anélkül, hogy az inicializálás után kellene.setPerfMgr()		 (core: IApp Elemzések Core, notificationManager: INotificationManager) => IPerfManager Meghatározatlan
customHeaders

A felhasználó lehetősége további fejlécek megadására egyéni végpontok használatakor. A customHeaders nem lesz hozzáadva a böngésző leállítási pillanatában a jeladók használatakor. Az egyéni fejlécek hozzáadása az IE9-ben és a korábbi verziókban nem támogatott.		 [{header: string, value: string}] Meghatározatlan
diagnosticLogInterval

(belső) Lekérdezési időköz (ms-ben) a belső naplózási üzenetsorhoz		 Numerikus 10000
disableAjaxTracking

Ha igaz, az Ajax-hívások nem jelennek meg automatikusan. Az alapértelmezett érték a false (hamis).		 Logikai false
disableCookiesUsage

Alapértelmezett hamis. Logikai érték, amely azt jelzi, hogy az SDK letiltja-e a cookie-k használatát. Ha igaz, az SDK nem tárol és nem olvas be adatokat a cookie-kból.
(2.6.0-s verzió óta) Ha cookieCfg.enabled meg van adva, elsőbbséget élvez. A cookie-használat a core.getCookieMgr().setEnabled(true) inicializálás után újra engedélyezhető.		 alias a következőhöz: cookieCfg.enabled
[Nem kötelező]		 false
disableCorrelationHeaders

Ha hamis, az SDK két fejlécet ('Request-Id' és 'Request-Context' ) ad hozzá az összes függőségi kéréshez, hogy korrelálja őket a kiszolgálóoldal megfelelő kéréseivel. Az alapértelmezett érték a false (hamis).		 Logikai false
disableDataLossAnalysis

Ha hamis, a rendszer indításkor ellenőrzi a belső telemetriai feladó puffereit a még nem elküldött elemeknél.		 Logikai true
disableExceptionTracking

Ha igaz, a kivételek nem lesznek automatikusan felvéve. Az alapértelmezett érték a false (hamis).		 Logikai false
disableFetchTracking

Az alapértelmezett beállítás disableFetchTracking az false, ami azt jelenti, hogy engedélyezve van. A 2.8.10 előtti verziókban azonban alapértelmezés szerint le lett tiltva. Ha be van állítva, truea rendszer nem gyűjti automatikusan a beolvasási kérelmeket. Az alapértelmezett beállítás a 2.8.0-s verzióra truefalse változott.		 Logikai false
disableFlushOnBeforeUnload

Alapértelmezett hamis. Ha igaz, a rendszer nem hívja meg a kiürítési metódust az onBeforeUnload eseményindítók esetén		 Logikai false
disableIkeyDeprecationMessage

A rendszerállapot-kulcs elavulását jelző hibaüzenet letiltása. Ha igaz, a hibaüzenetek NEM lesznek elküldve.		 Logikai true
disableInstrumentationKeyValidation

Ha igaz, a rendszerállapotkulcs-ellenőrzés megkerülve lesz. Az alapértelmezett érték hamis.		 Logikai false
disableTelemetry

Ha igaz, a telemetria nem gyűjthető és nem küldhető el. Az alapértelmezett érték a false (hamis).		 Logikai false
disableXhr

Az XMLHttpRequest vagy az XDomainRequest (IE < 9 esetén) alapértelmezés szerint ne használja a fetch() vagy a sendBeacon parancsot. Ha más átvitel nem érhető el, az XMLHttpRequestet használja		 Logikai false
distributedTracingMode

Beállítja az elosztott nyomkövetési módot. Ha AI_AND_W3C mód vagy W3C mód be van állítva, a W3C nyomkövetési környezet fejlécei (traceparent/tracestate) jönnek létre, és az összes kimenő kérés tartalmazza. AI_AND_W3C az örökölt alkalmazásokkal Elemzések eszközalapú szolgáltatásokkal való kompatibilitást biztosítjuk.		 numerikus vagy DistributedTracingModes DistributedTracing Modes.AI_AND_W3C
enableAjaxErrorStatusText

Alapértelmezett hamis. Ha igaz, adja meg a válaszhiba adatszövegének logikai logikai adatait a meghiúsult AJAX-kérelmek függőségi eseményében.		 Logikai false
enableAjaxPerfTracking

Alapértelmezett hamis. Jelző a jelentett Ajax (XHR és beolvasás) jelentett metrikákban való kereséshez és az extra böngészőablak.teljesítmény időzítésének engedélyezéséhez.		 Logikai false
enableAutoRouteTracking

Útvonalváltozások automatikus nyomon követése egyoldalas alkalmazásokban (SPA). Ha igaz, minden útvonalmódosítás új Oldalnézetet küld az Alkalmazás Elemzések. A kivonat útvonalváltozásai (example.com/foo#bar) új oldalmegtekintésekként is rögzítve lesznek.
Megjegyzés: Ha engedélyezi ezt a mezőt, ne engedélyezze az objektumot a history React útválasztó konfigurációjához, mert több oldalnézeti eseményt fog kapni.		 Logikai false
enableCorsCorrelation

Ha igaz, az SDK két fejlécet ("Request-Id" és "Request-Context") ad hozzá az összes CORS-kéréshez, hogy korrelálja a kimenő AJAX-függőségeket a kiszolgálóoldal megfelelő kéréseivel. Az alapértelmezett érték hamis		 Logikai false
enableDebug

Ha igaz, a belső hibakeresési adatok kivételként kerülnek naplózás helyett , függetlenül az SDK naplózási beállításaitól. Az alapértelmezett érték a false (hamis).
Megjegyzés: Ha engedélyezi ezt a beállítást, az eldobott telemetriát eredményez, amikor belső hiba történik. Hasznos lehet az SDK konfigurálásával vagy használatával kapcsolatos problémák gyors azonosításához. Ha a hibakeresés során nem szeretné elveszíteni a telemetriát, fontolja meg a használatát loggingLevelConsole vagy loggingLevelTelemetry helyett.enableDebug		 Logikai false
enablePerfMgr

Ha engedélyezve van (igaz), helyi perfEventseket hoz létre a perfEvents (doPerf() segítőn keresztül) történő kibocsátására szolgáló kódhoz. Használható az SDK-n belüli teljesítményproblémák azonosítására a használat alapján, vagy opcionálisan a saját eszközkódján belül.		 Logikai false
enableRequestHeaderTracking

Ha igaz, az AJAX > A kérelemfejlécek beolvasása nyomon követhető, az alapértelmezett érték hamis. Ha az ignoreHeaders nincs konfigurálva, a rendszer nem naplózza az engedélyezési és az X-API-kulcsfejléceket.		 Logikai false
enableResponseHeaderTracking

Ha igaz, az AJAX > a kérés válaszfejléceit követi, az alapértelmezett érték hamis. Ha az ignoreHeaders nincs konfigurálva, a www-authenticate fejléc nincs naplózva.		 Logikai false
enableSessionStorageBuffer

Alapértelmezett igaz. Ha igaz, a rendszer az összes nem küldött telemetriát tartalmazó puffert munkamenet-tárolóban tárolja. A puffer visszaállítása lapbetöltés esetén		 Logikai true
enableUnhandledPromiseRejectionTracking

Ha igaz, a nem kezelt ígéretek elutasítása automatikusan JavaScript-hibaként jelenik meg. Ha a disableExceptionTracking igaz (ne kövesse nyomon a kivételeket), a konfigurációs érték figyelmen kívül lesz hagyva, és a nem kezelt ígéretek elutasítása nem lesz jelentett.		 Logikai false
eventsLimitInMem

Azon események száma, amelyek a memóriában tárolhatók, mielőtt az SDK elkezdi elvetni az eseményeket, ha nem használja a Session Storage-t (az alapértelmezettet).		 number 10000
excludeRequestFromAutoTrackingPatterns

Adjon meg egy módot arra, hogy kizárjon egy adott útvonalat az XMLHttpRequest vagy a Fetch kérés automatikus nyomon követéséből. Ha meg van adva, egy Ajax/fetch kérés esetén, amely szerint a kérelem URL-címe megegyezik a regex mintákkal, az automatikus nyomon követés ki van kapcsolva. Az alapértelmezett érték nincs definiálva.		 sztring[] | RegExp[] Meghatározatlan
featureOptIn

Adja meg a funkció opt in details(funkció) beállítását.

Ez a konfigurációs mező csak a 3.0.3-s és újabb verziókban érhető el.		 IFeatureOptIn Meghatározatlan
idLength

Azonosítja az új véletlenszerű munkamenetek és felhasználói azonosítók létrehozásához használt alapértelmezett hosszt. Az alapértelmezett érték 22, az előző alapértelmezett érték 5 (v2.5.8 vagy annál kisebb), ha meg kell tartania az előző maximális hosszt, akkor az értéket 5 értékre kell állítania.		 Numerikus 22
ignoreHeaders

AJAX > A naplóadatokban figyelmen kívül hagyandó kérés- és válaszfejlécek lekérése. Az alapértelmezett érték felülbírálásához vagy elvetéséhez adjon hozzá egy tömböt, amely az összes kizárandó fejlécet tartalmazza, vagy egy üres tömböt a konfigurációhoz.		 sztring[] ["Authorization", "X-API-Key", "WWW-Authenticate"]
isBeaconApiDisabled

Ha hamis, az SDK az összes telemetriát a Beacon API használatával küldi el		 Logikai true
isBrowserLinkTrackingEnabled

Az alapértelmezett érték a false (hamis). Ha igaz, az SDK nyomon követi az összes Böngészőhivatkozás-kérést .		 Logikai false
isRetryDisabled

Alapértelmezett hamis. Ha hamis, próbálkozzon újra a 206-os (részleges sikeresség), a 408-at (időtúllépés), a 429-et (túl sok kérés), az 500-at (belső kiszolgálóhiba), az 503-at (a szolgáltatás nem érhető el) és a 0-t (offline állapotban, csak ha észleli)		 Logikai false
isStorageUseDisabled

Ha igaz, az SDK nem tárol vagy olvas be adatokat a helyi és a munkamenet-tárolóból. Az alapértelmezett érték a false (hamis).		 Logikai false
loggingLevelConsole

Naplózza a belső alkalmazás Elemzések hibákat a konzolon.
0: kikapcsolva,
1: Csak kritikus hibák,
2: Minden (hibák és figyelmeztetések)		 Numerikus 0
loggingLevelTelemetry

Telemetriaként belső alkalmazáshibákat Elemzések küld.
0: kikapcsolva,
1: Csak kritikus hibák,
2: Minden (hibák és figyelmeztetések)		 Numerikus 1
maxAjaxCallsPerView

Alapértelmezett 500 – azt szabályozza, hogy oldalnézetenként hány Ajax-hívást figyel a rendszer. Állítsa a -1 értékre az összes (korlátlan) Ajax-hívás figyeléséhez az oldalon.		 Numerikus 500
maxAjaxPerfLookupAttempts

Alapértelmezett érték: 3. A window.performance időzítéseinek (ha elérhető) maximális száma szükséges. Nem minden böngésző tölti ki a window.performance fájlt az XHR-kérelem végének jelentése előtt. A lekéréses kérelmek esetében a rendszer a befejezés után hozzáadja.		 Numerikus 3
maxBatchInterval

Mennyi ideig kell telemetriát kötenie a küldés előtt (ezredmásodperc)		 Numerikus 15 000
maxBatchSizeInBytes

A telemetriai köteg maximális mérete. Ha egy köteg túllépi ezt a korlátot, a rendszer azonnal elküldi, és elindít egy új köteget		 Numerikus 10000
namePrefix

Nem kötelező érték, amelyet a localStorage és a munkamenet cookie-jának neve név-utótagként használnak.		 sztring Meghatározatlan
onunloadDisableBeacon

Alapértelmezett hamis. a tabulátor bezárásakor az SDK az összes fennmaradó telemetriát elküldi a Beacon API használatával		 Logikai false
onunloadDisableFetch

Ha a beolvasási megőrzés támogatott, ne használja eseményküldésre a kipakolás során, előfordulhat, hogy a rendszer továbbra is visszaáll a beolvasásra() a megőrzés nélkül		 Logikai false
overridePageViewDuration

Ha igaz, a trackPageView alapértelmezett viselkedése a trackPageView meghívásakor az oldalnézet időtartamának rekordvégzésére változik. Ha hamis és nincs egyéni időtartam a trackPageView szolgáltatáshoz, a rendszer a navigációs időzítési API-val számítja ki a lapnézet teljesítményét. Az alapértelmezett érték a false (hamis).		 Logikai false
perfEvtsSendAll

Ha az enablePerfMgr engedélyezve van, és az IPerfManager aktivál egy INotificationManager.perfEvent() elemet, ez a jelölő határozza meg, hogy egy esemény aktiválva van-e (és az összes figyelőnek elküldve) az összes eseményre (igaz), vagy csak a "szülő" eseményekre (hamis alapértelmezett).><
A szülő IPerfEvent olyan esemény, amelyben az esemény létrehozásakor még nem fut más IPerfEvent, és a szülőtulajdonsága nem null értékű vagy nem definiált. A 2.5.7-as verzió óta		 Logikai false
samplingPercentage

Az elküldött események százalékos aránya. Az alapértelmezett érték 100, ami azt jelenti, hogy a rendszer minden eseményt elküld. Állítsa be, ha meg szeretné őrizni az adatkorlátot a nagy méretű alkalmazásokhoz.		 Numerikus 100
sdkExtension

Beállítja az SDK-bővítmény nevét. Csak betűrendes karakterek engedélyezettek. A bővítmény neve előtagként lesz hozzáadva az "ai.internal.sdkVersion" címkéhez (például :ext_javascript:2.0.0"). Az alapértelmezett érték null.		 sztring null
sessionCookiePostfix

Nem kötelező érték, amelyet a munkamenet cookie-jának nevének utótagjaként használnak. Ha nincs definiálva, a rendszer a namePrefix nevet használja a munkamenet cookie-jának nevének utótagjaként.		 sztring Meghatározatlan
sessionExpirationMs

A rendszer naplózza a munkamenetet, ha ennyi ideig, ezredmásodpercben folytatja. Az alapértelmezett érték 24 óra		 Numerikus 86400000
sessionRenewalMs

A rendszer akkor naplóz egy munkamenetet, ha a felhasználó ennyi ideig inaktív ezredmásodpercben. Az alapértelmezett érték 30 perc		 Numerikus 1800000
throttleMgrCfg

Állítsa be az mgr-konfigurációt kulcs szerint.

Ez a konfigurációs mező csak a 3.0.3-s és újabb verziókban érhető el.		 {[key: number]: IThrottleMgrConfig} Meghatározatlan
userCookiePostfix

Nem kötelező érték, amelyet a felhasználónév utótagjaként használnak a felhasználói cookie-névhez. Ha nincs definiálva, a rendszer nem ad hozzá utótagot a felhasználói cookie-névhez.		 sztring Meghatározatlan

A 2.6.0-s verziótól kezdve a Azure-alkalmazás Elemzések JavaScript SDK olyan példányalapú cookie-kezelést biztosít, amely az inicializálás után letiltható és újra engedélyezhető.

Ha letiltotta a cookie-kat az inicializálás során az disableCookiesUsagecookieCfg.enabled ICookieMgr objektum használatával, újra engedélyezheti őketsetEnabled.

A példányalapú cookie-kezelés a korábbi CoreUtils globális függvényeket disableCookies()váltja fel , getCookie()setCookie()és deleteCookie().

A 2.6.0-s verzióban bevezetett faremegés-fejlesztések előnyeinek kihasználásához javasoljuk, hogy a továbbiakban ne használja a globális függvényeket.

Az ICookieMgrConfig a 2.6.0-ban hozzáadott példányalapú cookie-kezelés cookie-konfigurációja. A megadott lehetőségek lehetővé teszik a cookie-k SDK általi engedélyezését vagy letiltását. Egyéni cookie-tartományokat és elérési utakat is beállíthat, és testre szabhatja a cookie-k beolvasására, beállítására és törlésére szolgáló függvényeket.

Az ICookieMgrConfig beállításai az alábbi táblázatban vannak definiálva.

Name Type Alapértelmezett Leírás
engedélyezve Logikai true Az SDK jelenlegi példánya ezt a logikai értéket használja annak jelzésére, hogy engedélyezve van-e a cookie-k használata. Ha hamis, a konfiguráció által inicializált SDK-példány nem tárol és nem olvas be adatokat a cookie-kból.
domain sztring null Egyéni cookie-tartomány. Hasznos, ha meg szeretné osztani az alkalmazás Elemzések cookie-kat az altartományokban. Ha nincs megadva, a gyökérérték cookieDomain értékét használja.
ösvény sztring / Megadja a cookie-hoz használandó elérési utat, ha nincs megadva, a gyökérértékből cookiePath származó bármilyen értéket használ.
ignoreCookies sztring[] Meghatározatlan Adja meg a figyelmen kívül hagyandó cookie-nev(ek)et, és ez azt eredményezi, hogy az egyező cookie-név soha nem lesz olvasható vagy írható. Előfordulhat, hogy még mindig explicit módon törölve vagy törölve lesznek. A konfigurációban nem kell megismételnie a blockedCookies nevet. (a 2.8.8-as verzió óta)
blockedCookies sztring[] Meghatározatlan Adja meg a soha nem írható cookie(k) nevét. Megakadályozza a cookie-név létrehozását vagy frissítését, de továbbra is olvashatók, hacsak az ignoreCookies nem tartalmazza őket. Előfordulhat, hogy a törlésük vagy a törlésük explicit módon is lehetséges. Ha nincs megadva, az alapértelmezés szerint ugyanarra a listára vonatkozik az ignoreCookiesben. (2.8.8-as verzió óta)
getCookie (name: string) => string null Függvény a megnevezett cookie-érték lekéréséhez, ha nem, akkor a belső cookie-elemzést /gyorsítótárazást használja.
setCookie (name: string, value: string) => void null A megadott értékkel rendelkező elnevezett cookie beállításának függvénye csak a cookie hozzáadásakor vagy frissítésekor hívható meg.
delCookie (name: string, value: string) => void null A megadott értékkel rendelkező elnevezett cookie törlésének függvénye a setCookie-tól elválasztva, hogy ne kelljen elemezni az értéket annak megállapításához, hogy a cookie hozzáadása vagy eltávolítása folyamatban van-e. Ha nincs megadva, a belső cookie-elemzést /gyorsítótárazást használja.

Forrástérkép

A forrástérkép támogatása segít a hibakeresésben a minimálisan módosított JavaScript-kóddal, és így megszüntetheti a kivételtelemetria minified callstack parancsait.

  • Kompatibilis az összes jelenlegi integrációval a Kivétel részletei panelen
  • Támogatja az összes jelenlegi és jövőbeli JavaScript SDK-t, beleértve a Node.JS-t is, anélkül, hogy SDK-frissítést kellene igényelnie

Az alkalmazás Elemzések támogatja a forrástérképek Azure Storage-fiók blobtárolóba való feltöltését. A forrástérképekkel megszüntetheti a végpontok közötti tranzakció részletei lapon található hívásveremeket. A forrásleképekkel a JavaScript SDK vagy a Node.js SDK által küldött kivételeket is megszüntetheti.

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

Új tárfiók és blobtároló létrehozása

Ha már van tárfiókja vagy blobtárolója, kihagyhatja ezt a lépést.

  1. Hozzon létre egy új tárfiókot.

  2. Hozzon létre egy blobtárolót a tárfiókban. Állítsa a nyilvános hozzáférési szintet privátra, hogy a forrástérképek ne legyenek nyilvánosan elérhetők.

    Screenshot that shows setting the container access level to Private.

Forrástérképek leküldése a blobtárolóba

A folyamatos üzembehelyezési folyamatot a tárfiókkal integrálhatja úgy, hogy automatikusan feltölti a forrástérképeket a konfigurált blobtárolóba.

A forrástérképeket feltöltheti az Azure Blob Storage-tárolóba ugyanazzal a mappastruktúrával, amellyel lefordították és üzembe helyezték őket. Gyakori használati eset például egy üzembehelyezési mappa előtagja annak verziójával 1.2.3/static/js/main.js. Ha egy azure-blobtárolón sourcemapskeresztül feloldja a műveletet, a folyamat megpróbál lekérni egy forrástérképet, amely a következő helyen sourcemaps/1.2.3/static/js/main.js.maptalálható: .

Ha az Azure Pipelines használatával folyamatosan fejleszti és telepíti az alkalmazást, adjon hozzá egy Azure-fájlmásolási feladatot a folyamathoz a forrástérképek automatikus feltöltéséhez.

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

Az alkalmazás Elemzések erőforrás konfigurálása forrástérkép tárfiókkal

Az alkalmazás Elemzések erőforrást kétféleképpen konfigurálhatja egy forrástérkép tárfiókkal.

A végpontok közötti tranzakció részleteinek lapja

A Végpontok közötti tranzakció részletei lapon válassza az Unminify (Véglegesítés) lehetőséget. Konfigurálja az erőforrást, ha nincs konfigurálva.

  1. Az Azure Portalon tekintse meg a minimálisra módosított kivétel részleteit.
  2. Válassza az Unminify (Egységesítés) lehetőséget.
  3. Ha az erőforrás nincs konfigurálva, konfigurálja.
Tulajdonságok lap

Az alkalmazáshoz Elemzések erőforráshoz társított tárfiók vagy blobtároló konfigurálása vagy módosítása:

  1. Nyissa meg az alkalmazás Elemzések erőforrás Tulajdonságok lapját.

  2. Válassza a Forrástérkép blobtároló módosítása lehetőséget.

  3. Válasszon egy másik blobtárolót forrástérkép-tárolóként.

  4. Select Apply.

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

A meghatározatlan híváshívás megtekintése

A nem azonosított hívások megtekintéséhez válasszon ki egy Kivétel telemetriai elemet az Azure Portalon, keresse meg a hívásveremnek megfelelő forrástérképeket, és húzza a forrástérképeket a hívásverembe az Azure Portalon. A forrástérképnek ugyanazzal a névvel kell rendelkeznie, mint egy veremkeret forrásfájljának, de kiterjesztéssel kell rendelkeznie map .

Ha a JavaScript-alkalmazások forrástérkép-támogatásával kapcsolatos problémákat tapasztal, olvassa el a JavaScript-alkalmazások forrástérkép-támogatásának hibaelhárításával foglalkozó témakört.

Animation demonstrating unminify feature.

Fa remegés

A fa rázkódás eltávolítja a nem használt kódot a végleges JavaScript-csomagból.

A faremegés előnyeinek kihasználásához importálja csak az SDK szükséges összetevőit a kódba. Ezzel a nem használt kód nem szerepel az utolsó csomagban, csökkentve annak méretét és a teljesítményt.

Faremegés fejlesztései és javaslatai

A 2.6.0-s verzióban elavulttá tettük és eltávolítottuk ezeknek a statikus segédosztályoknak a belső használatát, hogy növeljük a famegrázó algoritmusok támogatását. Lehetővé teszi, hogy az npm-csomagok biztonságosan eldobják a nem használt kódot.

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

A függvények most már a modulok legfelső szintű gyökereiként vannak exportálva, így egyszerűbbé válik a kód újrabontása a jobb faremegés érdekében.

A statikus osztályok az új exportált függvényekre hivatkozó const objektumokra lettek módosítva, és a jövőbeni módosítások a hivatkozások további újrabontása érdekében lesznek tervezve.

Fa remegés elavult funkciók és cserék

Ez a szakasz csak akkor vonatkozik Önre, ha elavult függvényeket használ, és optimalizálni szeretné a csomagméretet. Javasoljuk, hogy a helyettesítő függvények használatával csökkentse a méretet, és támogassa az Internet Explorer összes verzióját.

Meglévő Csere
CoreUtils @microsoft/applicationinsights-core-js
CoreUtils._canUseCookies Nincs. Ne használja, mert az összes CoreUtils-referenciát belefoglalja a végleges kódba.
A cookie-kezelés újrabontása az appInsights.getCookieMgr().setEnabled(true/false) érték beállításához és appInsights.getCookieMgr().isEnabled() az érték ellenőrzéséhez.
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 vagy 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
A hivatkozás vagy azt eredményezi, hogy a CoreUtils visszafelé kompatibilitásra hivatkozik.
A cookie-k kezelésének újrabontása a 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.isInternalApplication Elemzések Endpoint isInternalApplication Elemzések Endpoint
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
A hivatkozás vagy azt eredményezi, hogy a CoreUtils visszafelé kompatibilitásra hivatkozik.
A cookie-k kezelésének újrabontása a appInsights.getCookieMgr().setEnabled(false)
Util.canUseCookies canUseCookies
A hivatkozás vagy azt eredményezi, hogy a CoreUtils visszafelé kompatibilitásra hivatkozik.
A cookie-k kezelésének újrabontása a appInsights.getCookieMgr().isEnabled()
Util.disallowsSameSiteNone uaDisallowsSameSiteNone
Util.setCookie coreSetCookie
A hivatkozás miatt a CoreUtils visszafelé kompatibilitásra hivatkozik.
A cookie-k kezelésének újrabontása a appInsights.getCookieMgr().set(name: string, value: string)
Util.stringToBoolOrDefault stringToBoolOrDefault
Util.getCookie coreGetCookie
A hivatkozás miatt a CoreUtils visszafelé kompatibilitásra hivatkozik.
A cookie-k kezelésének újrabontása a appInsights.getCookieMgr().get(name: string)
Util.deleteCookie coreDeleteCookie
A hivatkozás miatt a CoreUtils visszafelé kompatibilitásra hivatkozik.
A cookie-k kezelésének újrabontása a appInsights.getCookieMgr().del(name: string, path?: string)
Util.trim strTrim
Util.newId newId
Util.random32 ---
Nincs csere, a kód újrabontása az alap véletlenszerű32(igaz) használatára
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
Csatlakozás ionStringParser @microsoft/applicationinsights-common-js
Csatlakozás ionStringParser.parse parse Csatlakozás ionString

Szolgáltatási értesítések

A szolgáltatásértesítések az SDK-ba beépített funkciók, amelyek végrehajtható javaslatokat nyújtanak annak érdekében, hogy a telemetriai folyamatok zavartalanul érkezhessenek az Alkalmazás Elemzések. Az értesítések kivételként jelennek meg az Alkalmazás Elemzések. Biztosítjuk, hogy az értesítések relevánsak legyenek Az SDK beállításai alapján, és a javaslat sürgőssége alapján módosítjuk a részletességet. Javasoljuk, hogy hagyja be a szolgáltatásértesítéseket, de a featureOptIn konfiguráción keresztül leiratkozhat. Az aktív értesítések listáját alább találja.

Jelenleg nem küld aktív értesítéseket.

Hibaelhárítás

Tekintse meg a dedikált hibaelhárítási cikket.

Gyakori kérdések

Ez a szakasz választ ad a gyakori kérdésekre.

Hogyan frissíthetem a külső kiszolgáló konfigurációját a JavaScript SDK-hoz?

A kiszolgálóoldalnak képesnek kell lennie a jelen lévő fejlécekkel való kapcsolatok elfogadására. A kiszolgálóoldali konfigurációtól függően Access-Control-Allow-Headers gyakran szükséges a kiszolgálóoldali lista kiterjesztése manuálisan, és (W3C elosztott fejléc) hozzáadásával Request-ContextRequest-Idtraceparent .

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

Hogyan tilthatom le az elosztott nyomkövetést a JavaScript SDK-hoz?

Az elosztott nyomkövetés konfigurációban letiltható.

A HTTP 502- és 503-válaszokat mindig az alkalmazás Elemzések rögzíti?

Nem. Az "502 rossz átjáró" és az "503 szolgáltatás nem érhető el" hibaüzeneteket nem mindig rögzíti az alkalmazás Elemzések. Ha csak ügyféloldali JavaScriptet használ a monitorozáshoz, ez a viselkedés azért várható, mert a hibaválasz a HTML-fejlécet tartalmazó oldal előtt jelenik meg, és megjelenik a figyelési JavaScript-kódrészlet.

Ha az 502- vagy az 503-at kiszolgálóoldali figyeléssel rendelkező kiszolgálóról küldték, a hibákat az alkalmazás Elemzések SDK gyűjti össze.

Még akkor is, ha a kiszolgálóoldali monitorozás engedélyezve van az alkalmazás webkiszolgálóján, néha az alkalmazás Elemzések nem rögzíti az 502-503-at. Számos modern webkiszolgáló nem teszi lehetővé az ügyfél számára a közvetlen kommunikációt. Ehelyett olyan megoldásokat alkalmaznak, mint a fordított proxyk, hogy az adatokat oda-vissza továbbítják az ügyfél és az előtérbeli webkiszolgálók között.

Ebben az esetben előfordulhat, hogy az 502-es vagy 503-es válasz egy ügyfélnek a fordított proxyrétegen jelentkező probléma miatt jelenik meg, így az alkalmazás nem rögzíti az Elemzések. A réteg problémáinak észleléséhez előfordulhat, hogy a fordított proxyból a Log Analyticsbe kell továbbítania a naplókat, és létre kell hoznia egy egyéni szabályt, amely 502 vagy 503 választ keres. Az 502-ben és 503-ban előforduló hibák gyakori okairól az "502 hibás átjáró" és az "503 szolgáltatás nem érhető el" HTTP-hibáinak hibaelhárítása Azure-alkalmazás szolgáltatásban című témakörben olvashat.

További lépések