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.

1. 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.

2. Válassza ki az exportálni kívánt telemetriai adattípusokat.

3. 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.

4. 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 \nkü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:

• SQL-exportálás a Stream Analytics használatával
• Stream Analytics-minta 2

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:

1. Diagnosztikai beállítások engedélyezése a klasszikus Application Insightsban.
2. 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.
3. 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 , clientipha 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.

Lásd még

• Application Insights
• Folyamatos exportálás
• Kódminták