Datový model telemetrie Application Insights
Application Insights odesílá telemetrii z vaší webové aplikace na web Azure Portal, abyste mohli analyzovat výkon a využití vaší aplikace. Model telemetrie je standardizovaný, takže je možné vytvořit monitorování nezávislé na platformě a jazyce.
Data shromážděná modely Application Insights 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 Insights 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í. Webová sada SDK Application Insights například 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
Application Insights 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
neboSystem.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, Application Insights 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 Application Insights 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 Application Insights je 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.
Žádost
Položka telemetrie požadavku v Application Insights 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 služby Application Insights 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 Application Insights.
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ů
Zdroj
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 Application Insights.
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ě false
nastavený, 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
.
Pro webové aplikace Application Insights 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 Application Insights 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 Insights) 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 Application Insights.
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 Application Insights.
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 Application Insights instance výjimky představuje zpracovanou 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
, , Information
Warning
, Error
nebo 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 Application Insights představuje printf
příkazy trasování stylu, které jsou prohledány textem. Log4Net
, NLog
a další textové položky souboru protokolu jsou přeloženy do instancí tohoto typu. Trasování nemá měření jako rozšiřitelnost.
Zpráva
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
, Error
a 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 Application Insights), 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
Application Insights 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.
Application Insights 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 Application Insights 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 Application Insights) 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:
- Sady Application Insights SDK ve výchozím nastavení protokolují jednotlivé
PageView
události na každé akci načítání webové stránky prohlížeče spageViews.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 Application Insights
Moderní prohlížeče zpřístupňují měření pro akce načítání stránek pomocí rozhraní API pro měření výkonu. Application Insights 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 + #2browserTimings/sendDuration
= č. 3browserTimings/receiveDuration
= č. 4browserTimings/processingDuration
= č. 5browsertimings/totalDuration
= #1 + #2 + #3 + #4 + #5pageViews/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 meziNavigationStart
aLoadEventEnd
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ě. Application Insights 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 PC
zaří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 Insights 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 AuthenticatedUserIdTelemetryInitializer
ASP.NET Framework .
Pomocí sady Application Insights SDK inicializuje ověřené 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 Application Insights 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í APPLICATION Insights API 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:
Další informace najdete v tématech:
- Podívejte se na platformy podporované službou Application Insights.
- Zkontrolujte konfiguraci kolekce standardních kontextových vlastností.
- Prozkoumejte protokoly trasování .NET v Application Insights.
- Prozkoumejte protokoly trasování Java v Application Insights.
- Seznamte se s integrovanou integrací Azure Functions se službou Application Insights pro monitorování spouštění funkcí.
- Zjistěte, jak nakonfigurovat aplikaci ASP.NET Core pomocí Application Insights.
- Zjistěte, jak diagnostikovat výjimky ve webových aplikacích pomocí Application Insights.
- Zjistěte, jak rozšířit a filtrovat telemetrii.
- Použití vzorkování k minimalizaci množství telemetrie na základě datového modelu.