Application Insights telemetriai adatmodell

Az Application Insights telemetriát küld a webalkalmazásból az Azure Portalra, hogy betekintést nyújtson az alkalmazás és az infrastruktúra teljesítményébe és használatába. A telemetriai adatok jobb megértéséhez és rendszerezéséhez különböző típusokra kategorizáljuk őket.

A telemetriai adatmodell szabványosított, így platform- és nyelvfüggetlen monitorozás hozható létre. 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.

Az Application Insights által gyűjtött adatok ezt a tipikus alkalmazásvégrehajtási mintát modellelik:

^{Az 1}availabilityResults alapértelmezés szerint nem érhető el, és a rendelkezésre állási tesztek beállítását igényli.
²customEvents és customMetrics csak egyedi műszerezéssel érhetők el.

Feljegyzés

Az Application Insights régi okokból tárolja a naplókat a traces táblában. Az elosztott nyomkövetések tartományai a requestsdependencies táblákban vannak tárolva. Azt tervezzük, hogy ezt egy későbbi kiadásban megoldjuk, hogy elkerüljük a félreértéseket.

Telemetriai típusok

Az alkalmazás végrehajtásának figyeléséhez a következő telemetriai típusokat használjuk. Az Azure Monitor OpenTelemetry Distro és az Application Insights JavaScript SDK a következő adatokat gyűjti:

Telemetriai típus	Table name (Táblázat neve) (Application Insights)	Table name (Táblázat neve) (Naplóelemzés)	Leírás
Elérhetőség	availabilityResults	AppAvailabilityResults	Figyeli az alkalmazás rendelkezésre állását és válaszképességét azáltal, hogy rendszeres időközönként küld webes kéréseket, és riasztást küld, ha az alkalmazás nem válaszol, vagy ha a válaszidő túl lassú.
Böngésző időzítése	browserTimings	AppBrowserTimings	A weblapok teljesítményét méri, beleértve a lapok betöltési idejét és a hálózati időtartamokat.
függőség	dependencies	AppDependencies	Nyomon követi az alkalmazásból egy külső szolgáltatásba vagy tárba irányuló hívásokat, például REST API-t vagy SQL-adatbázist, és méri a hívások időtartamát és sikerességét.
Esemény	customEvents	AppEvents	Általában a felhasználói interakciók és az alkalmazáson belüli egyéb jelentős események, például gombkattintások vagy megrendelések rögzítésére szolgálnak a használati minták elemzéséhez.
Kivétel	exceptions	AppExceptions	Rögzíti a hibaelhárításhoz és a hibák megértéséhez elengedhetetlen hibainformációkat.
Mérték	performanceCounters customMetrics	AppPerformanceCounters AppMetrics	A teljesítményszámlálók numerikus adatokat szolgáltatnak az alkalmazás és a rendszer teljesítményének különböző aspektusairól, például a processzorhasználatról és a memóriahasználatról. Emellett az egyéni metrikák lehetővé teszik az alkalmazás egyedi méréseinek meghatározását és nyomon követését, így rugalmasan figyelheti az egyéni teljesítménymutatókat.
Oldalnézet	pageViews	AppPageViews	Nyomon követi a felhasználók által megtekintett lapokat, és betekintést nyújt az alkalmazáson belüli felhasználói navigációba és előjegyzésbe.
kérelem	requests	AppRequests	Naplózza az alkalmazás által fogadott kérelmeket, és megadja az olyan adatokat, mint a művelet azonosítója, időtartama, sikeressége vagy sikertelensége.
Nyomkövetés	traces	AppTraces	Naplózza az alkalmazásspecifikus eseményeket, például egyéni diagnosztikai üzeneteket vagy nyomkövetési utasításokat, amelyek hasznosak az alkalmazás viselkedésének hibakereséséhez és monitorozásához.

Fontos

Az alkalmazástelemetria az Application Insights és a Log Analytics szolgáltatásból is lekérdezhető (ajánlott), de a tábla- és mezőnevek eltérőek. Ez a különbség megőrzi a visszamenőleges kompatibilitást, például annak biztosítása érdekében, hogy a Log Analytics elnevezési konvenció előtt létrehozott egyéni lekérdezésekkel rendelkező ügyfél-irányítópultok továbbra is megfelelően működjenek.

Az Azure Portal mezőneveinek összehasonlításához nyissa meg az ApplicationInsights-naplókat>, futtasson egy lekérdezést, és másolja ki a Id telemetriai elemeket (például1234a5b6c7de8f90). Ezután nyisson meg egy új lapot a böngészőben, nyissa meg a LogAnalytics-naplókat>, váltson KQL módra, és futtassa a lekérdezést:

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

Bontsa ki mindkét telemetriai elemet az egyes soroktól balra található sávjel kiválasztásával az összes tulajdonságuk megtekintéséhez.

Minden telemetriaelem tartalmazhat 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őkből áll, amelyek különböző elemzési forgatókönyveket tesznek lehetővé.

Ha például az alkalmazásverzió megfelelően inicializálva van, az Application Insights képes észlelni az újratelepítéssel korrelált alkalmazás viselkedésének új mintáit. Hasonlóképpen használhatja a munkamenet-azonosítót a kimaradások vagy problémák felhasználókra gyakorolt hatásának felméréséhez. A sikertelen függőségekhez, hibakövetésekhez vagy kritikus kivételekhez társított egyedi munkamenet-azonosítók számának kiszámításával tisztább képet kaphat a felhasználói hatásról.

Az Application Insights telemetriai modellje támogatja a telemetriai elemek korrelációját azokhoz a műveletekhez, amelyekhez tartoznak. Ha például egy kérelem SQL Database-hívást indít el, a kérés és a függőségi hívás is tartalmazhat diagnosztikai adatokat, és egy megosztott korrelációs kontextuson keresztül csatolható, így nyomon követheti a művelet teljes folyamatát.

Ez a cikk az egyes telemetriai típusokra jellemző mezőket ismerteti. Ha meg szeretné tekinteni az elérhető mezők teljes listáját (beleértve a környezeti mezőket is) bármilyen telemetriai típushoz, kövesse az egyes releváns táblák alatt található hivatkozást.

Rendelkezésre állási telemetria

A rendelkezésre állási telemetriai adatok szintetikus monitorozást igényelnek, ahol a tesztek felhasználói interakciókat szimulálnak annak ellenőrzésére, hogy az alkalmazás elérhető és rugalmas-e. Javasoljuk, hogy szabványos rendelkezésre állási teszteket állítson be az alkalmazás rendelkezésre állásának figyeléséhez a világ különböző pontjairól, és küldje el saját tesztadatait az Application Insightsnak.

Rendelkezésre állásra vonatkozó mezők:

Mezőnév (Application Insights)	Mezőnév (Naplóelemzés)	Leírás
id	Id	A rendelkezésre állási teszt eredményének egyedi azonosítója, amelyet az egyes tesztvégrehajtások közötti korrelációhoz használnak, amely segíthet az adott hibák vagy minták időbeli nyomon követésében. További információ: Telemetria-korreláció az Application Insightsban.
name	Name	Egy rendelkezésre állási teszt neve. Ez a teszt létrehozásakor van definiálva (például "Kezdőlap pingelési teszt").
location	Location	Az a földrajzi hely vagy adatközponti régió, amelyből rendelkezésre állási tesztet hajtottak végre (például az USA nyugati régiója, Észak-Európa). Segít azonosítani a regionális kimaradások vagy késési problémákat.
success	Success	Ez a mező azt jelzi, hogy egy rendelkezésre állási teszt sikeres volt-e. Logikai érték, amely true azt jelenti, hogy a teszt sikeres volt, és false azt jelenti, hogy sikertelen volt.
message	Message	Egy leíró üzenet a teszt eredményével kapcsolatos részletekkel. Gyakran tartalmaz kivételadatokat vagy hibaválaszokat.
duration	Duration	A rendelkezésre állási teszt végrehajtásának időtartama. Segít a teljesítmény mérésében és a válaszidővel kapcsolatos problémák azonosításában. Az időtartamot általában ezredmásodpercben mérik.

Az összes elérhető mező listáját az AppAvailabilityResults című témakörben találja.

Böngésző időzítési telemetriai adatai

A böngészők a Performance API-val teszik elérhetővé az oldalbetöltési műveletek mérését. Az Application Insights leegyszerűsíti ezeket a méréseket a kapcsolódó időzítések standard böngészőmetrikákba való összevonásával.

Böngésző-időzítés-specifikus mezők:

Mezőnév (Alkalmazás-elemzések)	Mezőnév (Naplóelemzés)	Leírás
networkDuration	NetworkDurationMs	Az ügyfél a DNS-hez érkezik a webhely állomásnevének feloldásához, és a DNS az IP-címmel válaszol. Az ügyfél TCP- és TLS-kézfogásokat kezdeményez a webkiszolgálóval.
sendDuration	SendDurationMs	Az ügyfél kérési adatcsomagot küld, megvárja, amíg a kiszolgáló végrehajtja a kérést, és megkapja az első válaszcsomagot.
receiveDuration	ReceiveDurationMs	Az ügyfél megkapja a válasz többi hasznos adatbájtját a webkiszolgálótól.
processingDuration	ProcessingDurationMs	A kliens most már megkapta a teljes válaszadatot, és meg kell jelenítenie a tartalmat a böngészőben, valamint be kell töltenie a DOM-ot.
totalDuration	TotalDurationMs	Az összes böngészőidőzítés összege.

Az összes elérhető mező listáját az AppBrowserTimingsben találja.

Függőségi telemetria

A függőségi telemetriaelemek a figyelt összetevő és egy távoli összetevő, például az SQL vagy a HTTP-végpont közötti interakciót jelölik.

Függőségspecifikus mezők:

Mezőnév (Alkalmazás-elemzések)	Mezőnév (Naplóelemzés)	Leírás
id	Id	A függőségi híváspéldány egyedi azonosítója, amely 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 Application Insightsban.
target	Target	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 Application Insightsban.
type	DependencyType	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.
name	Name	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.
data	Data	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.
success	Success	Ez a mező azt jelzi, hogy egy hívás sikeres volt-e vagy sem. Logikai érték, amely true azt jelenti, hogy a hívás sikeres volt, és false azt jelenti, hogy sikertelen volt.
resultCode	ResultCode	Egy függőségi hívás eredménykódja. Ilyen például az SQL-hibakód és a HTTP-állapotkód.
duration	DurationMs	A kérelem időtartama formátuma DD.HH:MM:SS.MMMMMM. Napnál 1000 rövidebbnek kell lennie.

Az összes elérhető mező listáját az AppDependencies című témakörben találja.

Eseménytelemetria

Eseménytelemetriaelemeket hozhat létre, amelyek az alkalmazásban történt eseményeket jelölik. 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.

Az egyéni eseménytelemetria létrehozásáról további információt az Azure Monitor OpenTelemetry hozzáadása és módosítása .NET-, Java-, Node.js- és Python-alkalmazásokhoz című témakörben talál.

Eseményspecifikus mezők:

Mezőnév (Application Insights)	Mezőnév (Naplóelemzés)	Leírás
name	Name	A megfelelő csoportosítás és hasznos metrikák elérése érdekében korlátozza az alkalmazást, hogy csak néhány különálló eseménynév keletkezzen. Ne használjon például külön nevet az esemény minden létrehozott példányához.

Az összes elérhető mező listáját az AppEventsben találja.

Kivételtelemetria

A kivételtelemetriaelem egy kezelt vagy kezeletlen kivételt jelöl, amely a figyelt alkalmazás végrehajtása során történt.

Kivételspecifikus mezők:

Mezőnév (Application Insights)	Mezőnév (Naplóelemzés)	Leírás
problemId	ProblemId	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.
type	ExceptionType	Az adott típusú kivétel, amely történt. Ez általában magában foglalja a névteret és az osztály nevét, például System.NullReferenceException vagy System.InvalidOperationException.
assembly	Assembly	Az összeállítás, ahol a kivételt dobták. Ez hasznos a kivételért felelős alkalmazás összetevőjének rögzítéséhez.
method	Method	A metódus neve az assembly-ben, ahol a kivétel történt. Ez környezeti információkat nyújt arról, hogy a kódban hol történt a hiba.
outerType	OuterType	A külső (burkoló) kivétel típusa, ha az aktuális kivétel egy másik kivételbe van ágyazva. Ez hasznos annak a környezetnek a megértéséhez, amelyben a belső kivétel történt, és segíthet a hibák sorozatának nyomon követésében.
outerMessage	OuterMessage	Ez az üzenet a külső kivétel emberileg olvasható magyarázatát nyújtja, és hasznos lehet a szélesebb körű probléma megértésében.
outerAssembly	OuterAssembly	Az az összeállítás, amelyből a külső kivétel származik.
outerMethod	OuterMethod	A külső kivétel metódusa. Ez részletes információkat nyújt a külső kivételen belüli meghibásodási pontról.
severityLevel	SeverityLevel	A nyomkövetés súlyossági szintje a következő értékek egyike lehet: Verbose, Information, , Warning, Errorvagy Critical.
details	Details	Olyan kivételadatokat tartalmaz, mint a kivételüzenet és a hívásverem.

Az összes elérhető mező listáját az AppExceptionsben találja.

Metrika telemetria

Az Application Insights kétféle metrikatelemetriát támogat:

• Egyetlen mérésnekvan neve és értéke.
• Az előre csoportosított metrikák több mérést is végeznek egy 1 perces összesítési időszakban.

Teljesítmény számlálók

A teljesítményszámlálók mindig egyszeres mérési metrikák name-vel és value-vel, de tartalmaznak további mezőket, mint például category és counter, valamint a Windows alkalmazásoknál instance is megtalálhatók.

Teljesítményszámláló-specifikus mezők:

Mezőnév (Application Insights)	Mezőnév (Naplóelemzés)	Leírás
name	Name	Annak a metrikanak a neve, amelyet látni szeretne az Application Insights portálon.
value	Value	A mérés egyetlen értéke. Ez az összesítés egyedi méréseinek összege.
category	Category	A kapcsolódó teljesítményszámlálók csoportját jelöli (például Process).
counter	Counter	Megadja a kategórián belül mért adott teljesítménymetrikát (például IO Data Bytes/sec).
instance	Instance	Egy számláló adott előfordulását azonosítja egy kategórián belül (például ??APP_WIN32_PROC??).

Az összes elérhető mező listáját az AppPerformanceCounters című témakörben találja.

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

Rendszer- és folyamatszámláló metrikák

.NET-név	Leírás
\Processor(_Total)\% Processor Time	Teljes gépi PROCESSZOR.
\Memory\Available Bytes	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	Az alkalmazást üzemeltető folyamat processzora.
\Process(??APP_WIN32_PROC??)\Private Bytes	Az alkalmazást üzemeltető folyamat által használt memória.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Az alkalmazást üzemeltető folyamat által futtatott I/O-műveletek sebessége.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Az alkalmazás által feldolgozott kérelmek aránya.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Az alkalmazás által kidobott kivételek aránya.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	A kérelmek átlagos végrehajtási ideje.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	A várólistán a feldolgozásra váró kérelmek száma.

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.

Egyedi metrikák

Az egyéni metrikák teljesítménymutatók vagy üzletspecifikus metrikák, amelyeket ön definiál és gyűjt, hogy olyan megállapításokat nyerjen, amelyeket nem fednek le a standard metrikák. Az egyéni metrikákkal kapcsolatos további információkért tekintse meg az Egyéni metrikákat az Azure Monitorban (előzetes verzió).

Egyéni metrikaspecifikus mezők:

Mezőnév (Application Insights)	Mezőnév (Naplóelemzés)	Egyetlen mérés	Előre csoportosított metrika
name	Name	Ez a mező annak a metrikanak a neve, amelyet látni szeretne az Application Insights portálon és a felhasználói felületen.
value	Value	Ez a mező a mérés egyetlen értéke. Ez az összesítés egyedi méréseinek összege.	Egy előre összegzett metrika esetében az Értékösszeggel egyenlő.
Max	Max	Egyetlen mérési metrika esetén a Maximálisérték egyenlő.	Ez a mező az összesített metrika maximális értéke. Nem szabad méréshez beállítani.
Min	Min	Egyetlen mérési metrika esetén a Min egyenlő érték.	Ez a mező az összesített metrika minimális értéke. Nem szabad méréshez beállítani.
Sum	Sum	Egyetlen mérési metrika esetén a Sum értéke érték.	Az összesített metrika összes értékének összege. Nem szabad méréshez beállítani.
Count	Count	Egyetlen mérési metrika esetén a Darabszám a 1.	A mérések száma egy 1 perces összesítési időszakban. Nem szabad méréshez beállítani.

Az összes elérhető mező listáját az AppMetricsban találja.

Feljegyzés

Az átlag kiszámításához ossza el a Sum by Count értéket.

Oldalnézet telemetriai adatai

A rendszer naplózza az oldalnézet telemetriáját, 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.

Lapnézet-specifikus mezők:

Mezőnév (Alkalmazásfigyelés)	Mezőnév (Naplóelemzés)	Leírás
name	Name	A felhasználó által megtekintett lap neve (például "Home""Shopping Cart").
url	Url	A megtekintett oldal teljes URL-címe. Ez a mező kulcsfontosságú az alkalmazás forgalmának és felhasználói viselkedésének elemzéséhez.
duration	DurationMs	Az PageView időtartam a böngésző teljesítmény-időzítési felületéről származik. PerformanceNavigationTiming.duration Ha PerformanceNavigationTiming elérhető, a rendszer ezt az időtartamot használja. Ha nem, akkor a rendszer az elavultPerformanceTiming felületet használja, és kiszámítja a különbséget a kettő között.NavigationStartLoadEventEnd A fejlesztő az egyéni PageView események trackPageView API-hívással történő naplózásakor meghatároz egy időtartamértéket.

Az összes elérhető mező listáját az AppPageViewsban találja.

Feljegyzés

• Az Application Insights JavaScript SDK alapértelmezés szerint naplózza az egyes PageView eseményeket minden böngészőoldal betöltésekor, a pageViews.duration pedig a böngésző időzítés alapján kerül kitöltésre. 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.

Telemetria kérése

A kérelemtelemetria az alkalmazáshoz beérkező HTTP-kérésekkel kapcsolatos információkat jelöli. Az ilyen típusú telemetriai adatok segítségével nyomon követheti az alkalmazás webes szolgáltatásainak teljesítményét és sikerességét. A kérelemtelemetriaelem az alkalmazáshoz küldött külső kérés által aktivált végrehajtás logikai sorrendjét jelöli. 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 successkódot eredményezhet fail vagy duration 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 a szabványos kiterjeszthetőségi modellt támogatja a testreszabott properties és measurements használatával.

Kérelemspecifikus mezők:

Mezőnév (Application Insights)	Mezőnév (Naplóelemzés)	Leírás
id	Id	A kérelemhívási példány egyedi azonosítója, amely a kérés és más telemetriaelemek 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 Application Insightsban.
source	Source	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 Application Insightsban.
name	Name	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 Application Insights webes SDK a levélesetről "ahogy van" 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.
url	Url	Az URL az a kérés URL-címe, amely az összes lekérdezési sztringparamétert tartalmazza.
success	Success	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 Application Insights sikeresként definiál egy 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 301 jelezze a 302 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 Application Insights-végpont egyetlen kéréské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.
resultCode	ResultCode	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.
duration	DurationMs	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.

Az összes elérhető mező listáját az AppRequestsben találja.

Nyomkövetési telemetria

A nyomkövetési telemetria printf stílusú nyomkövetési utasításokat jelöl, amelyek szöveges keresés alapján találhatók meg. 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.

Nyomkövetési mezők:

Mezőnév (Alkalmazás Elemzések)	Mezőnév (Naplóelemzés)	Leírás
message	Message	Nyomkövetési üzenet.
severityLevel	SeverityLevel	Nyomkövetés súlyossági szintje.

Az összes elérhető mező listáját az AppTracesben találja.

Feljegyzés

severityLevel Az értékek számba vannak írva és platformspecifikusak.

Egyéni tulajdonságok és mérések

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

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.

Mezőnév (Alkalmazás Elemzések)	Mezőnév (Naplóelemzés)	Leírás
account_ID	user_AccountId	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.
application_Version	AppVersion	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.
appId	ResourceGUID	Az Application Insights-erőforrás egyedi azonosítója, amely megkülönbözteti a telemetriát a különböző alkalmazásoktól.
appName	Nincs adat.	Az Application Insightsban appName ugyanaz, mint _ResourceId.
client_Browser	ClientBrowser	Az ügyfél által használt webböngésző neve.
client_City	ClientCity	Az a város, ahol az ügyfél található a telemetriai adatok gyűjtésekor (az IP-földrajzi hely alapján).
client_CountryOrRegion	ClientCountryOrRegion	Az az ország vagy régió, ahol az ügyfél található a telemetriai adatok gyűjtésekor (az IP-földrajzi hely alapján).
client_IP	ClientIP	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 Application Insights kinyeri a földrajzi hely adatait az ügyfél IP-címéből, majd csonkolja. Az ügyfél IP-címe önmagában nem használható felhasználóazonosításra alkalmas információként.
client_OS	ClientOS	A telemetriát létrehozó ügyfél operációs rendszerét jelzi.
client_StateorProvince	ClientStateOrProvince	Az az állam vagy tartomány, ahol az ügyfél a telemetriai adatok gyűjtésekor (az IP-helymeghatározás alapján) található.
client_Type	ClientType	A telemetriát küldő ügyféleszköz típusát ismerteti (például BrowserPC.)
cloud_RoleInstance	AppRoleInstance	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.
cloud_RoleName	AppRoleName	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.
iKey	IKey	Régi egyedi azonosító, amellyel telemetriai adatokat társíthat egy adott Application Insights-erőforráshoz.
itemId	Nincs adat.	Egy adott telemetriai elem egyedi azonosítója.
itemCount	ItemCount	Az egyetlen telemetriai eseményhez társított előfordulások vagy számok száma.
operation_Id	OperationId	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.
operation_Name	OperationName	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?
operation_ParentId	ParentId	A telemetriai elem közvetlen szülőjének egyedi azonosítója. További információ: Telemetriai korreláció.
operation_SyntheticSource	SyntheticSource	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 tárakból származó nyomkövetéseket, mint maga az Application Insights SDK.
sdkVersion	SDKVersion	A telemetriai adatokat küldő Application Insights SDK verziója. További információ: SDK-verzió.
session_Id	SessionId	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.
user_AuthenticatedId	UserAuthenticatedId	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 Application Insights 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 böngészőkben és 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.
user_Id	UserId	A névtelen felhasználói azonosító 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. 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.
_ResourceId	_ResourceId	Az Application Insights összetevő teljes Azure-erőforrás-azonosítója, amely tartalmazza az előfizetést, az erőforráscsoportot és az erőforrásnevet.

Következő lépések

• Gyakori kérdések áttekintése (GYIK): Telemetriai adatmodell – gyakori kérdések
• Tekintse meg az Application Insights által támogatott platformokat .
• Megtudhatja, hogyan gyűjthet egyéni telemetriát az Azure Monitor OpenTelemetry Distro használatával.
• Megtudhatja, hogyan használhatja az Application Insights API-t egyéni eseményekhez és metrikákhoz.
• Ismerje meg, hogyan terjesztheti ki és szűrheti a telemetriát.
• Megtudhatja, hogyan használhat mintavételezést az adatmodellen alapuló telemetriai adatok mennyiségének minimalizálásához.