Telemetria exportálása az Application Insightsból

Hosszabb ideig szeretné tartani a telemetriát a szokásos megőrzési időszaknál? 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-étől a folyamatos exportálás megszűnik.
• 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ásnak diagnosztikai 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 gomb lehetővé teszi a táblázatok és diagramok Excel-számolótáblába való átvitelét.
• 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 ameddig csak szeretné, továbbra is elérhető az Application Insightsban a szokásos megőrzési időszakban.

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
• Az USA középső régiója
• 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

Feljegyzés

Ha az exportálást 2021. február 23-a előtt konfigurálták, a folyamatos exportálás az USA keleti és nyugat-európai régióiban is működni fog. Az új folyamatos exportálási szabályok nem konfigurálhatók az USA keleti vagy nyugat-európai régióiban lévő alkalmazásokra, függetlenül attól, hogy mikor jött létre az alkalmazás.

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 az Azure Blob Storage-nal.
• Azure Data Lake Storage Gen2.

Folyamatos exportálás létrehozása

Feljegyzés

Egy alkalmazás nem exportálhat napi 3 TB-nál több adatot. Ha naponta több mint 3 TB-ot exportál, 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 lehetőséget, é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 az Exportálási céltárfiók> hozzá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 ugyanabba a földrajzi régióba 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.

Feljegyzés

Az exportálás létrehozása után az újonnan betöltött adatok az Azure Blob Storage-ba fognak á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 küldi. 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árban való megjelenése előtt körülbelül egy órát is késhet.

Az első exportálás befejezése után a Blob Storage-tárolóban az alábbi struktúra található. (Ez a struktúra a gyűjtött adatoktól függően változik.)

Név	Leírás
Elérhetőség	Rendelkezésre állási webes tesztek jelentése.
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. Amikor ismét az Engedélyezés lehetőséget választja, az exportálás új adatokkal újraindul. Az exportálás letiltása során a portálra érkező adatok nem lesznek lekérve.

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 lehet exportálni 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.

Más 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 átlag ki van számítva.

Az adatok a beállított rendelkezésre állási webes tesztek eredményeit is tartalmazzák.

Feljegyzé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 is megvizsgálhatja. Válassza a Bal szélső menü Kezdőlap elemét. A tetején, ahol az Azure-szolgáltatások szerepel, válassza a Storage-fió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 a Cloud Explorer megtekinté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#/Cloudot, és válassza a Microsoft Azure SDK lekérése a .NET-hez lehetőséget.

A blobtároló megnyitásakor egy blobfájlokat tartalmazó tároló jelenik meg. Az Application Insights-erőforrás nevéből, rendszerállapotkulcsából és telemetriatípusából, dátumából és idejéből származó összes fájl URI-ja jelenik meg. Az erőforrás neve mind kisbetűs, és a rendszerállapotkulcs kihagyja a kötőjeleket.

Feljegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése 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áltás kapcsolati sztring az új képességek kihasználásához.

A dátum és az idő AZ UTC, és a telemetria tárolóba való befizetésének időpontja, nem pedig a létrehozás időpontja. 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 ez az az idő, amikor a blob létre lett hozva a belső átmeneti tárolóban.
• blobDeliveryTimeUtc az az idő, amikor a blob át lesz másolva az exportálási céltárolóba.

Adatformátum

Az adatok úgy lesznek formázva, hogy:

• Minden blob egy szövegfájl, amely több \nkülönálló sort tartalmaz. Nagyjából fél perc alatt feldolgozott telemetriát tartalmaz.

• 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 a Speciális>formátumfájl szerkesztése lehetőséget.>

  

Az időtartamok az osztásjelekben vannak, ahol 10 000 kullancs = 1 ms. Ezek az értékek például 1 ms-os időt mutatnak arra, hogy kérést küldjenek a böngészőből, 3 ms-t a fogadáshoz, és 1,8 mp-t a lap böngészőben való feldolgozásához:

"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}

A tulajdonságtípusokra és értékekre vonatkozó részletes adatmodell-referenciát az Application Insights adatmodelljének exportálása című témakörben találja.

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élda:

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.

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 azexportálási célértéket , de hagyja ki ugyanazt a tárterületet. A megerősítéshez válassza az OK lehetőséget.

A folyamatos exportálás újraindul.

Minták exportálása

Az exportálási mintákért lásd:

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

Nagyobb méretekben fontolja meg a HDInsight Hadoop-fürtöket a felhőben. 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 választ ad a gyakori kérdésekre.

Kaphatok egy diagram egyszeri letöltését?

Ezt meg is teheti. A lap tetején válassza az Adatok exportálása lehetőséget.

Beállítottam egy exportálást, de miért nincsenek adatok az áruházamban?

Kapott az Application Insights bármilyen 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 Közreműködők csoport tagjának kell lennie.

Exportálhatok közvetlenül a saját helyszíni üzletembe?

Szám Az exportálási motor jelenleg csak az Azure Storage-ral működik.

Korlátozva van az áruházamban tárolt adatok mennyisége?

Szám Az exportálás törléséig folyamatosan küldjük az adatokat. Leállunk, ha eléri a Blob Storage külső korlátait, de ez a korlát hatalmas. Önön múlik, hogy mennyi tárterületet használ.

Hány blob jelenjen meg a tárolóban?

• Minden exportálni kívánt adattípus esetében 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ómba, 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 az Exportálás célfület. Hagyja ki ugyanazt a tárterületet, mint korábban, majd az OK gombra kattintva erősítse meg a beállítást. Az exportálás újraindul. Ha a módosítás az elmúlt néhány napban történt, akkor nem fog adatvesztést okozni.

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 az Azure Event Hubsba.

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 adatexportálás konfigurálása: Válassza a Diagnosztikai beállítások>lehetőséget Diagnosztikai beállítás hozzáadása az Application Insights-erőforrásból.
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. A Log Analytics hozzáférés-vezérlési módjának beállítása munkaterület-engedélyek megkövetelésére. Az Azure szerepköralapú hozzáférés-vezérlésével 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 azon 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 formátumúak, é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 telemetriai adatok 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 szerint	Jegyzetek
context.custom.dimensions [0]	objektum [ ]	Az egyéni tulajdonságok paramétere által beállított kulcs-érték sztringpárok. A kulcs maximális hossza 100, az é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]	objektum [ ]	Az egyéni mérési paraméter és a TrackMetrics által beállított kulcs-érték párok. A kulcs maximális hossza 100, az értékek numerikusak lehetnek.
context.data.eventTime	húr	UTC
context.data.isSynthetic	Logikai	Ú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	húr	IE, Chrome, ...
context.device.browserVersion	húr	Chrome 48.0, ...
context.device.deviceModel	húr
context.device.deviceName	húr
context.device.id	húr
context.device.locale	húr	en-GB, de-DE, ...
context.device.network	húr
context.device.oemName	húr
context.device.os	húr
context.device.osVersion	húr	Gazda operációs rendszer
context.device.roleInstance	húr	A kiszolgáló gazdagépének azonosítója
context.device.roleName	húr
context.device.screenResolution	húr
context.device.type	húr	PC, böngésző, ...
context.location	object	Származtatása: clientip.
context.location.city	húr	Származtatva clientip, ha ismert
context.location.clientip	húr	Az utolsó nyolcszög 0-ra van anonimizálva.
context.location.continent	húr
context.location.country	húr
context.location.province	húr	Állam vagy tartomány
context.operation.id	húr	Az azonos operation id elemekkel rendelkező elemek a portál kapcsolódó elemeiként jelennek meg. Általában a request id.
context.operation.name	húr	URL-cím vagy kérés neve
context.operation.parentId	húr	Engedélyezi a beágyazott kapcsolódó elemeket.
context.session.id	húr	Id egyazon forrásból származó műveletek csoportjából. Egy művelet nélküli 30 perces időtartam jelzi a munkamenet végét.
context.session.isFirst	Logikai
context.user.accountAcquisitionDate	húr
context.user.accountId	húr
context.user.anonAcquisitionDate	húr
context.user.anonId	húr
context.user.authAcquisitionDate	húr	Hitelesített felhasználó
context.user.authId	húr
context.user.isAuthenticated	Logikai
context.user.storeRegion	húr
internal.data.documentVersion	húr
internal.data.id	húr	Unique id amely akkor van hozzárendelve, amikor egy elemet betölt az Application Insightsba

esemény

A TrackEvent() által létrehozott egyéni események.

Elérési út	Típus szerint	Jegyzetek
esemény [0] száma	egész szám	100/(mintavételezési sebesség). Például 4 => 25%.
esemény [0] neve	húr	Esemény neve. Maximális hossz 250.
esemény [0] URL-címe	húr
event [0] urlData.base	húr
event [0] urlData.host	húr

Kivételek

Kivételeket jelent a kiszolgálón és a böngészőben.

Elérési út	Típus szerint	Jegyzetek
basicException [0] szerelvény	húr
basicException [0] count	egész szám	100/(mintavételezési sebesség). Például 4 => 25%.
basicException [0] exceptionGroup	húr
basicException [0] exceptionType	húr
basicException [0] failedUserCodeMethod	húr
basicException [0] failedUserCodeAssembly	húr
basicException [0] handledAt	húr
basicException [0] hasFullStack	Logikai
basicException [0] id	húr
basicException [0] metódus	húr
basicException [0] üzenet	húr	Kivételüzenet. Maximális hossz 10k.
basicException [0] outerExceptionMessage	húr
basicException [0] outerExceptionThrownAtAssembly	húr
basicException [0] outerExceptionThrownAtMethod	húr
basicException [0] outerExceptionType	húr
basicException [0] outerId	húr
basicException [0] parsedStack [0] assembly	húr
basicException [0] parsedStack [0] fileName	húr
basicException [0] parsedStack [0] szint	egész szám
basicException [0] parsedStack [0] line	egész szám
basicException [0] parsedStack [0] metódus	húr
basicException [0] verem	húr	Maximális hossz 10k
basicException [0] typeName	húr

Nyomkövetési üzenetek

A TrackTrace és a naplózási adapterek küldik.

Elérési út	Típus szerint	Jegyzetek
message [0] loggerName	húr
message [0] paraméterek	húr
üzenet [0] nyers	húr	A naplóüzenet maximális hossza 10k.
message [0] severityLevel	húr

Távoli függőség

TrackDependency küldte. A kiszolgáló függőségeinek hívásainak teljesítményének és használatának jelentésére szolgál, a böngészőben pedig az AJAX-hívásokra.

Elérési út	Típus szerint	Jegyzetek
remoteDependency [0] async	Logikai
remoteDependency [0] baseName	húr
remoteDependency [0] commandName	húr	Például: "home/index"
remoteDependency [0] count	egész szám	100/(mintavételezési sebesség). Például 4 => 25%.
remoteDependency [0] dependencyTypeName	húr	HTTP, SQL, ...
remoteDependency [0] durationMetric.value	szám	A hívástól a válasz függőségek szerinti befejezéséig eltelt idő
remoteDependency [0] id	húr
remoteDependency [0] név	húr	URL-cím. Maximális hossz 250.
remoteDependency [0] resultCode	húr	HTTP-függőségből
remoteDependency [0] siker	Logikai
remoteDependency [0] típus	húr	Http, Sql,...
remoteDependency [0] URL	húr	Maximális hossz 2000
remoteDependency [0] urlData.base	húr	Maximális hossz 2000
remoteDependency [0] urlData.hashTag	húr
remoteDependency [0] urlData.host	húr	Maximális hossz 200

maximális száma

A TrackRequest küldte. A standard modulok ezt használják a kiszolgáló válaszidejének jelentésére, a kiszolgálón mérve.

Elérési út	Típus szerint	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érés beérkezésétől a válaszig eltelt idő. 1e7 == 1s
kérelem [0] id	húr	Operation id
request [0] name	húr	GET/POST + URL-alap. Maximális hossz 250
request [0] responseCode	egész szám	HTTP-válasz küldése az ügyfélnek
kérelem [0] sikeres	Logikai	Default == (responseCode < 400)
kérelem [0] URL-címe	húr	Nem tartalmazza a gazdagépet
request [0] urlData.base	húr
request [0] urlData.hashTag	húr
request [0] urlData.host	húr

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 jelenítik meg.

Elérési út	Típus szerint	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] név	húr
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 HTML válaszban való fogadására irányuló kérés elküldésének végétől kezdve 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érés elküldéséhez eltelt idő.
clientPerformance [0] URL-cím	húr	A kérés URL-címe
clientPerformance [0] urlData.base	húr
clientPerformance [0] urlData.hashTag	húr
clientPerformance [0] urlData.host	húr
clientPerformance [0] urlData.protocol	húr

Lapmegtekintések

TrackPageView() vagy stopTrackPage küldve

Elérési út	Típus szerint	Jegyzetek
[0] darabszám megtekintése	egész szám	100/(mintavételezési sebesség). Például 4 => 25%.
view [0] durationMetric.value	egész szám	Az érték a trackPageView() vagy a startTrackPage() – stopTrackPage() beállítással állítható be. Nem ugyanaz, mint a clientPerformance értékek.
[0] név megtekintése	húr	Oldal címe. Maximális hossz 250
[0] URL-cím megtekintése	húr
view [0] urlData.base	húr
view [0] urlData.hashTag	húr
view [0] urlData.host	húr

Elérhetőség

Rendelkezésre állási webes tesztek jelentése.

Elérési út	Típus szerint	Jegyzetek
rendelkezésre állás [0] availabilityMetric.name	húr	rendelkezésre állás
rendelkezésre állás [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	húr
rendelkezésre állás [0] dataSizeMetric.value	egész szám
rendelkezésre állás [0] durationMetric.name	húr
rendelkezésre állás [0] durationMetric.value	szám	A teszt időtartama. 1e7==1s
rendelkezésre állás [0] üzenet	húr	Hibadiagnosztika
rendelkezésre állás [0] eredménye	húr	Pass/Fail
rendelkezésre állás [0] runLocation	húr	A http-req földrajzi forrása
rendelkezésre állás [0] testName	húr
rendelkezésre állás [0] testRunId	húr
rendelkezésre állás [0] testTimestamp	húr

Mérőszámok

A TrackMetric() által generált.

A metrika értéke a context.custom.metrics[0] helyen található.

Példa:

{
  "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
          }
        }
      ]  
    }
  }
}

Tudnivalók a metrikaértékekről

A metrikaértékek mind a metrikajelentésekben, mind máshol szabványos objektumstruktúrával jelennek meg. Példa:

"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 name mezők value 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 összesítését az SDK-ban a portál felé történő forgalom csökkentése érdekében. Az egyes metrikajelentések elküldése előtt például több egymást követő érték is átlagolva lehet. Ezután kiszámítja a minimális, a maximális, a szórási és az összesített é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 min, a max, az stdDev és a sampledValue értéket.

A metrikák előzetes összesítése helyett mintavételezést is használhat, 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 10000000,0 1 másodpercet jelent.

Lásd még

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