Microsoft Azure Monitor Application Insights JavaScript SDK-konfiguráció
A Azure-alkalmazás Insights 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.
Név | Típus | 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 |
húr | 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 request fetch 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 |
húr | 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 PageVisitTime milliseconds 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 Application Insights-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 az Application Insights-cookie-kat egy Application Gateway mögött szeretné megosztani. 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: IAppInsightsCore, 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, true a rendszer nem gyűjti automatikusan a beolvasási kérelmeket. Az alapértelmezett beállítás a 2.8.0-s verzióra true false 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 Alapértelmezés szerint ne használja az XMLHttpRequest vagy az XDomainRequest fájlt (az Internet Explorer < 9-es verziójához), hanem próbálja meg használni 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 minden korábbi Application Insights-eszközszolgáltatással való háttérkompatibilitás érhető el. |
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 Application Insightsnak. 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). |
szám | 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 Belső Application Insights-hibákat naplóz a konzolon. 0: kikapcsolva, 1: Csak kritikus hibák, 2: Minden (hibák és figyelmeztetések) |
Numerikus | 0 |
loggingLevelTelemetry Belső Application Insights-hibákat küld telemetriaként. 0: kikapcsolva, 1: Csak kritikus hibák, 2: Minden (hibák és figyelmeztetések) |
Numerikus | 0 |
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. |
húr | 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. |
húr | 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. |
húr | 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. |
húr | Meghatározatlan |
Cookie-k kezelése
A 2.6.0-s verziótól kezdve a Azure-alkalmazás Insights JavaScript SDK 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 disableCookiesUsage
cookieCfg.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.
Cookie-konfigurálás
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.
Név | Típus | 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 | húr | null | Egyéni cookie-tartomány. Hasznos, ha meg szeretné osztani az Application Insights-cookie-kat az altartományokban. Ha nincs megadva, a gyökérérték cookieDomain értékét használja. |
ösvény | húr | / | 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 is, anélkül, hogy SDK-frissítést kellene igényelnie
Blob Storage-fiókra mutató hivatkozás
Az Application Insights 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.
Ú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.
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.
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 sourcemaps
keresztü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.map
található: .
Forrástérképek feltöltése az Azure Pipelineson keresztül (ajánlott)
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.
Az Application Insights-erőforrás konfigurálása forrástérkép tárfiókkal
Az Application Insights-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.
- Az Azure Portalon tekintse meg a minimálisra módosított kivétel részleteit.
- Válassza az Unminify (Egységesítés) lehetőséget.
- Ha az erőforrás nincs konfigurálva, konfigurálja.
Tulajdonságok lap
Az Application Insights-erőforráshoz csatolt tárfiók vagy blobtároló konfigurálása vagy módosítása:
Nyissa meg az Application Insights-erőforrás Tulajdonságok lapját.
Válassza a Forrástérkép blobtároló módosítása lehetőséget.
Válasszon egy másik blobtárolót forrástérkép-tárolóként.
Válassza az Alkalmazás lehetőséget.
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.
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.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 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 |
ConnectionStringParser | @microsoft/applicationinsights-common-js |
ConnectionStringParser.parse | parseConnectionString |
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 Application Insightsba. Az értesítések kivételként jelennek meg az Application Insightsban. 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-Context
Request-Id
traceparent
.
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ó.
Az Application Insights mindig rögzíti a HTTP 502 és 503 válaszokat?
Szám Az Application Insights nem mindig rögzíti az "502 hibás átjáró" és az "503 szolgáltatás nem érhető el" hibákat. 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 monitorozással rendelkező kiszolgálóról küldték, a hibákat az Application Insights SDK gyűjti össze.
Még akkor is, ha egy alkalmazás webkiszolgálóján engedélyezve van a kiszolgálóoldali monitorozás, az Application Insights néha 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 egy 502-es vagy 503-es választ ad vissza egy ügyfélnek a fordított proxyrétegen jelentkező probléma miatt, így az Application Insights nem rögzíti a rendszerből. 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.
Következő lépések
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: