Datový model telemetrie Application Insights

Aplikace Přehledy odesílá telemetrii z webové aplikace na web Azure Portal, abyste mohli analyzovat výkon a využití aplikace. Model telemetrie je standardizovaný, takže je možné vytvořit monitorování nezávislé na platformě a jazyce.

Data shromážděná aplikací Přehledy modelují tento typický vzor provádění aplikací.

K monitorování provádění vaší aplikace se používají následující typy telemetrie. Sada Application Přehledy SDK z architektury webových aplikací automaticky shromažďuje tyto tři typy:

• Požadavek: Vygenerováno za účelem protokolování požadavku přijatého vaší aplikací. Například sada Application Přehledy web SDK automaticky vygeneruje položku telemetrie požadavku pro každý požadavek HTTP, který vaše webová aplikace přijímá.

  Operace se skládá z vláken provádění, která zpracovávají požadavek. Můžete také napsat kód pro monitorování jiných typů operací, například "probuzení" ve webové úloze nebo funkci, která pravidelně zpracovává data. Každá operace má ID. ID se dá použít k seskupení všech telemetrických dat vygenerovaných během zpracování požadavku vaší aplikace. Každá operace je úspěšná nebo neúspěšná a má dobu trvání.

• Výjimka: Obvykle představuje výjimku, která způsobuje selhání operace.

• Závislost: Představuje volání z vaší aplikace do externí služby nebo úložiště, jako je rozhraní REST API nebo SQL. V ASP.NET jsou volání závislostí sql definována .System.Data Volání koncových bodů HTTP jsou definována .System.Net

Aplikační Přehledy poskytuje tři datové typy pro vlastní telemetrii:

• Trasování: Používá se buď přímo, nebo prostřednictvím adaptéru k implementaci protokolování diagnostiky pomocí architektury instrumentace, která je pro vás známá, například Log4Net nebo System.Diagnostics.
• Událost: Obvykle se používá k zaznamenání interakce uživatelů s vaší službou za účelem analýzy vzorů využití.
• Metrika: Používá se k hlášení pravidelných skalárních měření.

Každá položka telemetrie může definovat kontextové informace , jako je verze aplikace nebo ID relace uživatele. Kontext je sada polí silného typu, která odblokují určité scénáře. Pokud je verze aplikace správně inicializována, aplikace Přehledy dokáže detekovat nové vzory v chování aplikace, které korelují s opětovným nasazením.

ID relace můžete použít k výpočtu výpadku nebo dopadu problému na uživatele. Výpočet jedinečného počtu hodnot ID relace pro konkrétní neúspěšnou závislost, trasování chyb nebo kritickou výjimku vám poskytne dobrý přehled o dopadu.

Model telemetrie Přehledy aplikace definuje způsob, jak korelovat telemetrii s provozem, jehož součástí je. Požadavek může například volat a zaznamenávat diagnostické informace o službě SQL Database. Kontext korelace můžete nastavit pro tyto položky telemetrie, které je spojují s telemetrií požadavku.

Vylepšení schématu

Datový model Přehledy aplikace představuje základní, ale výkonný způsob modelování telemetrie aplikace. Snažíme se, aby model byl jednoduchý a tenký, aby podporoval základní scénáře a umožnili rozšíření schématu pro pokročilé použití.

K hlášení problémů s datovým modelem nebo schématem a návrhů použijte úložiště GitHub.

Požádat

Položka telemetrie požadavku v aplikaci Přehledy představuje logickou posloupnost spuštění aktivovanou externím požadavkem vaší aplikace. Každé spuštění požadavku je identifikováno jedinečným id a url obsahujícím všechny parametry spuštění.

Požadavky můžete seskupit podle logických name hodnot a definovat source tento požadavek. Provádění kódu může vést k success určitému výsledku nebo fail k určitému duration. Provádění úspěšných a neúspěšných selhání můžete dále seskupit pomocí příkazu resultCode. Počáteční čas telemetrie požadavku je definován na úrovni obálky.

Vyžádání telemetrie podporuje standardní model rozšiřitelnosti pomocí vlastních properties a measurements.

Poznámka:

Podpora příjmu dat založeného na instrumentačním klíči skončí 31. března 2025. Příjem klíčů instrumentace bude dál fungovat, ale už nebudeme poskytovat aktualizace ani podporu pro tuto funkci. Přechod na připojovací řetězec, abyste mohli využívat nové funkce.

Název

Toto pole je název požadavku a představuje cestu kódu, která se má zpracovat. Hodnota nízké kardinality umožňuje lepší seskupení požadavků. Pro požadavky HTTP představuje metodu HTTP a šablonu cesty URL, jako je GET /values/{id} bez skutečné id hodnoty.

Webová sada SDK Přehledy aplikace odešle název požadavku "tak, jak je" o písmenu. Seskupování v uživatelském rozhraní se rozlišují malá a velká písmena, proto GET /Home/Index se počítá odděleně od GET /home/INDEX toho, že často vedou ke stejnému kontroleru a provádění akcí. Důvodem je, že adresy URL obecně rozlišují malá a velká písmena. Možná budete chtít zjistit, jestli u adres URL zadaných velkými písmeny došlo k chybám 404 . Další informace o kolekci názvů požadavků najdete v ASP.NET webové sadě SDK v blogovém příspěvku.

Maximální délka: 1 024 znaků

ID

ID je identifikátor instance volání požadavku. Používá se k korelaci mezi požadavkem a dalšími položkami telemetrie. ID by mělo být globálně jedinečné. Další informace najdete v tématu Korelace telemetrie v Přehledy aplikace.

Maximální délka: 128 znaků

Adresa URL

Adresa URL je adresa URL požadavku se všemi parametry řetězce dotazu.

Maximální délka: 2 048 znaků

Source

Zdrojem je zdroj požadavku. Příkladem je instrumentační klíč volajícího nebo IP adresa volajícího. Další informace najdete v tématu Korelace telemetrie v Přehledy aplikace.

Maximální délka: 1 024 znaků

Doba trvání

Doba trvání požadavku je formátována jako DD.HH:MM:SS.MMMMMM. Musí to být kladné a menší než 1000 dny. Toto pole je povinné, protože telemetrie požadavku představuje operaci se začátkem a koncem.

Kód odpovědi

Kód odpovědi je výsledkem spuštění požadavku. Jedná se o stavový kód HTTP pro požadavky HTTP. Může to být HRESULT hodnota nebo typ výjimky pro jiné typy požadavků.

Maximální délka: 1 024 znaků

Success

Úspěch označuje, zda bylo volání úspěšné nebo neúspěšné. Toto pole je povinné. Pokud požadavek není explicitně falsenastavený, považuje se za úspěšný. Pokud výjimka nebo vrácený kód výsledku chyby přerušil operaci, nastavte tuto hodnotu na false.

U webových aplikací aplikace Přehledy definuje požadavek jako úspěšný, pokud je kód odpovědi menší nebo 400 roven 401. Existují však případy, kdy toto výchozí mapování neodpovídá sémantice aplikace.

Kód 404 odpovědi může znamenat "žádné záznamy", což může být součástí běžného toku. Může také naznačovat nefunkční odkaz. U nefunkčních odkazů můžete implementovat pokročilejší logiku. Přerušené odkazy můžete označit jako selhání pouze v případě, že se tyto odkazy nacházejí na stejném webu analýzou refereru adresy URL. Nebo je můžete označit jako selhání při přístupu z mobilní aplikace společnosti. Podobně a 302 indikujte selhání, 301 když se k nim přistupuje z klienta, který nepodporuje přesměrování.

Částečně přijatý obsah 206 může znamenat selhání celkového požadavku. Koncový bod Přehledy aplikace může například přijímat dávku položek telemetrie jako jeden požadavek. Vrátí 206 se, když se některé položky v dávce nezpracovaly úspěšně. Rostoucí míra 206 značí problém, který je potřeba prošetřit. Podobná logika se vztahuje na 207 více stavů, kde úspěch může být nejhorší ze samostatných kódů odpovědí.

Uživatelské vlastnosti

Kolekce vlastních vlastností s hodnotou názvu: Tato kolekce se používá k rozšíření standardní telemetrie s vlastními dimenzemi. Příkladem je slot nasazení, který vytvořil telemetrii nebo vlastnost specifickou pro položku telemetrie, jako je číslo objednávky.

• Maximální délka klíče: 150
• Maximální délka hodnoty: 8 192

Vlastní měření

Kolekce vlastních měření: Tato kolekce slouží k hlášení pojmenovaných měření přidružených k položce telemetrie. Mezi obvyklé případy použití patří:

• Velikost datové části telemetrie závislostí
• Počet položek fronty zpracovaných telemetrií požadavku.
• Čas dokončení kroku průvodce dokončením telemetrie událostí.

Vlastní měření můžete dotazovat v Application Analytics:

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

Poznámka:

• Vlastní měření jsou přidružená k položce telemetrie, do které patří. Podléhají vzorkování s položkou telemetrie, která obsahuje tato měření. Pokud chcete sledovat měření, které má hodnotu nezávislou na jiných typech telemetrie, použijte telemetrii metrik.
• Nepoužívejte řetězcové hodnoty pro vlastní měření. Podporují se jenom číselné hodnoty.

Maximální délka klíče: 150

Dependency

Telemetrie závislostí (v application Přehledy) představuje interakci monitorované komponenty se vzdálenou komponentou, jako je SQL nebo koncový bod HTTP.

Název

Toto pole je název příkazu iniciovaného tímto voláním závislosti. Má nízkou hodnotu kardinality. Příklady jsou název uložené procedury a šablona cesty url.

ID

ID je identifikátor instance volání závislosti. Používá se k korelaci s položkou telemetrie požadavku, která odpovídá tomuto volání závislosti. Další informace najdete v tématu Korelace telemetrie v Přehledy aplikace.

Data

Toto pole je příkaz iniciovaný tímto voláním závislosti. Příklady jsou příkaz SQL a adresa URL HTTP se všemi parametry dotazu.

Typ

Toto pole je název typu závislosti. Má nízkou hodnotu kardinality pro logické seskupení závislostí a interpretaci jiných polí jako commandName a resultCode. Příklady jsou SQL, tabulka Azure a HTTP.

Cíl

Toto pole je cílový web volání závislostí. Příklady jsou název serveru a adresa hostitele. Další informace najdete v tématu Korelace telemetrie v Přehledy aplikace.

Doba trvání

Doba trvání požadavku je ve formátu DD.HH:MM:SS.MMMMMM. Musí to být méně než 1000 dny.

Kód výsledku

Toto pole je kód výsledku volání závislosti. Příklady jsou kód chyby SQL a stavový kód HTTP.

Success

Toto pole označuje úspěšné nebo neúspěšné volání.

Uživatelské vlastnosti

Kolekce vlastních vlastností s hodnotou názvu: Tato kolekce se používá k rozšíření standardní telemetrie s vlastními dimenzemi. Příkladem je slot nasazení, který vytvořil telemetrii nebo vlastnost specifickou pro položku telemetrie, jako je číslo objednávky.

• Maximální délka klíče: 150
• Maximální délka hodnoty: 8 192

Vlastní měření

Kolekce vlastních měření: Tato kolekce slouží k hlášení pojmenovaných měření přidružených k položce telemetrie. Mezi obvyklé případy použití patří:

• Velikost datové části telemetrie závislostí
• Počet položek fronty zpracovaných telemetrií požadavku.
• Čas dokončení kroku průvodce dokončením telemetrie událostí.

Vlastní měření můžete dotazovat v Application Analytics:

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

Poznámka:

• Vlastní měření jsou přidružená k položce telemetrie, do které patří. Podléhají vzorkování s položkou telemetrie, která obsahuje tato měření. Pokud chcete sledovat měření, které má hodnotu nezávislou na jiných typech telemetrie, použijte telemetrii metrik.
• Nepoužívejte řetězcové hodnoty pro vlastní měření. Podporují se jenom číselné hodnoty.

Maximální délka klíče: 150

Výjimka

V aplikaci Přehledy představuje instance výjimky popisovanou nebo neošetřenou výjimku, ke které došlo během provádění monitorované aplikace.

ID problému

ID problému identifikuje, kde došlo k výjimce v kódu. Používá se pro seskupení výjimek. Obvykle se jedná o kombinaci typu výjimky a funkce ze zásobníku volání.

Maximální délka: 1 024 znaků

Úroveň závažnosti

Toto pole je úroveň závažnosti trasování. Hodnota může být Verbose, , InformationWarning, Errornebo Critical.

Podrobnosti výjimky

(Chcete-li být prodlouženi)

Uživatelské vlastnosti

Kolekce vlastních vlastností s hodnotou názvu: Tato kolekce se používá k rozšíření standardní telemetrie s vlastními dimenzemi. Příkladem je slot nasazení, který vytvořil telemetrii nebo vlastnost specifickou pro položku telemetrie, jako je číslo objednávky.

• Maximální délka klíče: 150
• Maximální délka hodnoty: 8 192

Vlastní měření

Kolekce vlastních měření: Tato kolekce slouží k hlášení pojmenovaných měření přidružených k položce telemetrie. Mezi obvyklé případy použití patří:

• Velikost datové části telemetrie závislostí
• Počet položek fronty zpracovaných telemetrií požadavku.
• Čas dokončení kroku průvodce dokončením telemetrie událostí.

Vlastní měření můžete dotazovat v Application Analytics:

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

Poznámka:

• Vlastní měření jsou přidružená k položce telemetrie, do které patří. Podléhají vzorkování s položkou telemetrie, která obsahuje tato měření. Pokud chcete sledovat měření, které má hodnotu nezávislou na jiných typech telemetrie, použijte telemetrii metrik.
• Nepoužívejte řetězcové hodnoty pro vlastní měření. Podporují se jenom číselné hodnoty.

Maximální délka klíče: 150

Trasování

Telemetrie trasování v aplikaci Přehledy představuje printfpříkazy trasování stylu, které jsou prohledány textem. Log4Net, NLoga další textové položky souboru protokolu jsou přeloženy do instancí tohoto typu. Trasování nemá měření jako rozšiřitelnost.

Message

Zpráva trasování

Maximální délka: 32 768 znaků

Úroveň závažnosti

Úroveň závažnosti trasování

Hodnoty:Verbose, Information, Warning, Errora Critical

Uživatelské vlastnosti

Kolekce vlastních vlastností s hodnotou názvu: Tato kolekce se používá k rozšíření standardní telemetrie s vlastními dimenzemi. Příkladem je slot nasazení, který vytvořil telemetrii nebo vlastnost specifickou pro položku telemetrie, jako je číslo objednávky.

• Maximální délka klíče: 150
• Maximální délka hodnoty: 8 192

Událost

Můžete vytvořit položky telemetrie událostí (v aplikaci Přehledy), které představují událost, ke které došlo ve vaší aplikaci. Obvykle se jedná o interakci uživatele, například kliknutí na tlačítko nebo rezervaci objednávky. Může to být také událost životního cyklu aplikace, jako je inicializace nebo aktualizace konfigurace.

Sémanticky můžou nebo nemusí být události korelovány s požadavky. Pokud se používá správně, je telemetrie událostí důležitější než požadavky nebo trasování. Události představují obchodní telemetrii a měly by podléhat oddělenému, méně agresivnímu vzorkování.

Název

Název události: Pokud chcete povolit správné seskupení a užitečné metriky, omezte aplikaci tak, aby vygenerovala několik samostatných názvů událostí. Například nepoužívejte samostatný název pro každou vygenerovanou instanci události.

Maximální délka: 512 znaků

Uživatelské vlastnosti

Kolekce vlastních vlastností s hodnotou názvu: Tato kolekce se používá k rozšíření standardní telemetrie s vlastními dimenzemi. Příkladem je slot nasazení, který vytvořil telemetrii nebo vlastnost specifickou pro položku telemetrie, jako je číslo objednávky.

• Maximální délka klíče: 150
• Maximální délka hodnoty: 8 192

Vlastní měření

Kolekce vlastních měření: Tato kolekce slouží k hlášení pojmenovaných měření přidružených k položce telemetrie. Mezi obvyklé případy použití patří:

• Velikost datové části telemetrie závislostí
• Počet položek fronty zpracovaných telemetrií požadavku.
• Čas dokončení kroku průvodce dokončením telemetrie událostí.

Vlastní měření můžete dotazovat v Application Analytics:

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

Poznámka:

• Vlastní měření jsou přidružená k položce telemetrie, do které patří. Podléhají vzorkování s položkou telemetrie, která obsahuje tato měření. Pokud chcete sledovat měření, které má hodnotu nezávislou na jiných typech telemetrie, použijte telemetrii metrik.
• Nepoužívejte řetězcové hodnoty pro vlastní měření. Podporují se jenom číselné hodnoty.

Maximální délka klíče: 150

Metrika

Aplikační Přehledy podporuje dva typy telemetrie metrik: jedno měření a předem agregované metriky. Jedno měření je jen název a hodnota. Předem agregovaná metrika určuje minimální a maximální hodnotu metriky v agregačním intervalu a směrodatnou odchylku metriky.

Předagregovaná telemetrie metrik předpokládá, že agregační období bylo jedna minuta.

Aplikační Přehledy podporuje několik známých názvů metrik. Tyto metriky se umístí do performanceCounters tabulky.

Následující tabulka ukazuje metriky, které představují čítače systému a procesů.

Název .NET	Název nezávislý na platformě	Popis
\Processor(_Total)\% Processor Time	Probíhá práce...	Celkový počet procesorů počítače.
\Memory\Available Bytes	Probíhá práce...	Zobrazuje množství fyzické paměti v bajtech, které jsou dostupné procesům spuštěným v počítači. Vypočítá se součtem místa v nulovaných, volných a pohotovostních seznamech paměti. Volná paměť je připravená k použití. Nulová paměť se skládá ze stránek paměti naplněných nulami, aby se zabránilo pozdějším procesům zobrazování dat používaných předchozím procesem. Pohotovostní paměť je paměť, která byla odebrána z pracovní sady procesu (její fyzická paměť) na disku, ale je stále k dispozici k odvolání. Viz objekt paměti.
\Process(??APP_WIN32_PROC??)\% Processor Time	Probíhá práce...	Procesor procesu hostujícího aplikaci.
\Process(??APP_WIN32_PROC??)\Private Bytes	Probíhá práce...	Paměť používaná procesem hostujícím aplikaci.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Probíhá práce...	Rychlost vstupně-výstupních operací spuštěných procesem, který je hostitelem aplikace.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Probíhá práce...	Rychlost požadavků zpracovaných aplikací
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Probíhá práce...	Rychlost výjimek vyvolaných aplikací
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Probíhá práce...	Průměrná doba provádění požadavků
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Probíhá práce...	Počet požadavků čekajících na zpracování ve frontě

Další informace o rozhraní REST API metrik najdete v tématu Metriky – Získání.

Název

Toto pole je název metriky, kterou chcete zobrazit na portálu Přehledy aplikace a v uživatelském rozhraní.

Hodnota

Toto pole je jedna hodnota pro měření. Jedná se o součet jednotlivých měření agregace.

Počet

Toto pole je váha metriky agregované metriky. Nemělo by být nastaveno pro měření.

Min.

Toto pole je minimální hodnota agregované metriky. Nemělo by být nastaveno pro měření.

Maximum

Toto pole je maximální hodnota agregované metriky. Nemělo by být nastaveno pro měření.

Směrodatná odchylka

Toto pole je směrodatná odchylka agregované metriky. Nemělo by být nastaveno pro měření.

Uživatelské vlastnosti

Metrika s vlastní sadou true vlastností CustomPerfCounter označuje, že metrika představuje čítač výkonu Windows. Tyto metriky jsou umístěny v performanceCounters tabulce, nikoli v customMetrics. Název této metriky se také analyzuje za účelem extrakce názvů kategorií, čítačů a instancí.

Kolekce vlastních vlastností s hodnotou názvu: Tato kolekce se používá k rozšíření standardní telemetrie s vlastními dimenzemi. Příkladem je slot nasazení, který vytvořil telemetrii nebo vlastnost specifickou pro položku telemetrie, jako je číslo objednávky.

• Maximální délka klíče: 150
• Maximální délka hodnoty: 8 192

PageView

Telemetrie PageView (v aplikaci Přehledy) se protokoluje, když uživatel aplikace otevře novou stránku monitorované aplikace. V Page tomto kontextu je logická jednotka definovaná vývojářem, která má být kartou aplikace nebo obrazovkou a nemusí nutně korelovat s načtením webové stránky prohlížeče nebo akcí aktualizace. Tento rozdíl lze dále pochopit v kontextu jednostrákových aplikací (SPA), kde přepínání mezi stránkami není svázané s akcemi stránek prohlížeče. Jedná se pageViews.duration o dobu potřebnou k tomu, aby aplikace uživateli představila stránku.

Poznámka:

• Ve výchozím nastavení aplikace Přehledy sady SDK protokolují jednotlivé PageView události na každé akci načítání webové stránky prohlížeče s pageViews.duration vyplněným načasováním prohlížeče. Vývojáři mohou rozšířit další sledování PageView událostí pomocí volání rozhraní API trackPageView.
• Výchozí uchovávání protokolů je 30 dnů. Pokud chcete zobrazit PageView statistiky za delší časové období, musíte nastavení upravit.

Měření browserTimingu v Přehledy aplikace

Moderní prohlížeče zpřístupňují měření pro akce načítání stránek pomocí rozhraní API pro měření výkonu. Aplikační Přehledy zjednodušuje tato měření sloučením souvisejících časování do standardních metrik prohlížeče definovaných těmito definicemi doby zpracování:

• Klient <–> DNS: Klient se dostane k DNS, aby přeložil název hostitele webu, a DNS odpoví IP adresou.

• Klient <–> Webový server: Klient vytvoří PROTOKOL TCP a potom metodu handshakes protokolu TLS s webovým serverem.

• Klient <–> Webový server: Klient odešle datovou část požadavku, čeká na spuštění požadavku serverem a přijme první paket odpovědi.

• Klient <--Webový server: Klient přijímá zbývající bajty datové části odpovědi z webového serveru.

• Klient: Klient má nyní úplnou datovou část odpovědi a musí vykreslit obsah do prohlížeče a načíst DOM.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = č. 3

• browserTimings/receiveDuration = č. 4

• browserTimings/processingDuration = č. 5

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

• pageViews/duration

  • Doba PageView trvání je z rozhraní časování výkonu prohlížeče, PerformanceNavigationTiming.duration.

  • Pokud PerformanceNavigationTiming je k dispozici, použije se tato doba trvání.

    Pokud ne, použije se zastaraléPerformanceTiming rozhraní a rozdíl mezi NavigationStart a LoadEventEnd vypočítá se.

  • Vývojář určuje hodnotu doby trvání při protokolování vlastních PageView událostí pomocí volání rozhraní API trackPageView.

Kontext

Každá položka telemetrie může mít pole kontextu silného typu. Každé pole umožňuje konkrétní scénář monitorování. Pomocí kolekce vlastních vlastností můžete ukládat vlastní kontextové informace nebo kontextové informace specifické pro aplikaci.

Verze aplikace

Informace v kontextových polích aplikace jsou vždy o aplikaci, která odesílá telemetrii. Verze aplikace se používá k analýze změn trendu v chování aplikace a jeho korelaci k nasazením.

Maximální délka: 1 024

IP adresa klienta

Toto pole je IP adresa klientského zařízení. Podporují se adresy IPv4 a IPv6. Při odesílání telemetrie ze služby se kontext umístění týká uživatele, který spustil operaci ve službě. Aplikace Přehledy extrahuje informace o geografickém umístění z IP adresy klienta a pak je zkrátí. IP adresu klienta sama o sobě nejde použít jako identifikovatelné informace uživatele.

Maximální délka: 46

Typ zařízení

Původně se toto pole použilo k označení typu zařízení, které uživatel aplikace používá. Dnes se používá především k rozlišení javascriptové telemetrie s typem Browser zařízení od telemetrie na straně serveru s typem PCzařízení .

Maximální délka: 64

ID operace

Toto pole je jedinečný identifikátor kořenové operace. Tento identifikátor umožňuje seskupování telemetrie mezi více komponentami. Další informace najdete v tématu Korelace telemetrie. ID operace vytvoří žádost nebo zobrazení stránky. Všechna ostatní telemetrická data toto pole nastaví na hodnotu pro obsahující požadavek nebo zobrazení stránky.

Maximální délka: 128

ID nadřazené operace

Toto pole je jedinečný identifikátor bezprostřední nadřazené položky telemetrie. Další informace najdete v tématu Korelace telemetrie.

Maximální délka: 128

Název operace

Toto pole je název (skupina) operace. Název operace vytvoří žádost nebo zobrazení stránky. Všechny ostatní položky telemetrie nastavily toto pole na hodnotu pro obsahující požadavek nebo zobrazení stránky. Název operace slouží k vyhledání všech položek telemetrie pro skupinu operací (například GET Home/Index). Tato kontextová vlastnost slouží k zodpovězení otázek, jako jsou typické výjimky vyvolané na této stránce?

Maximální délka: 1 024

Syntetický zdroj operace

Toto pole je název syntetického zdroje. Některá telemetrie z aplikace můžou představovat syntetický provoz. Může se jednat o indexování webu, testů dostupnosti webu nebo trasování z diagnostických knihoven, jako je samotná sada APPLICATION Přehledy SDK.

Maximální délka: 1 024

ID relace

ID relace je instance interakce uživatele s aplikací. Informace v kontextových polích relace jsou vždy o uživateli. Při odesílání telemetrie ze služby se kontext relace týká uživatele, který spustil operaci ve službě.

Maximální délka: 64

Anonymní ID uživatele

Anonymní ID uživatele (User.Id) představuje uživatele aplikace. Při odesílání telemetrie ze služby se kontext uživatele týká uživatele, který spustil operaci ve službě.

Vzorkování je jednou z technik pro minimalizaci množství shromážděných telemetrických dat. Algoritmus vzorkování se pokusí buď vzorkovat nebo vyfiltrovat veškerou korelovanou telemetrii. Anonymní ID uživatele se používá pro generování skóre vzorkování, takže anonymní ID uživatele by mělo být dostatečná hodnota.

Poznámka:

Počet ID anonymních uživatelů není stejný jako počet jedinečných uživatelů aplikace. Počet ID anonymních uživatelů je obvykle vyšší, protože pokaždé, když uživatel otevře aplikaci na jiném zařízení nebo v jiném prohlížeči, případně vymaže soubory cookie v prohlížeči, přidělí se mu nové jedinečné ID anonymního uživatele. Výsledkem tohoto výpočtu může být počítání stejných fyzických uživatelů vícekrát.

ID uživatelů se dají křížově odkazovat s ID relací, aby poskytovala jedinečné dimenze telemetrie a vytvořila aktivitu uživatelů v průběhu relace.

Použití anonymního ID uživatele k uložení uživatelského jména je zneužití pole. Použijte ověřené ID uživatele.

Maximální délka: 128

Ověřené ID uživatele

Ověřené ID uživatele je opakem anonymního ID uživatele. Toto pole představuje uživatele s popisným názvem. Toto ID se shromažďuje pouze ve výchozím nastavení se sadou SDK AuthenticatedUserIdTelemetryInitializerASP.NET Framework .

Použijte sadu Application Přehledy SDK k inicializaci ověřeného ID uživatele s hodnotou, která uživatele trvale identifikuje napříč prohlížeči a zařízeními. Tímto způsobem jsou všechny položky telemetrie přiřazeny k tomuto jedinečnému ID. Toto ID umožňuje dotazování na veškerou telemetrii shromážděnou pro konkrétního uživatele (v závislosti na konfiguracích vzorkování a filtrování telemetrie).

ID uživatelů se dají křížově odkazovat s ID relací, aby poskytovala jedinečné dimenze telemetrie a vytvořila aktivitu uživatelů v průběhu relace.

Maximální délka: 1 024

ID účtu

ID účtu ve víceklientských aplikacích je ID nebo název účtu tenanta, se kterým uživatel pracuje. Používá se pro větší segmentaci uživatelů, když ID uživatele a ověřené ID uživatele nestačí. Příkladem může být ID předplatného webu Azure Portal nebo název blogu pro platformu pro blogování.

Maximální délka: 1 024

Cloudová role

Toto pole je název role, ve které je aplikace součástí. Mapuje se přímo na název role v Azure. Dá se také použít k rozlišení mikroslužeb, které jsou součástí jedné aplikace.

Maximální délka: 256

Instance cloudové role

Toto pole je název instance, ve které je aplikace spuštěná. Jedná se například o název počítače pro místní prostředí nebo název instance Pro Azure.

Maximální délka: 256

Interní: Verze sady SDK

Další informace najdete v tématu Verze sady SDK.

Maximální délka: 64

Interní: Název uzlu

Toto pole představuje název uzlu používaný pro účely fakturace. Slouží k přepsání standardní detekce uzlů.

Maximální délka: 256

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Jak změřím dopad monitorovací kampaně?

Telemetrie PageView obsahuje adresu URL a parametr UTM můžete parsovat pomocí funkce regex v Kusto.

V některých případech můžou tato data chybět nebo nepřesná, pokud uživatel nebo podnik zakáže odesílání uživatelského agenta v nastavení prohlížeče. Regulární výrazy analyzátoru UA nemusí obsahovat všechny informace o zařízení. Nebo aplikace Přehledy nemusí přijmout nejnovější aktualizace.

Proč by vlastní měření proběhlo bez chyby, ale protokol se nezobrazuje?

K tomu může dojít, pokud používáte řetězcové hodnoty. Vlastní měření fungují jenom s číselnými hodnotami.

Další kroky

Naučte se používat rozhraní API Přehledy aplikace pro vlastní události a metriky, včetně následujících:

• Vlastní telemetrie požadavků
• Vlastní telemetrie závislostí
• Vlastní telemetrie trasování
• Vlastní telemetrie událostí
• Vlastní telemetrie metrik

Nastavení sledování závislostí pro:

• .NET
• Java

Další informace najdete v tématech:

• Podívejte se na platformy podporované Přehledy aplikací.
• Zkontrolujte konfiguraci kolekce standardních kontextových vlastností.
• Prozkoumejte protokoly trasování .NET v Přehledy aplikace.
• Prozkoumejte protokoly trasování Java v Přehledy aplikace.
• Seznamte se s integrovanou integrací Azure Functions s application Přehledy pro monitorování provádění funkcí.
• Zjistěte, jak nakonfigurovat aplikaci ASP.NET Core pomocí Přehledy aplikací.
• Zjistěte, jak diagnostikovat výjimky ve webových aplikacích pomocí služby Application Přehledy.
• Zjistěte, jak rozšířit a filtrovat telemetrii.
• Použití vzorkování k minimalizaci množství telemetrie na základě datového modelu.