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í

Diagram znázorňující datový model telemetrie Application Insights

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 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, 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ě 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.

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, , 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 Application Insights 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.

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, 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 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 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 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 + #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.

Snímek obrazovky znázorňující stránku Metriky v Application Insights zobrazující grafické zobrazení dat metrik pro webovou aplikaci

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 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 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 AuthenticatedUserIdTelemetryInitializerASP.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:

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

Další informace najdete v tématech: