Telemetria exportálása az Application Insightsból
A telemetriai adatokat a szokásos megőrzési időtartamnál hosszabb ideig szeretné megőrizni? Vagy valamilyen speciális módon szeretné feldolgozni? A folyamatos exportálás erre a célra ideális. Az Application Insights portálon látható események JSON formátumban exportálhatók az Azure-ba. Innen letöltheti az adatokat, és bármilyen kódot írhat a feldolgozáshoz.
Fontos
- 2024. február 29-én a folyamatos exportálás a klasszikus Application Insights megoldással együtt elavul.
- Amikor munkaterület-alapú Application Insights-erőforrásra migrál, diagnosztikai beállításokat kell használnia a telemetriai adatok exportálásához. Minden munkaterület-alapú Application Insights-erőforrásnakdiagnosztikai beállításokat kell használnia.
- A diagnosztikai beállítások exportálása növelheti a költségeket. További információ: Diagnosztikai beállításokon alapuló exportálás.
A folyamatos exportálás beállítása előtt érdemes megfontolni néhány alternatívát:
- A metrikák vagy a keresés lap tetején található Exportálás gombbal táblázatokat és diagramokat vihet át egy Excel-számolótáblába.
- A Log Analytics hatékony lekérdezési nyelvet biztosít a telemetriához. Az eredmények exportálására is képes.
- Ha a Power BI-ban szeretné feltárni az adatait, ezt folyamatos exportálás nélkül is megteheti, ha munkaterület-alapú erőforrásra migrált.
- A Data Access REST API lehetővé teszi a telemetriai adatok programozott elérését.
- A folyamatos exportálás beállítását a PowerShell-lel is elérheti.
Miután a folyamatos exportálás átmásolja az adatokat a tárolóba, ahol a kívánt ideig megmaradhatnak, a szokásos megőrzési időtartamig továbbra is elérhetők maradnak az Application Insightsban.
Támogatott régiók
A folyamatos exportálás a következő régiókban támogatott:
- Délkelet-Ázsia
- Közép-Kanada
- Közép-India
- Észak-Európa
- Az Egyesült Királyság déli régiója
- Kelet-Ausztrália
- Kelet-Japán
- Dél-Korea középső régiója
- Közép-Franciaország
- Kelet-Ázsia
- USA nyugati régiója
- Central US
- USA 2. keleti régiója
- USA déli középső régiója
- USA 2. nyugati régiója
- Dél-Afrika északi régiója
- USA északi középső régiója
- Dél-Brazília
- Észak-Svájc
- Délkelet-Ausztrália
- Az Egyesült Királyság nyugati régiója
- Középnyugat-Németország
- Nyugat-Svájc
- Ausztrália 2. középső régiója
- Egyesült Arab Emírségek középső régiója
- Délkelet-Brazília
- Ausztrália középső régiója
- Egyesült Arab Emírségek északi régiója
- Kelet-Norvégia
- Nyugat-Japán
Megjegyzés
Ha az exportálást 2021. február 23-a előtt konfigurálták, a folyamatos exportálás az USA keleti régiójában és Nyugat-Európában is működni fog. Az új folyamatos exportálási szabályok nem konfigurálhatók az USA keleti régiójában vagy Nyugat-Európában található alkalmazásokon, függetlenül attól, hogy mikor hozták létre az alkalmazást.
Folyamatos exportálás – speciális tárolókonfiguráció
A folyamatos exportálás nem támogatja a következő Azure Storage-funkciókat vagy konfigurációkat:
- Azure Virtual Network/Azure Storage-tűzfalak használata Azure Blob Storage.
- Azure Data Lake Storage Gen2.
Folyamatos exportálás létrehozása
Megjegyzés
Az alkalmazások nem exportálhatnak napi 3 TB-nál több adatot. Ha naponta több mint 3 TB van exportálva, az exportálás le lesz tiltva. Ha korlátozás nélkül szeretne exportálni, használja a diagnosztikai beállításokon alapuló exportálást.
Az alkalmazás Application Insights-erőforrásában a bal oldali Konfigurálás területen nyissa meg a Folyamatos exportálás elemet, és válassza a Hozzáadás lehetőséget.
Válassza ki az exportálni kívánt telemetriai adattípusokat.
Hozzon létre vagy válasszon ki egy Azure Storage-fiókot , ahol tárolni szeretné az adatokat. A tárolási díjszabási lehetőségekről további információt a Díjszabás oldalon talál.
Válassza azExportálási cél>tárfiókhozzáadása> lehetőséget. Ezután hozzon létre egy új tárolót, vagy válasszon egy meglévő tárolót.
Figyelmeztetés
Alapértelmezés szerint a tárolási hely ugyanarra a földrajzi régióra lesz beállítva, mint az Application Insights-erőforrás. Ha egy másik régióban tárol, előfordulhat, hogy átviteli díjakat kell fizetnie.
Hozzon létre vagy válasszon ki egy tárolót a tárolóban.
Megjegyzés
Az exportálás létrehozása után az újonnan betöltött adatok Azure Blob Storage kezdenek áramlani. A folyamatos exportálás csak a folyamatos exportálás engedélyezése után létrehozott vagy betöltött új telemetriát továbbítja. A folyamatos exportálás engedélyezése előtt meglévő adatok nem lesznek exportálva. A korábban létrehozott adatok folyamatos exportálással történő visszamenőleges exportálása nem támogatott.
Az adatok a tárolóban való megjelenése előtt körülbelül egy órát is késhetnek.
Az első exportálás befejezése után az alábbi struktúra található a Blob Storage-tárolóban. (Ez a struktúra a gyűjtött adatoktól függően változik.)
Név | Leírás |
---|---|
Rendelkezésre állás | Rendelkezésre állási webes teszteket jelent. |
Esemény | A TrackEvent() által létrehozott egyéni események. |
Kivételek | Kivételeket jelent a kiszolgálón és a böngészőben. |
Üzenetek | A TrackTrace és a naplózási adapterek küldik. |
Metrikák | Metrika API-hívások által generált. |
PerformanceCounters | Az Application Insights által gyűjtött teljesítményszámlálók. |
Kérelmek | A TrackRequest küldte. A standard modulok kéréseket használnak a kiszolgáló válaszidejének jelentésére, a kiszolgálón mérve. |
Folyamatos exportálás szerkesztése
Válassza a Folyamatos exportálás lehetőséget, és válassza ki a szerkeszteni kívánt tárfiókot.
Folyamatos exportálás leállítása
Az exportálás leállításához válassza a Letiltás lehetőséget. Ha ismét az Engedélyezés lehetőséget választja, az exportálás új adatokkal újraindul. Nem kapja meg a portálra érkező adatokat, amíg az exportálás le lett tiltva.
Az exportálás végleges leállításához törölje azt. Ezzel nem törli az adatokat a tárolóból.
Nem tud exportálást hozzáadni vagy módosítani?
Az exportálások hozzáadásához vagy módosításához tulajdonosi, közreműködői vagy Application Insights-közreműködői hozzáférési jogosultságra van szüksége. Tudnivalók a szerepkörökről.
Milyen eseményeket kap?
Az exportált adatok az alkalmazástól kapott nyers telemetriai adatok, az ügyfél IP-címéről hozzáadott helyadatokkal.
A mintavételezéssel elvetett adatok nem szerepelnek az exportált adatokban.
Az egyéb számított metrikák nem szerepelnek benne. Például nem exportáljuk az átlagos CPU-kihasználtságot, de exportáljuk azt a nyers telemetriát, amelyből az átlagot számítjuk ki.
Az adatok a beállított rendelkezésre állási webes tesztek eredményeit is tartalmazzák.
Megjegyzés
Ha az alkalmazás sok adatot küld, előfordulhat, hogy a mintavételezési funkció csak a generált telemetria töredékét küldi el. További tudnivalók a mintavételezésről.
Az adatok vizsgálata
A tárterületet közvetlenül a portálon ellenőrizheti. A bal szélső menüben válassza a Kezdőlap lehetőséget. A tetején, ahol az Azure-szolgáltatások felirat látható, válassza a Tárfiókok lehetőséget. Válassza ki a tárfiók nevét, majd az Áttekintés lapon válassza a Szolgáltatások>blobok lehetőséget. Végül válassza ki a tároló nevét.
Az Azure Storage Visual Studióban való vizsgálatához válassza aCloud Explorermegtekintése> lehetőséget. Ha nem rendelkezik a menüparancsával, telepítenie kell az Azure SDK-t. Nyissa meg az Új projekt párbeszédpanelt, bontsa ki a Visual C#/Cloud elemet, majd válassza a Microsoft Azure SDK for .NET letöltése lehetőséget.
A blobtároló megnyitásakor egy blobfájlokat tartalmazó tároló jelenik meg. Látni fogja az Application Insights-erőforrás nevéből, a rendszerállapotkulcsából, valamint a telemetriai típusból, dátumból és időből származó összes fájl URI-ját. Az erőforrás neve mind kisbetűs, a kialakítási kulcs pedig kihagyja a kötőjeleket.
Megjegyzés
2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapotkulcs-betöltés továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltsa át a kapcsolati sztringeket az új képességek kihasználásához.
A dátum és az idő (UTC) az, amikor a telemetriát az áruházban helyezték el, nem pedig a létrehozás időpontját. Ezért ha kódot ír az adatok letöltéséhez, az lineárisan mozoghat az adatok között.
Az elérési út formája a következő:
$"{applicationName}_{instrumentationKey}/{type}/{blobDeliveryTimeUtc:yyyy-MM-dd}/{ blobDeliveryTimeUtc:HH}/{blobId}_{blobCreationTimeUtc:yyyyMMdd_HHmmss}.blob"
Ahol:
blobCreationTimeUtc
az az idő, amikor a blob létrejött a belső átmeneti tárolóban.blobDeliveryTimeUtc
A blob exportálási céltárolóba való másolásának időpontja.
Adatformátum
Az adatok úgy lesznek formázva, hogy:
Minden blob egy szövegfájl, amely több
\n
különálló sort tartalmaz. Ez tartalmazza a körülbelül félperces időszak során feldolgozott telemetriát.Minden sor egy telemetriai adatpontot jelöl, például egy kérést vagy egy oldalnézetet.
Minden sor egy formázatlan JSON-dokumentum. Ha meg szeretné tekinteni a sorokat, nyissa meg a blobot a Visual Studióban, és válassza aSpeciális>formátumfájlszerkesztése> lehetőséget.
Az időtartamok időosztásban vannak, ahol 10 000 órajel = 1 ms. Ezek az értékek például egy 1 ms-os időt mutatnak a kérés böngészőből való elküldéséhez, 3 ms-t a fogadásához, és 1,8 s-t a lap feldolgozásához a böngészőben:
"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}
A tulajdonságtípusok és értékek részletes adatmodell-referenciáját lásd: Application Insights adatmodell exportálása.
Az adatok feldolgozása
Kis léptékben megírhat néhány kódot, amely szétválasztja az adatokat, és beolvassa őket egy számolótáblába. Például:
private IEnumerable<T> DeserializeMany<T>(string folderName)
{
var files = Directory.EnumerateFiles(folderName, "*.blob", SearchOption.AllDirectories);
foreach (var file in files)
{
using (var fileReader = File.OpenText(file))
{
string fileContent = fileReader.ReadToEnd();
IEnumerable<string> entities = fileContent.Split('\n').Where(s => !string.IsNullOrWhiteSpace(s));
foreach (var entity in entities)
{
yield return JsonConvert.DeserializeObject<T>(entity);
}
}
}
}
Nagyobb kódmintáért lásd: Feldolgozói szerepkör használata.
A régi adatok törlése
Ön a felelős a tárolási kapacitás kezeléséért és a régi adatok törléséért, ha szükséges.
A tárkulcs újragenerálása
Ha módosítja a tároló kulcsát, a folyamatos exportálás nem fog működni. Ekkor egy értesítés jelenik meg az Azure-fiókjában.
Válassza a Folyamatos exportálás lapot, és szerkessze az exportálást. Szerkessze aCél exportálása értéket, de hagyja bejelölve ugyanazt a tárolót. Válassza az OK lehetőséget a megerősítéshez.
A folyamatos exportálás újraindul.
Minták exportálása
Az exportálási mintákért lásd:
Nagyobb méretekben fontolja meg a felhőben található HDInsight Hadoop-fürtöket. A HDInsight különböző technológiákat biztosít a big data kezeléséhez és elemzéséhez. Segítségével feldolgozhatja az Application Insightsból exportált adatokat.
Gyakori kérdések
Ez a szakasz a gyakori kérdésekre ad választ.
Lekérhetem a diagramok egyszeri letöltését?
Ezt megteheti. A lap tetején válassza az Adatok exportálása lehetőséget.
Beállítok egy exportálást, de miért nincsenek adatok az áruházamban?
Kapott-e az Application Insights telemetriát az alkalmazástól az exportálás beállítása óta? Csak új adatokat fog kapni.
Megpróbáltam beállítani egy exportálást, de miért tagadtam meg a hozzáférést?
Ha a fiók a szervezet tulajdonában van, akkor a Tulajdonosok vagy a Közreműködők csoport tagjának kell lennie.
Exportálhatok közvetlenül a saját helyszíni áruházamba?
Nem. Az exportálási motor jelenleg csak az Azure Storage-ral működik.
Korlátozva van az áruházban tárolt adatok mennyisége?
Nem. Addig küldjük az adatokat, amíg nem törli az exportálást. Leállunk, ha eléri a Blob Storage külső korlátait, de ez a korlát hatalmas. Ön határozza meg, hogy mennyi tárterületet használ.
Hány blobot kell látnom a tárolóban?
- Minden exportálni kívánt adattípushoz percenként létrejön egy új blob, ha rendelkezésre állnak adatok.
- A nagy forgalmú alkalmazásokhoz további partícióegységek vannak lefoglalva. Ebben az esetben minden egység percenként létrehoz egy blobot.
Újrageneráltam a kulcsot a tárolómban, vagy módosítottam a tároló nevét, de miért nem működik az exportálás?
Szerkessze az exportálást, és válassza a Cél exportálása lapot. Hagyja bejelölve ugyanazt a tárterületet, mint korábban, majd a megerősítéshez kattintson az OK gombra . Az exportálás újraindul. Ha a módosítás az elmúlt néhány napon belül történt, nem veszíti el az adatokat.
Szüneteltethetem az exportálást?
Igen. Válassza a Letiltás lehetőséget.
Kódminták
- Stream Analytics-minta
- Exportálás SQL-be a Stream Analytics használatával
- Részletes adatmodell-referencia tulajdonságtípusokhoz és értékekhez
Diagnosztikai beállításokon alapuló exportálás
A diagnosztikai beállítások exportálása előnyben részesített, mert további funkciókat biztosít:
- Azure Storage-fiókok virtuális hálózatokkal, tűzfalakkal és privát hivatkozásokkal.
- Exportálás Azure Event Hubs.
A diagnosztikai beállítások exportálása a következő módokon tér el a folyamatos exportálástól:
- Frissített séma.
- A telemetriai adatokat a rendszer a kötegelt feltöltések helyett a beérkezéskor küldi el.
Fontos
További költségek merülhetnek fel a célhelyre irányuló hívások, például a tárfiókok számának növekedése miatt.
A diagnosztikai beállítások exportálására való migrálás:
- Diagnosztikai beállítások engedélyezése a klasszikus Application Insightsban.
- Az adatok exportálásának konfigurálása: Válassza a Diagnosztikai beállítások>Diagnosztikai beállítás hozzáadása az Application Insights-erőforrásból lehetőséget.
- Ellenőrizze, hogy az új adatexportálás ugyanúgy van-e konfigurálva, mint a folyamatos exportálás
Figyelemfelhívás
Ha diagnosztikai naplókat szeretne egy Log Analytics-munkaterületen tárolni, két szempontot kell figyelembe vennie, hogy ne jelenjenek meg ismétlődő adatok az Application Insightsban:
- A cél nem lehet ugyanaz a Log Analytics-munkaterület, amely az Application Insights-erőforrás alapját képezi.
- Az Application Insights-felhasználó nem férhet hozzá mindkét munkaterülethez. Állítsa a Log Analytics hozzáférés-vezérlési módjátmunkaterületi engedélyek megkövetelése értékre. Az Azure szerepköralapú hozzáférés-vezérlésén keresztül győződjön meg arról, hogy a felhasználó csak ahhoz a Log Analytics-munkaterülethez fér hozzá, amelyen az Application Insights-erőforrás alapul.
Ezekre a lépésekre azért van szükség, mert az Application Insights hozzáfér az Application Insights-erőforrások (beleértve a Log Analytics-munkaterületeket is) telemetriáihoz a teljes, végpontok közötti tranzakciós műveletek és pontos alkalmazásleképezések biztosításához. Mivel a diagnosztikai naplók ugyanazokat a táblázatneveket használják, duplikált telemetria jelenhet meg, ha a felhasználó több olyan erőforráshoz fér hozzá, amelyek ugyanazokat az adatokat tartalmazzák.
Application Insights – Adatmodell exportálása
Ez a táblázat az Application Insights SDK-kból a portálra küldött telemetriai adatok tulajdonságait sorolja fel. Ezeket a tulajdonságokat a folyamatos exportálásból származó adatkimenetben láthatja. A Metrikaböngésző és a Diagnosztikai keresés tulajdonságszűrőiben is megjelennek.
Vegye figyelembe a következőket:
[0]
ezekben a táblázatokban az elérési út egy pontját jelöli, ahol indexet kell beszúrnia; de nem mindig 0.- Az időtartamok mikroszekundum tizedében vannak, tehát 10000000 == 1 másodperc.
- A dátumok és időpontok UTC- és ISO-formátumban vannak megadva
yyyy-MM-DDThh:mm:ss.sssZ
Példa
// A server report about an HTTP request
{
"request": [
{
"urlData": { // derived from 'url'
"host": "contoso.org",
"base": "/",
"hashTag": ""
},
"responseCode": 200, // Sent to client
"success": true, // Default == responseCode<400
// Request id becomes the operation id of child events
"id": "fCOhCdCnZ9I=",
"name": "GET Home/Index",
"count": 1, // 100% / sampling rate
"durationMetric": {
"value": 1046804.0, // 10000000 == 1 second
// Currently the following fields are redundant:
"count": 1.0,
"min": 1046804.0,
"max": 1046804.0,
"stdDev": 0.0,
"sampledValue": 1046804.0
},
"url": "/"
}
],
"internal": {
"data": {
"id": "7f156650-ef4c-11e5-8453-3f984b167d05",
"documentVersion": "1.61"
}
},
"context": {
"device": { // client browser
"type": "PC",
"screenResolution": { },
"roleInstance": "WFWEB14B.fabrikam.net"
},
"application": { },
"location": { // derived from client ip
"continent": "North America",
"country": "United States",
// last octagon is anonymized to 0 at portal:
"clientip": "168.62.177.0",
"province": "",
"city": ""
},
"data": {
"isSynthetic": true, // we identified source as a bot
// percentage of generated data sent to portal:
"samplingRate": 100.0,
"eventTime": "2016-03-21T10:05:45.7334717Z" // UTC
},
"user": {
"isAuthenticated": false,
"anonId": "us-tx-sn1-azr", // bot agent id
"anonAcquisitionDate": "0001-01-01T00:00:00Z",
"authAcquisitionDate": "0001-01-01T00:00:00Z",
"accountAcquisitionDate": "0001-01-01T00:00:00Z"
},
"operation": {
"id": "fCOhCdCnZ9I=",
"parentId": "fCOhCdCnZ9I=",
"name": "GET Home/Index"
},
"cloud": { },
"serverDevice": { },
"custom": { // set by custom fields of track calls
"dimensions": [ ],
"metrics": [ ]
},
"session": {
"id": "65504c10-44a6-489e-b9dc-94184eb00d86",
"isFirst": true
}
}
}
Környezet
A telemetria minden típusát egy környezeti szakasz kíséri. A rendszer nem minden adatponttal továbbítja ezeket a mezőket.
Elérési út | Típus | Jegyzetek |
---|---|---|
context.custom.dimensions [0] | object [ ] | Kulcs-érték sztringpárok egyéni tulajdonságok paramétere alapján. Kulcs maximális hossza 100, értékek maximális hossza 1024. Több mint 100 egyedi érték, a tulajdonság kereshető, de szegmentálásra nem használható. Kulcsonként legfeljebb 200 kulcs. |
context.custom.metrics [0] | object [ ] | Kulcs-érték párok egyéni mérési paraméter és TrackMetrics alapján. Kulcs maximális hossza 100, az értékek numerikusak lehetnek. |
context.data.eventTime | sztring | UTC |
context.data.isSynthetic | boolean | Úgy tűnik, hogy a kérés egy robotból vagy egy webes tesztből származik. |
context.data.samplingRate | szám | A portálra küldött SDK által generált telemetriai adatok százalékos aránya. Tartomány: 0,0-100,0. |
context.device | object | Ügyféleszköz |
context.device.browser | sztring | IE, Chrome, ... |
context.device.browserVersion | sztring | Chrome 48.0, ... |
context.device.deviceModel | sztring | |
context.device.deviceName | sztring | |
context.device.id | sztring | |
context.device.locale | sztring | en-GB, de-DE, ... |
context.device.network | sztring | |
context.device.oemName | sztring | |
context.device.os | sztring | |
context.device.osVersion | sztring | Gazda operációs rendszer |
context.device.roleInstance | sztring | A kiszolgáló gazdagépének azonosítója |
context.device.roleName | sztring | |
context.device.screenResolution | sztring | |
context.device.type | sztring | PC, böngésző, ... |
context.location | object | Származtatása: clientip . |
context.location.city | sztring | Származtatása , clientip ha ismert |
context.location.clientip | sztring | Az utolsó nyolcszög 0-ra van anonimizálva. |
context.location.continent | sztring | |
context.location.country | sztring | |
context.location.province | sztring | Állam vagy tartomány |
context.operation.id | sztring | Az azonos operation id elemekkel rendelkező elemek kapcsolódó elemekként jelennek meg a portálon. Általában a .request id |
context.operation.name | sztring | URL-cím vagy kérés neve |
context.operation.parentId | sztring | Lehetővé teszi a beágyazott kapcsolódó elemeket. |
context.session.id | sztring | Id egyazon forrásból származó műveletek csoportjából. A munkamenet végét egy művelet nélküli 30 perces időtartam jelzi. |
context.session.isFirst | boolean | |
context.user.accountAcquisitionDate | sztring | |
context.user.accountId | sztring | |
context.user.anonAcquisitionDate | sztring | |
context.user.anonId | sztring | |
context.user.authAcquisitionDate | sztring | Hitelesített felhasználó |
context.user.authId | sztring | |
context.user.isAuthenticated | boolean | |
context.user.storeRegion | sztring | |
internal.data.documentVersion | sztring | |
internal.data.id | sztring | Unique id amely akkor lesz hozzárendelve, ha egy elemet az Application Insightsba betöltenek |
esemény
A TrackEvent() által létrehozott egyéni események.
Elérési út | Típus | Jegyzetek |
---|---|---|
esemény [0] száma | egész szám | 100/(mintavételezési sebesség). Például 4 => 25%. |
event [0] name | sztring | Esemény neve. Maximális hossz 250. |
event [0] URL | sztring | |
event [0] urlData.base | sztring | |
event [0] urlData.host | sztring |
Kivételek
Kivételeket jelent a kiszolgálón és a böngészőben.
Elérési út | Típus | Jegyzetek |
---|---|---|
basicException [0] szerelvény | sztring | |
basicException [0] count | egész szám | 100/(mintavételezési sebesség). Például 4 => 25%. |
basicException [0] exceptionGroup | sztring | |
basicException [0] exceptionType | sztring | |
basicException [0] failedUserCodeMethod | sztring | |
basicException [0] failedUserCodeAssembly | sztring | |
basicException [0] handledAt | sztring | |
basicException [0] hasFullStack | boolean | |
basicException [0] id |
sztring | |
basicException [0] metódus | sztring | |
basicException [0] üzenet | sztring | Kivételüzenet. Maximális hossz 10k. |
basicException [0] outerExceptionMessage | sztring | |
basicException [0] outerExceptionThrownAtAssembly | sztring | |
basicException [0] outerExceptionThrownAtMethod | sztring | |
basicException [0] outerExceptionType | sztring | |
basicException [0] outerId | sztring | |
basicException [0] parsedStack [0] assembly | sztring | |
basicException [0] parsedStack [0] fileName | sztring | |
basicException [0] parsedStack [0] szint | egész szám | |
basicException [0] parsedStack [0] sor | egész szám | |
basicException [0] parsedStack [0] metódus | sztring | |
basicException [0] verem | sztring | Maximális hossz 10k |
basicException [0] typeName | sztring |
Üzenetek nyomon követése
A TrackTrace és a naplózási adapterek küldik.
Elérési út | Típus | Jegyzetek |
---|---|---|
message [0] loggerName | sztring | |
message [0] paraméterek | sztring | |
üzenet [0] nyers | sztring | A naplóüzenet maximális hossza 10k. |
message [0] severityLevel | sztring |
Távoli függőség
A TrackDependency küldte. A kiszolgáló függőségeinek és a böngészőben az AJAX-hívásoknak a teljesítményének és használatának jelentésére szolgál.
Elérési út | Típus | Jegyzetek |
---|---|---|
remoteDependency [0] async | boolean | |
remoteDependency [0] baseName | sztring | |
remoteDependency [0] commandName | sztring | Például : "kezdőlap/index" |
remoteDependency [0] count | egész szám | 100/(mintavételezési sebesség). Például 4 => 25%. |
remoteDependency [0] dependencyTypeName | sztring | HTTP, SQL, ... |
remoteDependency [0] durationMetric.value | szám | A hívástól a válasz függőség szerinti befejezéséig eltelt idő |
remoteDependency [0] id |
sztring | |
remoteDependency [0] neve | sztring | Url. Maximális hossz 250. |
remoteDependency [0] resultCode | sztring | HTTP-függőségből |
remoteDependency [0] siker | boolean | |
remoteDependency [0] típus | sztring | Http, Sql,... |
remoteDependency [0] URL | sztring | Maximális hossz 2000 |
remoteDependency [0] urlData.base | sztring | Maximális hossz 2000 |
remoteDependency [0] urlData.hashTag | sztring | |
remoteDependency [0] urlData.host | sztring | Maximális hossz 200 |
Kérelmek
A TrackRequest küldte. A standard modulok ezt a kiszolgáló válaszidejének jelentésére használják, a kiszolgálón mérve.
Elérési út | Típus | Jegyzetek |
---|---|---|
kérelem [0] száma | egész szám | 100/(mintavételezési sebesség). Például: 4 => 25%. |
request [0] durationMetric.value | szám | A kérelem beérkezésétől a válaszig eltelt idő. 1e7 == 1s |
kérelem [0] id |
sztring | Operation id |
request [0] name | sztring | GET/POST + URL-alap. Maximális hossz 250 |
request [0] responseCode | egész szám | HTTP-válasz elküldve az ügyfélnek |
request [0] success | boolean | Alapértelmezett == (responseCode < 400) |
request [0] URL | sztring | Nem tartalmazza a gazdagépet |
request [0] urlData.base | sztring | |
request [0] urlData.hashTag | sztring | |
request [0] urlData.host | sztring |
Lapnézet teljesítménye
A böngésző küldte. A lap feldolgozásának idejét méri, a kérést kezdeményező felhasználótól a teljes megjelenítésig (az aszinkron AJAX-hívások kivételével).
A környezeti értékek az ügyfél operációs rendszerét és a böngésző verzióját mutatják.
Elérési út | Típus | Jegyzetek |
---|---|---|
clientPerformance [0] clientProcess.value | egész szám | A HTML fogadásának végétől a lap megjelenítéséig eltelt idő. |
clientPerformance [0] name | sztring | |
clientPerformance [0] networkConnection.value | egész szám | A hálózati kapcsolat létrehozásához szükséges idő. |
clientPerformance [0] receiveRequest.value | egész szám | A kérelem elküldésének végétől a HTML válaszként való fogadásához eltelt idő. |
clientPerformance [0] sendRequest.value | egész szám | A HTTP-kérés elküldéséhez szükséges idő. |
clientPerformance [0] total.value | egész szám | Az oldal megjelenítésére irányuló kérelem küldésének megkezdésétől kezdve eltelt idő. |
clientPerformance [0] URL | sztring | A kérelem URL-címe |
clientPerformance [0] urlData.base | sztring | |
clientPerformance [0] urlData.hashTag | sztring | |
clientPerformance [0] urlData.host | sztring | |
clientPerformance [0] urlData.protocol | sztring |
Lapmegtekintések
TrackPageView() vagy stopTrackPage küldve
Elérési út | Típus | Jegyzetek |
---|---|---|
view [0] count | egész szám | 100/(mintavételezési sebesség). Például 4 => 25%. |
view [0] durationMetric.value | egész szám | A trackPageView() vagy a startTrackPage() – stopTrackPage() érték megadása nem kötelező. Nem ugyanaz, mint a clientPerformance értékek. |
view [0] name | sztring | Lap címe. Maximális hossz 250 |
[0] URL-cím megtekintése | sztring | |
view [0] urlData.base | sztring | |
view [0] urlData.hashTag | sztring | |
view [0] urlData.host | sztring |
Rendelkezésre állás
Rendelkezésre állási webes tesztek jelentése.
Elérési út | Típus | Jegyzetek |
---|---|---|
rendelkezésre állás [0] availabilityMetric.name | sztring | availability |
availability [0] availabilityMetric.value | szám | 1.0 vagy 0.0 |
rendelkezésre állás [0] száma | egész szám | 100/(mintavételezési sebesség). Például 4 => 25%. |
rendelkezésre állás [0] dataSizeMetric.name | sztring | |
rendelkezésre állás [0] dataSizeMetric.value | egész szám | |
rendelkezésre állás [0] durationMetric.name | sztring | |
rendelkezésre állás [0] durationMetric.value | szám | A vizsgálat időtartama. 1e7==1s |
rendelkezésre állás [0] üzenet | sztring | Hibadiagnosztika |
rendelkezésre állás [0] eredménye | sztring | Sikeres/sikertelen |
rendelkezésre állás [0] runLocation | sztring | A HTTP-req földrajzi forrása |
rendelkezésre állás [0] testName | sztring | |
rendelkezésre állás [0] testRunId | sztring | |
rendelkezésre állás [0] testTimestamp | sztring |
Mérőszámok
A TrackMetric() által létrehozott.
A metrika értéke a context.custom.metrics[0] helyen található.
Például:
{
"metric": [ ],
"context": {
...
"custom": {
"dimensions": [
{ "ProcessId": "4068" }
],
"metrics": [
{
"dispatchRate": {
"value": 0.001295,
"count": 1.0,
"min": 0.001295,
"max": 0.001295,
"stdDev": 0.0,
"sampledValue": 0.001295,
"sum": 0.001295
}
}
]
}
}
}
A metrikaértékek ismertetése
A metrikaértékek a metrikajelentésekben és máshol is szabványos objektumstruktúrával vannak jelentve. Például:
"durationMetric": {
"name": "contoso.org",
"type": "Aggregation",
"value": 468.71603053650279,
"count": 1.0,
"min": 468.71603053650279,
"max": 468.71603053650279,
"stdDev": 0.0,
"sampledValue": 468.71603053650279
}
Jelenleg – bár ez a jövőben változhat – a standard SDK-modulokból jelentett összes értékben, count==1
és csak a és value
a name
mezők hasznosak. Az egyetlen eset, amikor ezek eltérőek lennének, ha saját TrackMetric-hívásokat írna, amelyekben beállítja a többi paramétert.
A többi mező célja, hogy lehetővé tegye a metrikák SDK-ban való összesítését a portál felé történő forgalom csökkentése érdekében. Az egyes metrikák jelentéseinek elküldése előtt például több egymást követő olvasást is átlagolva lehet. Ezután kiszámítja a minimális, maximális, szórási és összesítő értéket (összeg vagy átlag), és a számot a jelentés által képviselt értékek számára állítja.
A fenti táblázatokban kihagytuk a ritkán használt mezők számát, a minimális, a maximális, az stdDev és a sampledValue értéket.
A metrikák előzetes összesítése helyett használhat mintavételezést , ha csökkentenie kell a telemetriai adatok mennyiségét.
Időtartamok
Ha másként nem jelezzük, az időtartamok mikroszekundum tizedében jelennek meg, így az 100000000,0 1 másodpercet jelent.