Datový model telemetrie Application Insights

  • Článek

Application Insights odesílá telemetrii z vaší webové aplikace do 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á službou Application Insights modelují tento typický vzor spouštění aplikací.

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

K monitorování spuštění 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: Vygeneruje se k protokolování požadavku přijatého vaší aplikací. Například sada Application Insights Web SDK automaticky vygeneruje položku telemetrie požadavku pro každý požadavek HTTP, který obdrží vaše webová aplikace.

    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ší aplikací. Každá operace je úspěšná nebo neúspěšná a má určitou dobu trvání.

  • Výjimka: Obvykle představuje výjimku, která způsobí 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 pomocí System.Data. Volání koncových bodů HTTP jsou definována pomocí 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, kterou znáte, například Log4Net nebo System.Diagnostics.
  • Událost: Obvykle se používá k zachycení interakce uživatelů s vaší službou za účelem analýzy vzorů využití.
  • Metrika: Slouží 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á odblokuje určité scénáře. Při správné inicializaci verze aplikace dokáže Application Insights detekovat nové vzory 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 umožní dobře porozumět dopadu.

Model telemetrie Application Insights definuje způsob korelace telemetrie s operací, jejíž je součástí. Požadavek může například provést SQL Database volání a záznam diagnostických informací. Můžete nastavit kontext korelace pro ty položky telemetrie, které ho propojí zpět 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 byl model jednoduchý a tenký, aby podporoval základní scénáře a umožnil rozšíření schématu pro pokročilé použití.

Pokud chcete hlásit problémy s datovým modelem nebo schématem a návrhy, použijte naše úložiště GitHub.

Žádost

Položka telemetrie požadavku v Application Insights představuje logickou sekvenci provádění aktivovanou externím požadavkem na vaši aplikaci. Každé spuštění požadavku je identifikováno jedinečným id a url který obsahuje všechny parametry spuštění.

Žádosti můžete seskupit podle logiky name a definovat source ho. Spuštění kódu může mít za success následek nebo fail a má určitou durationhodnotu . Úspěšné a neúspěšné spuštění můžete dále seskupit pomocí resultCodepříkazu . Počáteční čas telemetrie požadavku je definován na úrovni obálky.

Telemetrie požadavků 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 instrumentačního klíče bude dál fungovat, ale pro tuto funkci už nebudeme poskytovat aktualizace ani podporu. Přechod na připojovací řetězce , abyste mohli využívat nové možnosti.

Name

Toto pole je název požadavku a představuje cestu kódu pro zpracování požadavku. Nízká hodnota kardinality umožňuje lepší seskupování požadavků. V případě požadavků HTTP představuje metodu HTTP a šablonu cesty url, jako GET /values/{id} bez skutečné id hodnoty.

Webová sada SDK Application Insights odešle název požadavku "tak, jak je" o písmenech. Při seskupování v uživatelském rozhraní se rozlišují malá a velká písmena, takže GET /Home/Index se počítá odděleně od GET /home/INDEX toho, i když často vedou ke stejnému kontroleru a provedení akce. Důvodem je, že v adresách URL se obecně rozlišují velká a malá písmena. Možná budete chtít zjistit, jestli u adres URL zadaných velkými písmeny nedošlo k chybám 404 . Další informace o shromažďování názvů požadavků pomocí webové sady SDK ASP.NET najdete 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 ke 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ů

URL

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

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

Zdroj

Zdroj je zdrojem 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 naformátovaná jako DD.HH:MM:SS.MMMMMM. Musí být pozitivní a kratší 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. Je to stavový kód HTTP pro požadavky HTTP. Může se jednat o HRESULT hodnotu nebo typ výjimky pro jiné typy požadavků.

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

Success

Úspěch označuje, jestli bylo volání úspěšné nebo neúspěšné. Toto pole je vyžadováno. Pokud požadavek není explicitně nastavený na false, 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ší než 400 nebo 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 to také znamenat nefunkční odkaz. V případě nefunkčních odkazů můžete implementovat pokročilejší logiku. Nefunkční odkazy můžete označit jako selhání pouze v případě, že se tyto odkazy nacházejí na stejném webu, a to analýzou referenčního nástroje url. Nebo je můžete označit jako selhání při přístupu z mobilní aplikace společnosti. Podobně 301 a 302 označit selhání při přístupu z klienta, který nepodporuje přesměrování.

Částečně přijatý obsah 206 může znamenat selhání celkové žádosti. Koncový bod Application Insights může například přijmout dávku položek telemetrie jako jeden požadavek. Vrátí 206 se, když některé položky v dávce nebyly úspěšně zpracovány. Zvyšující se rychlost značí 206 problém, který je potřeba prošetřit. Podobná logika platí pro 207 více stavů, kde úspěch může být nejhorší z samostatných kódů odpovědí.

Vlastní vlastnosti

Kolekce name-value pro vlastní vlastnosti: Tato kolekce se používá k rozšíření standardní telemetrie o vlastní dimenze. Příkladem je slot nasazení, který vytvořil telemetrii, nebo vlastnost specifická 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í: Tuto kolekci použijte k sestavě pojmenovaných měření přidružených k položce telemetrie. Mezi typické případy použití patří:

  • Velikost datové části telemetrie závislostí.
  • Počet položek fronty zpracovaných telemetrií požadavků
  • Doba, kterou zákazníkovi trvalo dokončení kroku průvodce dokončení telemetrie událostí.

Ve službě Application Analytics se můžete dotazovat na vlastní měření:

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

Poznámka

Vlastní měření jsou přidružená k položce telemetrie, ke 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.

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

Závislost

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

Name

Toto pole je název příkazu zahájené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ávislostí. Používá se ke korelaci s položkou telemetrie požadavku, která odpovídá tomuto volání závislostí. Další informace najdete v tématu Korelace telemetrie v Application Insights.

Data

Toto pole je příkaz iniciovaný tímto voláním závislostí. 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 je commandName a resultCode. Příklady jsou SQL, tabulka Azure a HTTP.

Cíl

Toto pole je cílovou lokalitou volání závislostí. Příkladem je 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í být kratší než 1000 dny.

Kód výsledku

Toto pole je kód výsledku volání závislostí. 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í.

Vlastní vlastnosti

Kolekce name-value pro vlastní vlastnosti: Tato kolekce se používá k rozšíření standardní telemetrie o vlastní dimenze. Příkladem je slot nasazení, který vytvořil telemetrii, nebo vlastnost specifická 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í: Tuto kolekci použijte k sestavě pojmenovaných měření přidružených k položce telemetrie. Mezi typické případy použití patří:

  • Velikost datové části telemetrie závislostí.
  • Počet položek fronty zpracovaných telemetrií požadavků
  • Doba, kterou zákazníkovi trvalo dokončení kroku průvodce dokončení telemetrie událostí.

Ve službě Application Analytics se můžete dotazovat na vlastní měření:

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

Poznámka

Vlastní měření jsou přidružená k položce telemetrie, ke 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.

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

Výjimka

V Application Insights představuje instance výjimky zpracovávanou nebo neošetřenou výjimku, ke které došlo během provádění monitorované aplikace.

ID problému

ID problému určuje, kde byla v kódu vyvoláná výjimka. Používá se pro seskupování 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

(Bude prodlouženo)

Vlastní vlastnosti

Kolekce name-value pro vlastní vlastnosti: Tato kolekce se používá k rozšíření standardní telemetrie o vlastní dimenze. Příkladem je slot nasazení, který vytvořil telemetrii, nebo vlastnost specifická 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í: Tuto kolekci použijte k sestavě pojmenovaných měření přidružených k položce telemetrie. Mezi typické případy použití patří:

  • Velikost datové části telemetrie závislostí.
  • Počet položek fronty zpracovaných telemetrií požadavků
  • Doba, kterou zákazníkovi trvalo dokončení kroku průvodce dokončení telemetrie událostí.

Ve službě Application Analytics se můžete dotazovat na vlastní měření:

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

Poznámka

Vlastní měření jsou přidružená k položce telemetrie, ke 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.

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

Trasování

Trasování telemetrie v Application Insights představuje printfpříkazy trasování -style, které jsou prohledány textem. Log4Net, NLoga další položky textového souboru protokolu se překládají na instance tohoto typu. Trasování nemá měření jako rozšiřitelnost.

Zpráva

Trasovací zpráva.

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

Úroveň závažnosti

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

Hodnoty:Verbose, Information, WarningError, aCritical

Vlastní vlastnosti

Kolekce name-value pro vlastní vlastnosti: Tato kolekce se používá k rozšíření standardní telemetrie o vlastní dimenze. Příkladem je slot nasazení, který vytvořil telemetrii, nebo vlastnost specifická 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, jako je kliknutí na tlačítko nebo rezervace objednávky. Může to být také událost životního cyklu aplikace, jako je inicializace nebo aktualizace konfigurace.

Sémanticky události můžou nebo nemusí být korelovány s požadavky. Při správném použití 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í.

Name

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

Maximální délka: 512 znaků

Vlastní vlastnosti

Kolekce name-value pro vlastní vlastnosti: Tato kolekce se používá k rozšíření standardní telemetrie o vlastní dimenze. Příkladem je slot nasazení, který vytvořil telemetrii, nebo vlastnost specifická 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í: Tuto kolekci použijte k sestavě pojmenovaných měření přidružených k položce telemetrie. Mezi typické případy použití patří:

  • Velikost datové části telemetrie závislostí.
  • Počet položek fronty zpracovaných telemetrií požadavků
  • Doba, kterou zákazníkovi trvalo dokončení kroku průvodce dokončení telemetrie událostí.

Ve službě Application Analytics se můžete dotazovat na vlastní měření:

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

Poznámka

Vlastní měření jsou přidružená k položce telemetrie, ke 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.

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

Metric

Application Insights podporuje dva typy telemetrie metrik: jedno měření a před agregovanou metriku. Jedno měření je jenom název a hodnota. Před agregovaná metrika určuje minimální a maximální hodnotu metriky v agregačním intervalu a její směrodatnou odchylku.

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

Application Insights podporuje několik dobře známých názvů metrik. Tyto metriky se umístí do performanceCounters tabulky.

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

Název .NET Název nezávislý na platformě Popis
\Processor(_Total)\% Processor Time Probíhá práce... Celkový procesor počítače.
\Memory\Available Bytes Probíhá práce... Zobrazuje velikost fyzické paměti v bajtech, která je dostupná pro procesy spuštěné 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 pozdější procesy nemohly zobrazit data použitá předchozím procesem. Pohotovostní paměť je paměť, která byla odebrána z pracovní sady procesu (fyzické paměti) na cestě na disk, 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, který je hostitelem aplikace.
\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 žádostí zpracovaných aplikací
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Probíhá práce... Míra 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 pro metriky najdete v tématu Metriky – Získání.

Name

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 představuje váhu 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í.

Vlastní vlastnosti

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

Kolekce name-value pro vlastní vlastnosti: Tato kolekce se používá k rozšíření standardní telemetrie o vlastní dimenze. Příkladem je slot nasazení, který vytvořil telemetrii, nebo vlastnost specifická 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, která je vývojářem definovaná jako karta aplikace nebo obrazovka 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ánkových aplikací (SPA), kde přepínání mezi stránkami není svázáno s akcemi stránky prohlížeče. Je pageViews.duration doba potřebná k tomu, aby aplikace představila stránku uživateli.

Poznámka

  • Ve výchozím nastavení sady Application Insights SDK protokolují jednotlivé PageView události v každé akci načtení webové stránky prohlížeče s pageViews.duration vyplněným načasováním prohlížeče. Vývojáři můžou rozšířit další sledování událostí PageView 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í prohlížečeTiming v Application Insights

Moderní prohlížeče zpřístupňují měření akcí načtení stránky pomocí rozhraní API pro výkon. Application Insights tato měření zjednodušuje tím, že slučuje související časování do standardních metrik prohlížeče definovaných těmito definicemi času zpracování:

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

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

  • Klient <–> webový server: Klient odešle datovou část požadavku, počká, až server požadavek provede, a přijme první paket odpovědi.

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

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

  • browserTimings/networkDuration = #1 + #2

  • browserTimings/sendDuration = č. 3

  • browserTimings/receiveDuration = č. 4

  • browserTimings/processingDuration = č. 5

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

  • pageViews/duration

Snímek obrazovky zobrazují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 kontextové pole silného typu. Každé pole umožňuje konkrétní scénář monitorování. Kolekce vlastních vlastností slouží k ukládání vlastních kontextových informací nebo informací specifických pro aplikaci.

Verze aplikace

Informace v polích kontextu aplikace se vždy týká aplikace, která odesílá telemetrii. Verze aplikace se používá k analýze trendových změn v chování aplikace a jejich korelaci s nasazeními.

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ý operaci ve službě inicioval. Application Insights extrahuje informace o geografickém umístění z IP adresy klienta a pak je zkrátí. Ip adresa klienta sama o sobě se nedá použít jako identifikovatelné informace uživatele.

Maximální délka: 46

Typ zařízení

Původně se toto pole používalo k označení typu zařízení, které uživatel aplikace používá. Dnes se používá především k rozlišení telemetrie JavaScriptu 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. POŽADAVEK nebo zobrazení stránky vytvoří ID operace. Všechna ostatní telemetrie nastaví toto pole na hodnotu pro zobrazení obsahující požadavek nebo stránku.

Maximální délka: 128

ID nadřazené operace

Toto pole je jedinečný identifikátor bezprostředního nadřazeného objektu 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ří požadavek nebo zobrazení stránky. Všechny ostatní položky telemetrie nastaví toto pole na hodnotu pro zobrazení obsahující požadavek nebo stránku. Název operace se používá 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 typu Jaké 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 to být prohledávací modul webu indexující web, testy 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 polích kontextu relace jsou vždy o uživateli. Když se telemetrie odesílá ze služby, kontext relace se týká uživatele, který operaci ve službě inicioval.

Maximální délka: 64

Anonymní ID uživatele

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

Vzorkování je jednou z technik, jak minimalizovat 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ě náhodná hodnota.

Poznámka

Počet anonymních ID 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. Tento výpočet může vést k vícenásobnému počítání stejných fyzických uživatelů.

ID uživatelů je možné křížově odkazovat s ID relací, aby se poskytovaly jedinečné dimenze telemetrie a navazovaly aktivity 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

ID ověřeného 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í pomocí sady ASP.NET Framework SDK AuthenticatedUserIdTelemetryInitializer.

Pomocí sady Application Insights SDK inicializujete ověřené ID uživatele s hodnotou, která uživatele trvale identifikuje napříč prohlížeči a zařízeními. Tímto způsobem se všechny položky telemetrie přiřazují 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 konfiguraci vzorkování a filtrování telemetrie).

ID uživatelů je možné křížově odkazovat s ID relací, aby se poskytovaly jedinečné dimenze telemetrie a navazovaly aktivity uživatelů v průběhu relace.

Maximální délka: 1 024

Account ID

ID účtu ve víceklientských aplikacích je ID nebo název účtu tenanta, se kterým uživatel jedná. Používá se k 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 pro 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, jejíž 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 o 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, který se používá pro účely fakturace. Použijte ho k přepsání standardní detekce uzlů.

Maximální délka: 256

Další kroky

Naučte se používat rozhraní API Application Insights pro vlastní události a metriky, včetně:

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

Další informace najdete v tématech: