Application Insights telemetriai adatmodell

  • Cikk

Az alkalmazás Elemzések telemetriát küld a webalkalmazásból az Azure Portalra, hogy elemezhesse az alkalmazás teljesítményét és használatát. A telemetriai modell szabványosított, így platform- és nyelvfüggetlen monitorozást is létrehozhat.

Az alkalmazás által gyűjtött adatok Elemzések modellelik ezt a tipikus alkalmazás-végrehajtási mintát.

Diagram that shows an Application Insights telemetry data model.

Az alkalmazás végrehajtásának figyeléséhez az alábbi telemetriai típusokat használjuk. Az alkalmazás Elemzések SDK a webalkalmazás-keretrendszerből automatikusan összegyűjti az alábbi három típust:

  • Kérés: Az alkalmazás által fogadott kérés naplózásához jön létre. Az alkalmazás Elemzések webes SDK például automatikusan létrehoz egy Kérés telemetriai elemet minden olyan HTTP-kéréshez, amelyet a webalkalmazás kap.

    A művelet a kérést feldolgozó végrehajtási szálakból áll. Más típusú műveletek figyelésére is írhat kódot , például egy webes feladatban vagy az adatokat időszakosan feldolgozó függvényben való "ébredés" gombra. Minden művelet rendelkezik azonosítóval. Az azonosítóval csoportosíthatja a kérés feldolgozása során létrehozott összes telemetriát. Az egyes műveletek sikeresek vagy sikertelenek, és időtartamuk is van.

  • Kivétel: Általában olyan kivételt jelöl, amely egy művelet meghiúsulását okozza.

  • Függőség: Az alkalmazásból egy külső szolgáltatásba vagy tárolóba, például REST API-ba vagy SQL-be irányuló hívást jelöl. A ASP.NET az SQL-hez intézett függőségi hívásokat a következő határozza System.Datameg: . A HTTP-végpontokra irányuló hívásokat a System.Net.

Az alkalmazás Elemzések három adattípust biztosít az egyéni telemetriához:

  • Nyomkövetés: Közvetlenül vagy adapteren keresztül használható a diagnosztikai naplózás implementálásához egy ön által ismert rendszerállapot-keretrendszer használatával, például Log4Net vagy System.Diagnostics.
  • Esemény: Jellemzően a szolgáltatással folytatott felhasználói interakciók rögzítésére szolgálnak a használati minták elemzéséhez.
  • Metrika: Rendszeres skaláris mérések jelentésére szolgál.

Minden telemetriaelem meghatározhatja a környezeti információkat, például az alkalmazás verzióját vagy a felhasználói munkamenet azonosítóját. A környezet olyan erősen gépelt mezők készlete, amelyek feloldják bizonyos forgatókönyvek letiltását. Az alkalmazásverzió megfelelő inicializálása esetén az alkalmazás Elemzések észleli az újratelepítéssel korrelált alkalmazás viselkedésének új mintáit.

A munkamenet-azonosítóval kiszámíthatja a szolgáltatáskimaradást vagy a felhasználókra gyakorolt problémákat. Ha kiszámítja egy adott sikertelen függőség, hibakövetés vagy kritikus kivétel munkamenet-azonosító értékeinek eltérő számát, jól megértheti a hatást.

Az alkalmazás Elemzések telemetriai modell meghatározza, hogyan lehet korrelálni a telemetriát annak a műveletnek a működéséhez, amelynek a része. Egy kérés például meghívhat egy SQL Database-t, és rögzítheti a diagnosztikai adatokat. Beállíthatja azoknak a telemetriai elemeknek a korrelációs környezetét, amelyek visszakötik a kérelem telemetriához.

Sémafejlesztések

Az alkalmazás-Elemzések adatmodell alapvető, mégis hatékony módja az alkalmazás telemetriájának modellezésének. Arra törekszünk, hogy a modell egyszerű és karcsú maradjon, hogy támogassa az alapvető forgatókönyveket, és lehetővé tesszük a séma speciális használatra való kiterjesztését.

Adatmodell vagy sémaproblémák és javaslatok jelentéséhez használja a GitHub-adattárat.

Kérelem

Az Application Elemzések kéréstelemetriaeleme azt a logikai végrehajtási sorozatot jelöli, amelyet egy külső kérés vált ki az alkalmazáshoz. Minden kérés végrehajtását egy egyedi id azonosítja, amely url tartalmazza az összes végrehajtási paramétert.

A kéréseket logikailag name csoportosíthatja, és meghatározhatja a source kérést. A kódvégrehajtás egy adott durationkódot eredményezhet success vagy fail tartalmazhat. A sikeres és sikertelen végrehajtások további csoportosítását a következővel végezheti el resultCode: . A kérelem telemetriai adatainak kezdési ideje a boríték szintjén van meghatározva.

A kérelemtelemetria egyéni properties és measurements.

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.

Név

Ez a mező a kérelem neve, és a kérelem feldolgozásához szükséges kód elérési útját jelöli. Az alacsony számosságérték lehetővé teszi a kérések jobb csoportosítását. HTTP-kérések esetén a HTTP-metódust és az URL-elérési út sablont jelöli, például GET /values/{id} a tényleges id érték nélkül.

Az alkalmazás Elemzések webes SDK a levélesethez hasonló kérésnevet küld. A felhasználói felületen való csoportosítás megkülönbözteti a kis- és nagybetűk megkülönböztetését, ezért GET /Home/Index a számlálás GET /home/INDEX külön történik, még akkor is, ha gyakran ugyanazt a vezérlőt és műveletvégrehajtást eredményezik. Ennek az az oka, hogy az URL-címek általában megkülönböztetik a kis- és nagybetűket. Érdemes lehet megnézni, hogy minden 404 hiba a nagybetűvel beírt URL-címek esetében történt-e. A ASP.NET webes SDK által a blogbejegyzésben további információkat talál a kérések névgyűjtéséről.

Maximális hossz: 1024 karakter

Azonosító

Az azonosító egy kérelemhívási példány azonosítója. A kérés és az egyéb telemetriai elemek közötti korrelációhoz használatos. Az azonosítónak globálisan egyedinek kell lennie. További információ: Telemetria-korreláció az Alkalmazás Elemzések.

Maximális hossz: 128 karakter

URL-cím

Az URL az a kérés URL-címe, amely az összes lekérdezési sztringparamétert tartalmazza.

Maximális hossz: 2048 karakter

Forrás

A forrás a kérés forrása. Ilyen például a hívó eszközkulcsa vagy a hívó IP-címe. További információ: Telemetria-korreláció az Alkalmazás Elemzések.

Maximális hossz: 1024 karakter

Időtartam

A kérelem időtartama a következőképpen van formázva DD.HH:MM:SS.MMMMMM: . Pozitívnak kell lennie, és napnál 1000 rövidebbnek kell lennie. Erre a mezőre azért van szükség, mert a kérelem telemetriai adatai az elejétől és végétől kezdődő műveletet jelölik.

Válaszkód

A válaszkód egy kérés végrehajtásának eredménye. Ez a HTTP-kérések HTTP-állapotkódja. Ez lehet érték HRESULT vagy kivételtípus más kéréstípusok esetében.

Maximális hossz: 1024 karakter

Sikeres művelet

A sikeresség azt jelzi, hogy egy hívás sikeres vagy sikertelen volt-e. Ez a mező kötelező. Ha egy kérés nincs explicit módon falsebeállítva, az sikeresnek minősül. Ha egy kivétel vagy a visszaadott hiba eredménykódja megszakította a műveletet, állítsa ezt az értéket a következőre false: .

Webalkalmazások esetén az alkalmazás Elemzések akkor határoz meg sikeres kérést, ha a válaszkód kisebb 400 vagy egyenlő401. Vannak azonban olyan esetek, amikor ez az alapértelmezett leképezés nem felel meg az alkalmazás szemantikájának.

A válaszkód 404 "nincs rekord" értéket jelezhet, amely a normál folyamat része lehet. Emellett hibás hivatkozást is jelezhet. A hibás hivatkozások esetében speciálisabb logikát implementálhat. A hibás hivatkozásokat csak akkor jelölheti meg hibaként, ha ezek a hivatkozások ugyanazon a webhelyen találhatók az URL-hivatkozó elemzésével. Vagy megjelölheti őket hibákként, amikor a vállalat mobilalkalmazásából érik el őket. Hasonlóképpen, és 302 jelezze a 301 hibát, ha az ügyfél nem támogatja az átirányítást.

A részben elfogadott tartalom 206 egy általános kérés sikertelenségét jelezheti. Előfordulhat például, hogy egy alkalmazás Elemzések végpont egyetlen kérelemként kap telemetriai elemeket. Akkor adja 206 vissza, ha a köteg egyes elemeit nem sikerült feldolgozni. A növekvő arány 206 olyan problémát jelez, amelyet ki kell vizsgálni. Hasonló logika vonatkozik a 207 többállapotúra, ahol a siker lehet a legrosszabb a különálló válaszkódok közül.

Egyéni tulajdonságok

Egyéni tulajdonságok név-érték gyűjteménye: Ez a gyűjtemény a szabványos telemetriai adatok egyéni dimenziókkal való kiterjesztésére szolgál. Ilyen például a telemetriát előállító üzembehelyezési pont vagy a telemetriaelem-specifikus tulajdonság, például a rendelésszám.

  • Kulcs maximális hossza: 150
  • Maximális értékhossz: 8192

Egyéni mérések

Egyéni mérések gyűjteménye: Ez a gyűjtemény a telemetriai elemhez társított elnevezett mérések jelentésére használható. A tipikus használati esetek a következők:

  • A függőségi telemetria hasznos adatainak mérete.
  • A kérelemtelemetria által feldolgozott üzenetsorelemek száma.
  • Az az idő, amíg az ügyfél befejezte a varázsló lépését az eseménytelemetria elvégzéséhez.

Egyéni méréseket az Application Analyticsben kérdezhet le:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Feljegyzés

  • Az egyéni mérések a hozzájuk tartozó telemetriai elemhez vannak társítva. Mintavételezés tárgyát képezi a méréseket tartalmazó telemetriai elem. A más telemetriai típusoktól független értékkel rendelkező mérések nyomon követéséhez használja a metrikatelemetria használatát.
  • Ne használjon sztringértékeket egyéni mérésekhez. Csak numerikus értékek támogatottak.

Kulcs maximális hossza: 150

Függőség

A függőségi telemetria (az Alkalmazás Elemzések) a figyelt összetevő és egy távoli összetevő, például az SQL vagy a HTTP-végpont közötti interakciót jelenti.

Név

Ez a mező a függőségi hívással kezdeményezett parancs neve. Alacsony számossági értékkel rendelkezik. Ilyenek például a tárolt eljárás neve és az URL-elérési út sablonja.

Azonosító

Az azonosító egy függőségi híváspéldány azonosítója. A függőségi hívásnak megfelelő kérelem telemetriai elemével való korrelációhoz használatos. További információ: Telemetria-korreláció az Alkalmazás Elemzések.

Adat

Ez a mező a függőségi hívás által kezdeményezett parancs. Ilyenek például az SQL-utasítás és a HTTP URL-cím az összes lekérdezési paraméterrel.

Típus

Ez a mező a függőségtípus neve. Alacsony számossági értékkel rendelkezik a függőségek logikai csoportosításához és más mezők, például commandName és resultCode. Ilyen például az SQL, az Azure Table és a HTTP.

Cél

Ez a mező egy függőségi hívás célhelye. Ilyen például a kiszolgáló neve és a gazdagép címe. További információ: Telemetria-korreláció az Alkalmazás Elemzések.

Időtartam

A kérelem időtartama formátuma DD.HH:MM:SS.MMMMMM. Napnál 1000 rövidebbnek kell lennie.

Eredménykód

Ez a mező egy függőségi hívás eredménykódja. Ilyen például az SQL-hibakód és a HTTP-állapotkód.

Sikeres művelet

Ez a mező egy sikeres vagy sikertelen hívás jelzése.

Egyéni tulajdonságok

Egyéni tulajdonságok név-érték gyűjteménye: Ez a gyűjtemény a szabványos telemetriai adatok egyéni dimenziókkal való kiterjesztésére szolgál. Ilyen például a telemetriát előállító üzembehelyezési pont vagy a telemetriaelem-specifikus tulajdonság, például a rendelésszám.

  • Kulcs maximális hossza: 150
  • Maximális értékhossz: 8192

Egyéni mérések

Egyéni mérések gyűjteménye: Ez a gyűjtemény a telemetriai elemhez társított elnevezett mérések jelentésére használható. A tipikus használati esetek a következők:

  • A függőségi telemetria hasznos adatainak mérete.
  • A kérelemtelemetria által feldolgozott üzenetsorelemek száma.
  • Az az idő, amíg az ügyfél befejezte a varázsló lépését az eseménytelemetria elvégzéséhez.

Egyéni méréseket az Application Analyticsben kérdezhet le:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Feljegyzés

  • Az egyéni mérések a hozzájuk tartozó telemetriai elemhez vannak társítva. Mintavételezés tárgyát képezi a méréseket tartalmazó telemetriai elem. A más telemetriai típusoktól független értékkel rendelkező mérések nyomon követéséhez használja a metrikatelemetria használatát.
  • Ne használjon sztringértékeket egyéni mérésekhez. Csak numerikus értékek támogatottak.

Kulcs maximális hossza: 150

Kivétel

Az Alkalmazás Elemzések esetében a kivételpéldány egy kezelt vagy kezeletlen kivételt jelöl, amely a figyelt alkalmazás végrehajtása során történt.

Probléma azonosítója

A problémaazonosító azonosítja, hogy hol történt a kivétel a kódban. Ez a kivételcsoportozáshoz használatos. Ez általában egy kivételtípus és egy függvény kombinációja a hívásveremből.

Maximális hossz: 1024 karakter

Súlyossági szint

Ez a mező a nyomkövetés súlyossági szintje. Az érték lehet Verbose, Information, Warning, Errorvagy Critical.

Kivétel részletei

(Kiterjesztendő)

Egyéni tulajdonságok

Egyéni tulajdonságok név-érték gyűjteménye: Ez a gyűjtemény a szabványos telemetriai adatok egyéni dimenziókkal való kiterjesztésére szolgál. Ilyen például a telemetriát előállító üzembehelyezési pont vagy a telemetriaelem-specifikus tulajdonság, például a rendelésszám.

  • Kulcs maximális hossza: 150
  • Maximális értékhossz: 8192

Egyéni mérések

Egyéni mérések gyűjteménye: Ez a gyűjtemény a telemetriai elemhez társított elnevezett mérések jelentésére használható. A tipikus használati esetek a következők:

  • A függőségi telemetria hasznos adatainak mérete.
  • A kérelemtelemetria által feldolgozott üzenetsorelemek száma.
  • Az az idő, amíg az ügyfél befejezte a varázsló lépését az eseménytelemetria elvégzéséhez.

Egyéni méréseket az Application Analyticsben kérdezhet le:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Feljegyzés

  • Az egyéni mérések a hozzájuk tartozó telemetriai elemhez vannak társítva. Mintavételezés tárgyát képezi a méréseket tartalmazó telemetriai elem. A más telemetriai típusoktól független értékkel rendelkező mérések nyomon követéséhez használja a metrikatelemetria használatát.
  • Ne használjon sztringértékeket egyéni mérésekhez. Csak numerikus értékek támogatottak.

Kulcs maximális hossza: 150

Trace

Az Application Elemzések nyomkövetési telemetriai adatai a keresett szöveg stílusának nyomkövetési utasításait jelölikprintf. Log4Net, NLogés más szövegalapú naplófájlbejegyzések ilyen típusú példányokra lesznek lefordítva. A nyomkövetés nem rendelkezik méretekkel bővíthetőségként.

Üzenet

Nyomkövetési üzenet.

Maximális hossz: 32 768 karakter

Súlyossági szint

Nyomkövetés súlyossági szintje.

Értékek:Verbose, Information, Warning, Errorés Critical

Egyéni tulajdonságok

Egyéni tulajdonságok név-érték gyűjteménye: Ez a gyűjtemény a szabványos telemetriai adatok egyéni dimenziókkal való kiterjesztésére szolgál. Ilyen például a telemetriát előállító üzembehelyezési pont vagy a telemetriaelem-specifikus tulajdonság, például a rendelésszám.

  • Kulcs maximális hossza: 150
  • Maximális értékhossz: 8192

Esemény

Eseménytelemetriaelemeket hozhat létre (az Alkalmazás Elemzések) az alkalmazásban történt események megjelenítéséhez. Ez általában felhasználói beavatkozás, például gombkattintás vagy megrendelési kivétel. Az alkalmazás életciklusának eseménye is lehet, például inicializálás vagy konfigurációfrissítés.

Szemantikailag előfordulhat, hogy az események nem kapcsolódnak a kérésekhez. Megfelelő használat esetén az eseménytelemetria fontosabb, mint a kérések vagy nyomkövetések. Az események üzleti telemetriát jelentenek, és külön, kevésbé agresszív mintavételezésnek kell alávetni.

Név

Esemény neve: A megfelelő csoportosítás és a hasznos metrikák engedélyezéséhez korlátozza az alkalmazást, hogy néhány külön eseménynevet hozzon létre. Ne használjon például külön nevet az esemény minden létrehozott példányához.

Maximális hossz: 512 karakter

Egyéni tulajdonságok

Egyéni tulajdonságok név-érték gyűjteménye: Ez a gyűjtemény a szabványos telemetriai adatok egyéni dimenziókkal való kiterjesztésére szolgál. Ilyen például a telemetriát előállító üzembehelyezési pont vagy a telemetriaelem-specifikus tulajdonság, például a rendelésszám.

  • Kulcs maximális hossza: 150
  • Maximális értékhossz: 8192

Egyéni mérések

Egyéni mérések gyűjteménye: Ez a gyűjtemény a telemetriai elemhez társított elnevezett mérések jelentésére használható. A tipikus használati esetek a következők:

  • A függőségi telemetria hasznos adatainak mérete.
  • A kérelemtelemetria által feldolgozott üzenetsorelemek száma.
  • Az az idő, amíg az ügyfél befejezte a varázsló lépését az eseménytelemetria elvégzéséhez.

Egyéni méréseket az Application Analyticsben kérdezhet le:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Feljegyzés

  • Az egyéni mérések a hozzájuk tartozó telemetriai elemhez vannak társítva. Mintavételezés tárgyát képezi a méréseket tartalmazó telemetriai elem. A más telemetriai típusoktól független értékkel rendelkező mérések nyomon követéséhez használja a metrikatelemetria használatát.
  • Ne használjon sztringértékeket egyéni mérésekhez. Csak numerikus értékek támogatottak.

Kulcs maximális hossza: 150

Metrika

Az alkalmazás Elemzések kétféle metrikatelemet támogat: egyetlen mérést és előre összesített metrikát. Az egyetlen mérés csak egy név és érték. Az előaggregált metrika az aggregációs intervallumban a metrika minimális és maximális értékét és szórását határozza meg.

Az előre csoportosított metrikatelemetria feltételezi, hogy az aggregációs időszak egy perc volt.

Az alkalmazás Elemzések számos jól ismert metrikanevet támogat. Ezek a metrikák a performanceCounters táblázatba kerülnek.

Az alábbi táblázat a rendszer- és folyamatszámlálókat ábrázoló metrikákat mutatja be.

.NET-név Platform-agnosztikus név Leírás
\Processor(_Total)\% Processor Time Folyamatban lévő munka... Teljes gépi PROCESSZOR.
\Memory\Available Bytes Folyamatban lévő munka... A számítógépen futó folyamatok számára elérhető fizikai memória mennyisége bájtban. A számítás a nullázott, szabad és készenléti memórialistákon lévő térköz összegzésével történik. A szabad memória használatra kész. A nullázott memória olyan oldalakból áll, amelyek tele vannak nullákkal, hogy a későbbi folyamatok ne láthassák az előző folyamat által használt adatokat. A készenléti memória olyan memória, amely a folyamat munkakészletéből (annak fizikai memóriájából) a lemezre irányítva lett eltávolítva, de továbbra is visszahívható. Lásd: Memóriaobjektum.
\Process(??APP_WIN32_PROC??)\% Processor Time Folyamatban lévő munka... Az alkalmazást üzemeltető folyamat processzora.
\Process(??APP_WIN32_PROC??)\Private Bytes Folyamatban lévő munka... Az alkalmazást üzemeltető folyamat által használt memória.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec Folyamatban lévő munka... Az alkalmazást üzemeltető folyamat által futtatott I/O-műveletek sebessége.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec Folyamatban lévő munka... Az alkalmazás által feldolgozott kérelmek aránya.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Folyamatban lévő munka... Az alkalmazás által kidobott kivételek aránya.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time Folyamatban lévő munka... A kérelmek átlagos végrehajtási ideje.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue Folyamatban lévő munka... A várólistán a feldolgozásra váró kérelmek száma.

A Metrics REST API-val kapcsolatos további információkért lásd a Metrikák – Get című témakört.

Név

Ez a mező annak a metrikanak a neve, amelyet látni szeretne az Alkalmazás Elemzések portálon és a felhasználói felületen.

Érték

Ez a mező a mérés egyetlen értéke. Ez az összesítés egyedi méréseinek összege.

Gróf

Ez a mező az összesített metrika metrikasúlya. Nem szabad méréshez beállítani.

Min

Ez a mező az összesített metrika minimális értéke. Nem szabad méréshez beállítani.

Max

Ez a mező az összesített metrika maximális értéke. Nem szabad méréshez beállítani.

Szórás

Ez a mező az összesített metrika szórása. Nem szabad méréshez beállítani.

Egyéni tulajdonságok

Az egyéni tulajdonsággal CustomPerfCountertrue rendelkező metrika azt jelzi, hogy a metrika a Windows teljesítményszámlálót jelöli. Ezek a metrikák nem a táblában, hanem a performanceCounters táblában vannak elhelyezve customMetrics. A metrika neve emellett a kategória- és számláló- és példánynevek kinyeréséhez is ki lesz elemezve.

Egyéni tulajdonságok név-érték gyűjteménye: Ez a gyűjtemény a szabványos telemetriai adatok egyéni dimenziókkal való kiterjesztésére szolgál. Ilyen például a telemetriát előállító üzembehelyezési pont vagy a telemetriaelem-specifikus tulajdonság, például a rendelésszám.

  • Kulcs maximális hossza: 150
  • Maximális értékhossz: 8192

PageView

A PageView-telemetria (az Alkalmazás Elemzések) naplózása akkor történik, amikor egy alkalmazás felhasználója megnyitja a figyelt alkalmazás új oldalát. Ebben Page a kontextusban egy logikai egység, amelyet a fejlesztő alkalmazáslapként vagy képernyőként határoz meg, és nem feltétlenül kapcsolódik a böngésző weblapjának betöltéséhez vagy frissítési műveletéhez. Ez a különbség tovább érthető az egyoldalas alkalmazások (SLA-k) kontextusában, ahol az oldalak közötti váltás nem kapcsolódik a böngészőoldal-műveletekhez. Ez pageViews.duration az az idő, amely alatt az alkalmazás bemutatja a lapot a felhasználónak.

Feljegyzés

  • Alapértelmezés szerint az alkalmazás Elemzések SDK-k naplóznak egy-egy PageView eseményt minden böngészőoldal betöltési műveletén, böngészőidőzítéssel pageViews.durationfeltöltve. A fejlesztők a trackPageView API-hívással bővíthetik az események további nyomon követését.PageView
  • Az alapértelmezett naplómegőrzés 30 nap. Ha hosszabb ideig szeretné megtekinteni PageView a statisztikákat, módosítania kell a beállítást.

A browserTiming mérése az Application Elemzések-ban

A modern böngészők méréseket végeznek az oldalbetöltési műveletekhez a Performance API-val. Az alkalmazás Elemzések egyszerűsíti ezeket a méréseket azáltal, hogy a kapcsolódó időzítéseket standard böngészőmetrikákba összesíti az ezekben a feldolgozási idődefiníciókban meghatározottak szerint:

  • Ügyfél <–> DNS: Az ügyfél a DNS-hez érkezik a webhely gazdagépnevének feloldásához, és a DNS az IP-címmel válaszol.

  • Ügyfél <–> Webkiszolgáló: Az ügyfél létrehozza a TCP-t, majd a TLS-kézfogásokat a webkiszolgálóval.

  • Ügyfél <–> Webkiszolgáló: Az ügyfél hasznos adatokat küld a kérésnek, megvárja, amíg a kiszolgáló végrehajtja a kérést, és megkapja az első válaszcsomagot.

  • Ügyfél <–-Web Server: Az ügyfél megkapja a válasz hasznos adatbájtjainak fennmaradó részét a webkiszolgálótól.

  • Ügyfél: Az ügyfél most már teljes válasz hasznos adatokkal rendelkezik, és tartalmat kell megjelenítenie a böngészőben, és be kell töltenie a DOM-et.

  • browserTimings/networkDuration = #1 + #2

  • browserTimings/sendDuration = #3

  • browserTimings/receiveDuration = #4

  • browserTimings/processingDuration = #5

  • browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

  • pageViews/duration

Screenshot that shows the Metrics page in Application Insights showing graphic displays of metrics data for a web application.

Környezet

Minden telemetriaelem rendelkezhet egy erősen beírt környezeti mezővel. Minden mező egy adott monitorozási forgatókönyvet tesz lehetővé. Az egyéni tulajdonságok gyűjteményével egyéni vagy alkalmazásspecifikus környezeti információkat tárolhat.

Alkalmazás verziója

Az alkalmazáskörnyezet mezőinek információi mindig a telemetriát küldő alkalmazásról szólnak. Az alkalmazásverzió az alkalmazás viselkedésének trendváltozásait és az üzemelő példányokkal való korrelációját elemzi.

Maximális hossz: 1024

Ügyfél IP-címe

Ez a mező az ügyféleszköz IP-címe. Az IPv4 és az IPv6 protokoll támogatott. Amikor a rendszer telemetriát küld egy szolgáltatásból, a hely kontextusa arról a felhasználóról szól, aki a szolgáltatásban kezdeményezte a műveletet. Az alkalmazás Elemzések kinyerni a földrajzi hely adatait az ügyfél IP-címéből, majd csonkítani. Az ügyfél IP-címe önmagában nem használható felhasználóazonosításra alkalmas információként.

Maximális hossz: 46

Eszköz típusa

Eredetileg ezt a mezőt használták az alkalmazás felhasználója által használt eszköz típusának jelzésére. Ma elsősorban a JavaScript-telemetriát különbözteti meg az eszköztípussal Browser , a kiszolgálóoldali telemetriától az eszköztípussal PC.

Maximális hossz: 64

Műveletazonosító

Ez a mező a gyökérművelet egyedi azonosítója. Ez az azonosító lehetővé teszi a telemetriai adatok csoportosítását több összetevő között. További információ: Telemetriai korreláció. A műveletazonosítót egy kérés vagy oldalnézet hozza létre. Minden más telemetria ezt a mezőt az azt tartalmazó kérelem vagy oldalnézet értékére állítja.

Maximális hossz: 128

Szülőművelet azonosítója

Ez a mező a telemetriai elem közvetlen szülőjének egyedi azonosítója. További információ: Telemetriai korreláció.

Maximális hossz: 128

Művelet neve

Ez a mező a művelet neve (csoportja). Egy kérés vagy egy oldalnézet hozza létre a művelet nevét. Az összes többi telemetriai elem a mezőt az azt tartalmazó kérelem vagy oldalnézet értékére állítja. A művelet neve egy műveletcsoport összes telemetriai elemének megkeresésére szolgál (például GET Home/Index). Ez a környezeti tulajdonság olyan kérdések megválaszolására szolgál, mint például a Mi a tipikus kivételek ezen a lapon?

Maximális hossz: 1024

A művelet szintetikus forrása

Ez a mező a szintetikus forrás neve. Az alkalmazás egyes telemetriai adatai a szintetikus forgalmat jelölhetik. Lehet, hogy a webbejáró indexeli a webhelyet, a webhely rendelkezésre állási tesztjeit vagy olyan diagnosztikai kódtárakból származó nyomkövetéseket, mint maga az alkalmazás Elemzések SDK.

Maximális hossz: 1024

Munkamenet-azonosító

A munkamenet-azonosító a felhasználó alkalmazással való interakciójának példánya. A munkamenet-környezet mezőinek információi mindig a felhasználóról szólnak. Amikor a rendszer telemetriát küld egy szolgáltatásból, a munkamenet-környezet arról a felhasználóról szól, aki kezdeményezte a műveletet a szolgáltatásban.

Maximális hossz: 64

Névtelen felhasználói azonosító

A névtelen felhasználói azonosító (User.Id) az alkalmazás felhasználóját jelöli. Amikor a rendszer telemetriát küld egy szolgáltatásból, a felhasználói környezet arról a felhasználóról szól, aki elindította a műveletet a szolgáltatásban.

A mintavételezés az egyik módszer az összegyűjtött telemetriai adatok mennyiségének minimalizálására. A mintavételezési algoritmus megpróbál mintát venni vagy kivenni az összes korrelált telemetriából. A rendszer névtelen felhasználói azonosítót használ a mintavételi pontszám létrehozásához, így a névtelen felhasználói azonosítónak elég véletlenszerű értéknek kell lennie.

Feljegyzés

A névtelen felhasználói azonosítók száma nem azonos az egyedi alkalmazásfelhasználók számával. A névtelen felhasználói azonosítók száma általában magasabb, mivel minden alkalommal, amikor a felhasználó egy másik eszközön vagy böngészőben nyitja meg az alkalmazást, vagy törli a böngésző cookie-jait, egy új egyedi, névtelen felhasználói azonosítót foglal le a rendszer. Ez a számítás azt eredményezheti, hogy ugyanazokat a fizikai felhasználókat többször is megszámlálja.

A felhasználói azonosítók kereszthivatkozásra hivatkozhatnak a munkamenet-azonosítókkal, így egyedi telemetriai dimenziókat biztosíthatnak, és felhasználói tevékenységet hozhatnak létre egy munkamenet időtartama alatt.

Ha névtelen felhasználói azonosítót használ a felhasználónév tárolására, az a mező helytelen használata. Használjon hitelesített felhasználói azonosítót.

Maximális hossz: 128

Hitelesített felhasználói azonosító

A hitelesített felhasználói azonosító a névtelen felhasználói azonosító ellentéte. Ez a mező rövid névvel jelöli a felhasználót. Ez az azonosító alapértelmezés szerint csak az ASP.NET-keretrendszer SDK-jával lesz összegyűjtveAuthenticatedUserIdTelemetryInitializer.

Az Alkalmazás Elemzések SDK használatával inicializálhatja a hitelesített felhasználói azonosítót egy olyan értékkel, amely állandó módon azonosítja a felhasználót a böngészőkben és az eszközökön. Ily módon az összes telemetriai elem az egyedi azonosítóhoz lesz rendelve. Ez az azonosító lehetővé teszi az adott felhasználó számára gyűjtött összes telemetriai adat lekérdezését (a mintavételezési konfigurációk és a telemetriaszűrés függvényében).

A felhasználói azonosítók kereszthivatkozásra hivatkozhatnak a munkamenet-azonosítókkal, így egyedi telemetriai dimenziókat biztosíthatnak, és felhasználói tevékenységet hozhatnak létre egy munkamenet időtartama alatt.

Maximális hossz: 1024

Számlaazonosító

A több-bérlős alkalmazások fiókazonosítója a bérlői fiók azonosítója vagy neve, amellyel a felhasználó jár el. További felhasználói szegmentáláshoz használatos, ha egy felhasználói azonosító és egy hitelesített felhasználói azonosító nem elegendő. Ilyen lehet például az Azure Portal előfizetés-azonosítója vagy egy blogplatform blogneve.

Maximális hossz: 1024

Felhőbeli szerepkör

Ez a mező annak a szerepkörnek a neve, amelynek az alkalmazás része. Közvetlenül a szerepkör nevére képez le az Azure-ban. A mikroszolgáltatások megkülönböztetésére is használható, amelyek egyetlen alkalmazás részét képezik.

Maximális hossz: 256

Felhőalapú szerepkörpéldány

Ez a mező annak a példánynak a neve, ahol az alkalmazás fut. Ez lehet például a helyszíni számítógép neve vagy az Azure példányneve.

Maximális hossz: 256

Belső: SDK-verzió

További információ: SDK-verzió.

Maximális hossz: 64

Belső: Csomópont neve

Ez a mező a számlázási célokra használt csomópontnevet jelöli. Ezzel felülbírálhatja a csomópontok szabványos észlelését.

Maximális hossz: 256

Gyakori kérdések

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

Hogyan mérném egy monitorozási kampány hatását?

A PageView Telemetria URL-címet tartalmaz, és a Kusto regex függvényével elemezheti az UTM paramétert.

Előfordulhat, hogy ezek az adatok hiányoznak vagy pontatlanok, ha a felhasználó vagy a vállalat letiltja a felhasználói ügynök küldését a böngésző beállításai között. Előfordulhat, hogy az UA Parser regexes nem tartalmazza az összes eszközinformációt. Vagy előfordulhat, hogy az alkalmazás Elemzések nem fogadta el a legújabb frissítéseket.

Miért lenne sikeres egy egyéni mérés hiba nélkül, de a napló nem jelenik meg?

Ez akkor fordulhat elő, ha sztringértékeket használ. Csak a numerikus értékek működnek egyéni mérésekkel.

Következő lépések

Megtudhatja, hogyan használhatja az Application Elemzések API-t egyéni eseményekhez és metrikákhoz, beleértve a következőket:

Függőségkövetés beállítása a következőhöz:

További tudnivalók: