Metriky v Application Insights
Application Insights podporuje tři různé typy metrik: standardní (předem agregované), založené na protokolech a vlastní metriky. Každá z nich přináší jedinečnou hodnotu při monitorování stavu aplikace, diagnostiky a analýz. Vývojáři, kteří instrumentují aplikace, se můžou rozhodnout, jaký typ metriky je pro konkrétní scénář nejvhodnější. Rozhodnutí vycházejí z velikosti aplikace, očekávaného objemu telemetrie a obchodních požadavků na přesnost a upozorňování metrik. Tento článek vysvětluje rozdíl mezi všemi podporovanými typy metrik.
Standardní metriky
Standardní metriky ve službě Application Insights jsou předdefinované metriky, které služba automaticky shromažďuje a monitoruje. Tyto metriky pokrývají širokou škálu ukazatelů výkonu a využití, jako jsou využití procesoru, spotřeba paměti, frekvence požadavků a doby odezvy. Standardní metriky poskytují komplexní přehled o stavu a výkonu vaší aplikace bez nutnosti jakékoli další konfigurace. Standardní metriky se předem agregují během shromažďování a ukládají se jako časová řada ve specializovaném úložišti s pouze klíčovými dimenzemi, což jim v době dotazu dává lepší výkon. Díky tomu jsou standardní metriky nejlepší volbou pro upozorňování téměř v reálném čase na dimenze metrik a responzivní řídicí panely.
Metriky založené na protokolech
Metriky založené na protokolech v Application Insights představují koncept doby dotazu, který je reprezentovaný jako časová řada nad daty protokolu vaší aplikace. Podkladové protokoly nejsou předem agregované v době shromažďování nebo úložiště a uchovávají všechny vlastnosti každé položky protokolu. Díky tomuto uchovávání je možné použít vlastnosti protokolu jako dimenze metriky založené na protokolech v době dotazu pro filtrování a rozdělení metrik a rozdělení metrik, které poskytují metriky založené na protokolech vynikající analytickou a diagnostickou hodnotu. Techniky redukce objemu telemetrie, jako je vzorkování a filtrování telemetrie, běžně používané s monitorováním aplikací generujícími velké objemy telemetrie, ale ovlivňují množství shromážděných položek protokolu, a proto snižují přesnost metrik založených na protokolech.
Vlastní metriky (Preview)
Vlastní metriky v Application Insights umožňují definovat a sledovat konkrétní měření, která jsou pro vaši aplikaci jedinečná. Tyto metriky je možné vytvořit instrumentací kódu k odesílání vlastních telemetrických dat do Application Insights. Vlastní metriky poskytují flexibilitu při monitorování všech aspektů aplikace, které nejsou pokryté standardními metrikami, a umožňují tak získat hlubší přehled o chování a výkonu vaší aplikace.
Další informace najdete v tématu Vlastní metriky ve službě Azure Monitor (Preview).
Poznámka:
Application Insights také poskytuje funkci s názvem Live Metrics Stream, která umožňuje monitorování webových aplikací téměř v reálném čase a neukládá žádná telemetrická data.
Porovnání metrik
Funkce | Standardní metriky | Metriky založené na protokolech | Vlastní metrika |
---|---|---|---|
Zdroj dat | Předem agregovaná data časových řad shromážděná během běhu. | Odvozeno z dat protokolu pomocí dotazů Kusto. | Metriky definované uživatelem shromážděné prostřednictvím sady Application Insights SDK nebo rozhraní API |
Zrnitost | Pevné intervaly (1 minuta). | Závisí na členitosti samotných dat protokolu. | Flexibilní členitost na základě uživatelsky definovaných metrik. |
Přesnost | Vysoké, neovlivňovalo vzorkování protokolů. | Může to mít vliv na vzorkování a filtrování. | Vysoká přesnost, zejména při použití předem agregovaných metod, jako je GetMetric. |
Náklady | Zahrnuté v cenách Application Insights | Na základě nákladů na příjem dat protokolu a dotazování. | Viz Cenový model a uchovávání informací. |
Konfigurace | Automaticky k dispozici s minimální konfigurací. | Vyžadovat konfiguraci dotazů protokolu k extrakci požadovaných metrik z dat protokolu. | Vyžaduje vlastní implementaci a konfiguraci v kódu. |
Výkon dotazů | Rychle, kvůli preaggregaci. | Pomalejší, protože se týká dotazování dat protokolu. | Závisí na objemu dat a složitosti dotazů. |
Úložiště | Uložená jako data časových řad v úložišti metrik Služby Azure Monitor. | Uložené jako protokoly v pracovním prostoru služby Log Analytics. | Uložené v Log Analytics i v úložišti metrik Služby Azure Monitor. |
Upozorňování | Podporuje upozorňování v reálném čase. | Umožňuje složité scénáře upozorňování na základě podrobných dat protokolu. | Flexibilní upozorňování na základě uživatelsky definovaných metrik |
Limit služby | V závislosti na omezeních Application Insights | V závislosti na omezeních pracovního prostoru služby Log Analytics. | Omezeno kvótou pro bezplatné metriky a náklady na další dimenze. |
Případy použití | Monitorování, řídicí panely výkonu a rychlé přehledy v reálném čase | Podrobná diagnostika, řešení potíží a podrobná analýza | Přizpůsobené ukazatele výkonu a metriky specifické pro firmu |
Příklady | Využití procesoru, využití paměti, doba trvání požadavku. | Počty požadavků, trasování výjimek, volání závislostí. | Vlastní metriky specifické pro aplikace, jako je zapojení uživatelů, využití funkcí |
Preaggregace metrik
Sady OpenTelemetry SDK a novější sady Application Insights SDK (klasické rozhraní API) předagagují metriky během shromažďování, aby se snížil objem dat odesílaných ze sady SDK do koncového bodu kanálu telemetrie. Tento proces platí pro standardní metriky odeslané ve výchozím nastavení, takže přesnost není ovlivněna vzorkováním nebo filtrováním. Týká se také vlastních metrik odesílaných pomocí rozhraní OpenTelemetry API nebo GetMetric a TrackValue, což vede k menšímu příjmu dat a nižším nákladům. Pokud vaše verze sady Application Insights SDK podporuje GetMetric a TrackValue, je upřednostňovanou metodou odesílání vlastních metrik.
U sad SDK, které neimplementují před agregaci (tj. starší verze sad Application Insights SDK nebo instrumentace prohlížeče), back-end Application Insights stále naplní nové metriky agregací událostí přijatých koncovým bodem kanálu telemetrie Application Insights. Pro vlastní metriky můžete použít metodu trackMetric . I když nemáte prospěch z omezeného objemu dat přenášených přes drát, můžete stále používat předem agregované metriky a využívat lepší výkon a podporu dimenzionálních výstrah téměř v reálném čase pomocí sad SDK, které během shromažďování nepřerušují metriky.
Koncový bod kanálu telemetrie předvytáčí události před vzorkováním příjmu dat. Z tohoto důvodu vzorkování příjmu dat nikdy neovlivní přesnost předem agregovaných metrik bez ohledu na verzi sady SDK, kterou používáte s vaší aplikací.
Následující tabulky uvádějí, kde jsou preagregace předem agregované.
Preaggregace metrik s využitím distribuce OpenTelemetry služby Azure Monitor
Aktuální produkční sada SDK | Standardní agregace metrik | Preaggregace vlastních metrik |
---|---|---|
ASP.NET Core | Sada SDK | SADA SDK přes rozhraní API OpenTelemetry |
.NET (prostřednictvím vývozce) | Sada SDK | SADA SDK přes rozhraní API OpenTelemetry |
Java (3.x) | Sada SDK | SADA SDK přes rozhraní API OpenTelemetry |
Nativní Java | Sada SDK | SADA SDK přes rozhraní API OpenTelemetry |
Node.js | Sada SDK | SADA SDK přes rozhraní API OpenTelemetry |
Python | Sada SDK | SADA SDK přes rozhraní API OpenTelemetry |
Předběžné agregace metrik pomocí sady Application Insights SDK (klasické rozhraní API)
Aktuální produkční sada SDK | Standardní agregace metrik | Preaggregace vlastních metrik |
---|---|---|
.NET Core a .NET Framework | SDK (V2.13.1+) | SDK (V2.7.2+) přes GetMetric Koncový bod kanálu telemetrie prostřednictvím TrackMetric |
Java (2.x) | Koncový bod kanálu telemetrie | Koncový bod kanálu telemetrie prostřednictvím TrackMetric |
JavaScript (prohlížeč) | Koncový bod kanálu telemetrie | Koncový bod kanálu telemetrie prostřednictvím TrackMetric |
Node.js | Koncový bod kanálu telemetrie | Koncový bod kanálu telemetrie prostřednictvím TrackMetric |
Python | Koncový bod kanálu telemetrie | SADA SDK přes OpenCensus.stats (vyřazeno) Koncový bod kanálu telemetrie prostřednictvím TrackMetric |
Upozornění
Sada Application Insights Java 2.x SDK se už nedoporučuje. Místo toho použijte nabídku Java založenou na OpenTelemetry.
Sada OpenCensus Python SDK je vyřazena. Doporučujeme nabídku Pythonu založenou na OpenTelemetry a poskytnout pokyny k migraci.
Preaggregace metrik pomocí automatického nastavení
Při automatickém vytváření se sada SDK automaticky přidá do kódu aplikace a nedá se přizpůsobit. Pro vlastní metriky se vyžaduje ruční instrumentace.
Aktuální produkční sada SDK | Standardní agregace metrik | Preaggregace vlastních metrik |
---|---|---|
ASP.NET Core | SDK 1 | Nepodporováno |
ASP.NET | SDK 2 | Nepodporováno |
Java | Sada SDK | Podporováno 3 |
Node.js | Sada SDK | Nepodporováno |
Python | Sada SDK | Nepodporováno |
Poznámka pod čarou
- 1 ASP.NET autoinstrumentace jádra ve službě App Service generuje standardní metriky bez dimenzí. Ruční instrumentace se vyžaduje pro všechny rozměry.
- 2 ASP.NET automatického vytvoření na virtuálních počítačích nebo škálovacích sadách virtuálních počítačů a místní prostředí generuje standardní metriky bez dimenzí. Totéž platí pro službu Aplikace Azure Service, ale úroveň kolekce musí být nastavená na doporučenou. Ruční instrumentace se vyžaduje pro všechny rozměry.
- 3 Agent Java používaný s automatickým nastavením zaznamenává metriky generované oblíbenými knihovnami a odesílá je do Application Insights jako vlastní metriky.
Vlastní dimenze metrik a před agregace
Všechny metriky, které odesíláte pomocí OpenTelemetry, trackMetric nebo GetMetric a TrackValue API, se automaticky ukládají v úložišti metrik i protokolech. Tyto metriky najdete v tabulce customMetrics v Application Insights a v Průzkumníku metrik pod vlastním oborem názvů metrik s názvem azure.applicationinsights. I když verze vlastní metriky založená na protokolu vždy zachovává všechny dimenze, předem agregovaná verze metriky se ve výchozím nastavení ukládá bez dimenzí. Zachování dimenzí vlastních metrik je funkce Preview, která se dá zapnout na kartě Využití a odhadované náklady výběrem možnosti S dimenzemi v části Odeslat vlastní metriky do Azure Metric Store.
Kvóty
Předem agregované metriky se ukládají jako časové řady ve službě Azure Monitor. Platí kvóty služby Azure Monitor pro vlastní metriky .
Poznámka:
Přechod přes kvótu může mít nezamýšlené důsledky. Azure Monitor může být ve vašem předplatném nebo oblasti nespolehlivý. Informace o tom, jak se vyhnout překročení kvóty, najdete v tématu Omezení návrhu a důležité informace.
Proč je ve výchozím nastavení vypnutá kolekce vlastních dimenzí metrik?
Kolekce vlastních dimenzí metrik je ve výchozím nastavení vypnutá, protože v budoucnu se budou ukládat vlastní metriky s dimenzemi odděleně od Application Insights. Ukládání nedimenzionálních vlastních metrik zůstává bezplatné (až do kvóty). Informace o nadcházejících změnách cenového modelu najdete na naší oficiální stránce s cenami.
Vytváření grafů a zkoumání metrik
Pomocí Průzkumníka metrik Služby Azure Monitor můžete vykreslovat grafy z předem agregovaných, logových a vlastních metrik a vytvářet řídicí panely s grafy. Jakmile vyberete požadovaný prostředek Application Insights, pomocí nástroje pro výběr oboru názvů můžete přepínat mezi metrikami.
Cenové modely pro metriky Application Insights
Ingestování metrik do Application Insights, ať už založené na protokolech nebo předem agregovaných, generuje náklady na základě velikosti přijatých dat. Další informace najdete v podrobnostech o cenách protokolů služby Azure Monitor. Vaše vlastní metriky, včetně všech jeho dimenzí, se vždy ukládají v úložišti protokolů Application Insights. Ve výchozím nastavení se do úložiště metrik předává předem agregovaná verze vlastních metrik bez dimenzí.
Výběrem možnosti Povolit upozorňování na vlastní dimenze metriky můžete uložit všechny dimenze předem agregovaných metrik v úložišti metrik, které můžou generovat další náklady na základě cen vlastních metrik.
Dostupné metriky
Následující části uvádějí metriky s podporovanými agregacemi a dimenzemi. Podrobnosti o metrikách založených na protokolu zahrnují podkladové příkazy dotazu Kusto.
Metriky dostupnosti
Metriky v kategorii Dostupnost umožňují zobrazit stav vaší webové aplikace podle pozorování z bodů po celém světě. Nakonfigurujte testy dostupnosti tak, aby začaly používat všechny metriky z této kategorie.
Dostupnost (availabilityResults/availabilityPercentage)
Metrika Dostupnost zobrazuje procento spuštění webového testu, které nezjistily žádné problémy. Nejnižší možná hodnota je 0, což značí, že všechna spuštění webového testu selhala. Hodnota 100 znamená, že všechna spuštění webového testu prošla ověřovacími kritérii.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Procento | Průměr | Run location , Test name |
Doba trvání testu dostupnosti (availabilityResults/duration)
Metrika doby trvání testu dostupnosti ukazuje, kolik času trvalo spuštění webového testu. U webových testů s více kroky odráží metrika celkovou dobu provádění všech kroků.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Run location , , Test name Test result |
Testy dostupnosti (availabilityResults/count)
Metrika testy dostupnosti odráží počet webových testů spuštěných službou Azure Monitor.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Run location , , Test name Test result |
Metriky prohlížeče
Metriky prohlížeče shromažďuje sada Application Insights JavaScript SDK z skutečných prohlížečů koncových uživatelů. Poskytují skvělé přehledy o zkušenostech uživatelů s vaší webovou aplikací. Metriky prohlížeče se obvykle nevybíjejí vzorek, což znamená, že poskytují vyšší přesnost čísel využití v porovnání s metrikami na straně serveru, které se můžou zkosit vzorkováním.
Poznámka:
Pokud chcete shromažďovat metriky prohlížeče, musí být vaše aplikace instrumentovaná pomocí sady Application Insights JavaScript SDK.
Doba načítání stránky prohlížeče (browserTimings/totalDuration)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Nic |
Doba zpracování klienta (browserTiming/processingDuration)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Nic |
Doba připojení k síti načítání stránky (browserTimings/networkDuration)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Nic |
Příjem doby odezvy (browserTimings/receiveDuration)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Nic |
Čas odeslání požadavku (browserTimings/sendDuration)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Nic |
Metriky selhání
Metriky v selhání zobrazují problémy se zpracováním požadavků, volání závislostí a vyvolanými výjimkami.
Výjimky prohlížeče (výjimky/prohlížeč)
Tato metrika odráží počet vyvolaných výjimek z kódu aplikace spuštěného v prohlížeči. Do metriky se zahrnou jenom výjimky, které se sledují pomocí trackException()
volání rozhraní API Application Insights.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role name |
Selhání volání závislostí (závislosti/selhání)
Počet neúspěšných volání závislostí.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , Cloud role name , Dependency performance , Dependency type , Is traffic synthetic , , Result code Target of dependency call |
Výjimky (výjimky/počet)
Pokaždé, když protokolujete výjimku do Application Insights, existuje volání metody trackException() sady SDK. Metrika Výjimky zobrazuje počet protokolovaných výjimek.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , , Cloud role name Device type |
Neúspěšné požadavky (požadavky/ neúspěšné)
Počet sledovaných požadavků na server, které byly označeny jako neúspěšné. Sada Application Insights SDK ve výchozím nastavení automaticky označí každý požadavek serveru, který vrátil kód odpovědi HTTP 5xx nebo 4xx jako neúspěšný požadavek. Tuto logiku můžete přizpůsobit úpravou vlastnosti úspěšnosti položky telemetrie požadavku ve vlastním inicializátoru telemetrie.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , Cloud role name , Is synthetic traffic , , Request performance Result code |
Výjimky serveru (výjimky/server)
Tato metrika zobrazuje počet výjimek serveru.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , Cloud role name |
Čítače výkonu
Metriky v kategorii Čítače výkonu slouží k přístupu k čítačům výkonu systému shromážděným službou Application Insights.
Dostupná paměť (performanceCounters/availableMemory)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Megabajty / Gigabajty (závislé na datech) | Avg, Max, Min | Cloud role instance |
Rychlost výjimek (performanceCounters/exceptionRate)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Avg, Max, Min | Cloud role instance |
Doba provádění požadavků HTTP (performanceCounters/requestExecutionTime)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Cloud role instance |
Rychlost požadavků HTTP (performanceCounters/requestsPerSecond)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet žádostí za sekundu | Avg, Max, Min | Cloud role instance |
Požadavky HTTP ve frontě aplikace (performanceCounters/requestsInQueue)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Avg, Max, Min | Cloud role instance |
Procesor procesu (performanceCounters/ processCpuPercentage)
Metrika ukazuje, kolik celkové kapacity procesoru využívá proces hostující monitorovanou aplikaci.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Procento | Avg, Max, Min | Cloud role instance |
Poznámka:
Rozsah metriky je mezi 0 a 100 × n, kde n je počet dostupných jader procesoru. Například hodnota metriky 200 % může představovat plné využití dvou jader procesoru nebo poloviny využití 4 jader procesoru atd. Normalizovaný proces procesoru je alternativní metrika shromážděná mnoha sadami SDK, která představuje stejnou hodnotu, ale vydělí ji počtem dostupných jader procesoru. Rozsah normalizované metriky procesoru procesu je tedy 0 až 100.
Rychlost vstupně-výstupních operací procesu (performanceCounters/processIOBytesPerSecond)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Bajty za sekundu | Průměr, Minimum, Maximum | Cloud role instance |
Zpracování privátních bajtů (performanceCounters/processPrivateBytes)
Množství nesdílené paměti, kterou monitorovaný proces přidělil svým datům.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Přijaté | Průměr, Minimum, Maximum | Cloud role instance |
Doba procesoru (performanceCounters/processorCpuPercentage)
Spotřeba procesoru všemi procesy spuštěnými na monitorované instanci serveru.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Procento | Průměr, Minimum, Maximum | Cloud role instance |
Poznámka:
Metrika času procesoru není dostupná pro aplikace hostované ve službě Aplikace Azure Services. Pomocí metriky Procesní procesor můžete sledovat využití procesoru webových aplikací hostovaných ve službě App Services.
Metriky serveru
Volání závislostí (závislosti/počet)
Tato metrika souvisí s počtem volání závislostí.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , Cloud role name , Dependency performance , , Is traffic synthetic Dependency type , Result code , , Successful call Target of a dependency call |
Doba trvání závislosti (závislosti/doba trvání)
Tato metrika odkazuje na dobu trvání volání závislostí.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Cloud role instance , Cloud role name , Dependency performance , , Is traffic synthetic Dependency type , Result code , , Successful call Target of a dependency call |
Frekvence požadavků serveru (požadavky/sazba)
Tato metrika odráží počet příchozích požadavků serveru přijatých vaší webovou aplikací.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet za sekundu | Průměr | Cloud role instance , Cloud role name , Is traffic synthetic , , Request performance Result code Successful request |
Požadavky na server (požadavky/počet)
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , Cloud role name , Is traffic synthetic , , Request performance Result code Successful request |
Doba odezvy serveru (požadavky/doba trvání)
Tato metrika odráží dobu, po které servery zpracovávaly příchozí požadavky.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Cloud role instance , Cloud role name , Is traffic synthetic , , Request performance Result code Successful request |
Metriky využití
Doba načítání zobrazení stránky (pageViews/duration)
Tato metrika odkazuje na dobu, kterou trvalo načtení událostí PageView.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Milisekundy | Avg, Max, Min | Cloud role name , Is traffic synthetic |
Zobrazení stránek (pageViews/count)
Počet událostí PageView protokolovaných pomocí rozhraní API Application Insights TrackPageView().
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role name , Is traffic synthetic |
Trasování (trasování/počet)
Počet příkazů trasování protokolovaných pomocí volání rozhraní API TrackTrace() Application Insights.
Měrná jednotka | Podporované agregace | Podporované dimenze |
---|---|---|
Počet | Počet | Cloud role instance , Cloud role name , , Is traffic synthetic Severity level |
Vlastní metrika
Neplatí pro standardní metriky.
Přístup k metrikám založeným na protokolech přímo pomocí rozhraní REST API služby Application Insights
Rozhraní REST API služby Application Insights umožňuje programové načítání metrik založených na protokolech. Obsahuje také volitelný parametrai.include-query-payload
, který při přidání do řetězce dotazu vyzve rozhraní API, aby vrátilo nejen data časových řad, ale také příkaz dotazovací jazyk Kusto (KQL) použitý k načtení. Tento parametr může být zvlášť přínosný pro uživatele, kteří chtějí pochopit propojení mezi nezpracovaných událostí v Log Analytics a výslednou metrikou založenou na protokolech.
Pokud chcete k datům přistupovat přímo, předejte parametr ai.include-query-payload
do rozhraní API Application Insights v dotazu pomocí jazyka KQL.
Poznámka:
Pokud chcete načíst podkladový dotaz DEMO_APP
na protokoly a DEMO_KEY
nemusíte ho nahrazovat. Pokud chcete jenom načíst příkaz KQL, nikoli data časových řad vaší vlastní aplikace, můžete je zkopírovat a vložit přímo do panelu hledání v prohlížeči.
api.applicationinsights.io/v1/apps/DEMO_APP/metrics/users/authenticated?api_key=DEMO_KEY&prefer=ai.include-query-payload
Následuje příklad návratového příkazu KQL pro metriku "Authenticated Users". (V tomto příkladu "users/authenticated"
je ID metriky.)
output
{
"value": {
"start": "2024-06-21T09:14:25.450Z",
"end": "2024-06-21T21:14:25.450Z",
"users/authenticated": {
"unique": 0
}
},
"@ai.query": "union (traces | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (requests | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (pageViews | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (dependencies | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (customEvents | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (availabilityResults | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (exceptions | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (customMetrics | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)), (browserTimings | where timestamp >= datetime(2024-06-21T09:14:25.450Z) and timestamp < datetime(2024-06-21T21:14:25.450Z)) | where notempty(user_AuthenticatedId) | summarize ['users/authenticated_unique'] = dcount(user_AuthenticatedId)"
}