Export telemetrie z Application Insights
Chcete uchovávat telemetrii po dobu delší, než je standardní doba uchovávání? Nebo ho chcete zpracovat nějakým specializovaným způsobem? Pro tento účel je ideální průběžný export. Události, které vidíte na portálu Application Insights, je možné exportovat do úložiště v Azure ve formátu JSON. Odtud si můžete stáhnout data a napsat kód, který potřebujete ke zpracování.
Důležité
- Dne 29. února 2024 se průběžný export vyřadí z provozu v rámci vyřazování Application Insights Classic z provozu.
- Při migraci na prostředek Application Insights založený na pracovním prostoru musíte použít nastavení diagnostiky pro export telemetrie. Všechny prostředky Application Insights založené na pracovním prostoru musí používat nastavení diagnostiky.
- Export nastavení diagnostiky může zvýšit náklady. Další informace najdete v tématu Export na základě nastavení diagnostiky.
Před nastavením průběžného exportu můžete zvážit několik alternativ:
- Tlačítko Exportovat v horní části karty metrik nebo hledání umožňuje přenést tabulky a grafy do excelové tabulky.
- Log Analytics poskytuje výkonný dotazovací jazyk pro telemetrii. Může také exportovat výsledky.
- Pokud chcete prozkoumat data v Power BI, můžete to udělat bez použití průběžného exportu, pokud jste migrovali na prostředek založený na pracovním prostoru.
- Rozhraní REST API pro přístup k datům umožňuje přístup k telemetrii prostřednictvím kódu programu.
- K nastavení průběžného exportu můžete přistupovat také přes PowerShell.
Po průběžném exportu se data zkopírují do úložiště, kde můžou zůstat tak dlouho, jak chcete, jsou ve službě Application Insights pořád dostupná po obvyklou dobu uchovávání.
Podporované oblasti
Průběžný export se podporuje v následujících oblastech:
- Southeast Asia
- Střední Kanada
- Indie – střed
- Severní Evropa
- Spojené království – jih
- Austrálie – východ
- Japonsko – východ
- Jižní Korea – střed
- Francie – střed
- Východní Asie
- USA – západ
- Střední USA
- USA – východ 2
- Středojižní USA
- Západní USA 2
- Jižní Afrika – sever
- USA – středosever
- Brazílie – jih
- Švýcarsko – sever
- Austrálie – jihovýchod
- Spojené království – západ
- Německo – středozápad
- Švýcarsko – západ
- Austrálie – střed 2
- Spojené arabské emiráty – střed
- Brazílie – jihovýchod
- Austrálie – střed
- Spojené arabské emiráty – sever
- Norsko – východ
- Japonsko – západ
Poznámka
Průběžný export bude dál fungovat pro aplikace v oblastech USA – východ a Západní Evropa, pokud byl export nakonfigurovaný před 23. únorem 2021. Nová pravidla průběžného exportu není možné nakonfigurovat pro žádnou aplikaci v oblasti USA – východ nebo Západní Evropa bez ohledu na to, kdy byla aplikace vytvořena.
Pokročilá konfigurace úložiště pro průběžný export
Průběžný export nepodporuje následující funkce nebo konfigurace služby Azure Storage:
- Použití bran firewall Azure Virtual Network/Azure Storage s Azure Blob Storage
- Azure Data Lake Storage Gen2.
Vytvoření průběžného exportu
Poznámka
Aplikace nemůže exportovat více než 3 TB dat za den. Pokud se exportuje více než 3 TB za den, export se zakáže. Pokud chcete exportovat bez omezení, použijte export na základě nastavení diagnostiky.
V prostředku Application Insights pro vaši aplikaci v části Konfigurovat na levé straně otevřete Průběžný export a vyberte Přidat.
Zvolte datové typy telemetrie, které chcete exportovat.
Vytvořte nebo vyberte účet Azure Storage , do kterého chcete data uložit. Další informace o cenových možnostech úložiště najdete na stránce s cenami.
Vyberte Přidat>exportovat cílový>účet úložiště. Pak buď vytvořte nový obchod, nebo zvolte existující úložiště.
Upozornění
Ve výchozím nastavení se umístění úložiště nastaví na stejnou geografickou oblast jako váš prostředek Application Insights. Pokud ukládáte v jiné oblasti, můžou se vám účtovat poplatky za převod.
Vytvořte nebo vyberte kontejner v úložišti.
Poznámka
Po vytvoření exportu začnou nově přijatá data proudit do Azure Blob Storage. Průběžný export přenáší jenom nová telemetrická data, která se vytvořila nebo ingestovala po povolení průběžného exportu. Žádná data, která existovala před povolením průběžného exportu, se nebudou exportovat. Neexistuje žádný podporovaný způsob zpětného exportu dříve vytvořených dat pomocí průběžného exportu.
Zobrazení dat v úložišti může trvat přibližně hodinu.
Po dokončení prvního exportu najdete v kontejneru Blob Storage následující strukturu. (Tato struktura se liší v závislosti na datech, která shromažďujete.)
Název | Description |
---|---|
Dostupnost | Hlásí webové testy dostupnosti. |
Událost | Vlastní události generované nástrojem TrackEvent() |
Výjimky | Hlásí výjimky na serveru a v prohlížeči. |
Zprávy | Odesílají trackTrace a adaptéry protokolování. |
Metriky | Generuje se voláním rozhraní API pro metriky. |
PerformanceCounters | Čítače výkonu shromažďované službou Application Insights |
Žádosti | Odeslal TrackRequest. Standardní moduly používají požadavky k hlášení doby odezvy serveru měřené na serveru. |
Upravit průběžný export
Vyberte Průběžný export a vyberte účet úložiště, který chcete upravit.
Zastavení průběžného exportu
Pokud chcete export zastavit, vyberte Zakázat. Když znovu vyberete Povolit , export se restartuje s novými daty. Nezístane vám data, která přišla na portál, když byl export zakázaný.
Pokud chcete export trvale zastavit, odstraňte ho. Tím nedojde k odstranění vašich dat z úložiště.
Nemůžete přidat nebo změnit export?
K přidání nebo změně exportů potřebujete přístupová práva vlastníka, přispěvatele nebo přispěvatele Application Insights. Seznamte se s rolemi.
Jaké události dostáváte?
Exportovaná data jsou nezpracovaná telemetrie, kterou přijímáme z vaší aplikace s přidanými daty o poloze z IP adresy klienta.
Data zahozená vzorkováním nejsou součástí exportovaných dat.
Ostatní počítané metriky nejsou zahrnuté. Například neexportujeme průměrné využití procesoru, ale exportujeme nezpracovanou telemetrii, ze které se průměr vypočítá.
Data také zahrnují výsledky všech webových testů dostupnosti , které jste nastavili.
Poznámka
Pokud vaše aplikace odesílá velké množství dat, může funkce vzorkování fungovat a odesílat jenom zlomek vygenerované telemetrie. Další informace o vzorkování.
Kontrola dat
Úložiště můžete zkontrolovat přímo na portálu. V nabídce úplně vlevo vyberte Domů . V horní části, kde je uvedeno Služby Azure, vyberte Účty úložiště. Vyberte název účtu úložiště a na stránce Přehled vyberteObjekty blobslužeb>. Nakonec vyberte název kontejneru.
Pokud chcete zkontrolovat Azure Storage v sadě Visual Studio, vyberte Zobrazit>Průzkumníka cloudu. Pokud tento příkaz nabídky nemáte, musíte nainstalovat sadu Azure SDK. Otevřete dialogové okno Nový projekt, rozbalte Visual C#/Cloud a vyberte Získat Microsoft Azure SDK pro .NET.
Když otevřete úložiště objektů blob, uvidíte kontejner se sadou souborů objektů blob. Zobrazí se identifikátor URI každého souboru odvozený z názvu prostředku Application Insights, jeho instrumentační klíč a typ telemetrie, datum a čas. Název prostředku je jenom malými písmeny a instrumentační klíč vynechává pomlčky.
Poznámka
Podpora příjmu dat založeného na instrumentačním klíči skončí 31. března 2025. Příjem dat instrumentačního klíče bude dál fungovat, ale už nebudeme pro tuto funkci poskytovat aktualizace ani podporu. Přejděte na připojovací řetězce , abyste mohli využívat nové možnosti.
Datum a čas jsou UTC a jsou, kdy byla telemetrie uložena v úložišti, nikoli čas, kdy byla vygenerována. Z tohoto důvodu platí, že pokud napíšete kód pro stažení dat, může se mezi daty pohybovat lineárně.
Tady je forma cesty:
$"{applicationName}_{instrumentationKey}/{type}/{blobDeliveryTimeUtc:yyyy-MM-dd}/{ blobDeliveryTimeUtc:HH}/{blobId}_{blobCreationTimeUtc:yyyyMMdd_HHmmss}.blob"
Kde:
blobCreationTimeUtc
je čas vytvoření objektu blob v interním přípravném úložišti.blobDeliveryTimeUtc
je čas, kdy se objekt blob zkopíruje do cílového úložiště exportu.
Formát dat
Data jsou naformátovaná tak, aby:
Každý objekt blob je textový soubor, který obsahuje více
\n
řádků oddělených. Obsahuje telemetrii zpracovávanou během časového období zhruba půl minuty.Každý řádek představuje datový bod telemetrie, například požadavek nebo zobrazení stránky.
Každý řádek je neformátovaný dokument JSON. Pokud chcete zobrazit řádky, otevřete objekt blob v sadě Visual Studio a vyberte Upravit>soubor rozšířeného>formátu.
Časové intervaly jsou v ticích, kde 10 000 klisen = 1 ms. Tyto hodnoty například zobrazují čas 1 ms pro odeslání požadavku z prohlížeče, 3 ms pro jeho přijetí a 1,8 s pro zpracování stránky v prohlížeči:
"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}
Podrobné referenční informace k datovému modelu pro typy a hodnoty vlastností najdete v tématu Model exportu dat Application Insights.
Zpracování dat
V malém měřítku můžete napsat kód, který rozdělí data a načte je do tabulky. Příklad:
private IEnumerable<T> DeserializeMany<T>(string folderName)
{
var files = Directory.EnumerateFiles(folderName, "*.blob", SearchOption.AllDirectories);
foreach (var file in files)
{
using (var fileReader = File.OpenText(file))
{
string fileContent = fileReader.ReadToEnd();
IEnumerable<string> entities = fileContent.Split('\n').Where(s => !string.IsNullOrWhiteSpace(s));
foreach (var entity in entities)
{
yield return JsonConvert.DeserializeObject<T>(entity);
}
}
}
}
Větší ukázku kódu najdete v tématu Použití role pracovního procesu.
Odstranění starých dat
Zodpovídáte za správu kapacity úložiště a odstranění starých dat, pokud je to potřeba.
Opětovné vygenerujte klíč úložiště
Pokud změníte klíč k vašemu úložišti, průběžný export přestane fungovat. Ve vašem účtu Azure se zobrazí oznámení.
Vyberte kartu Průběžný export a upravte export. Upravte hodnotuExportovat cíl , ale ponechte vybrané stejné úložiště. Vyberte OK. Tím akci potvrdíte.
Průběžný export se restartuje.
Export ukázek
Ukázky exportu najdete tady:
Ve větším měřítku zvažte clustery HDInsight Hadoop v cloudu. HDInsight poskytuje různé technologie pro správu a analýzu velkých objemů dat. Můžete ho použít ke zpracování dat exportovaných z Application Insights.
Nejčastější dotazy
Tato část obsahuje odpovědi na běžné otázky.
Můžu si graf stáhnout jednorázově?
Můžeš to udělat. V horní části karty vyberte Exportovat data.
Nastavil(a) jsem export, ale proč v mém úložišti nejsou žádná data?
Obdržela Služba Application Insights od nastavení exportu z vaší aplikace nějakou telemetrii? Dostanete jenom nová data.
Pokusil(a) jsem se nastavit export, ale proč mi byl odepřen přístup?
Pokud účet vlastní vaše organizace, musíte být členem skupiny Vlastníci nebo Přispěvatelé.
Můžu exportovat přímo do vlastního místního obchodu?
No. Náš modul pro export v současné době funguje jenom se službou Azure Storage.
Existuje nějaké omezení množství dat, která jste vložili do mého obchodu?
No. Data budeme dál nasdílovat, dokud export neodstraníte. Zastavíme se, pokud dosáhneme vnějších limitů pro Blob Storage, ale tento limit je obrovský. Záleží na vás, jak velkou velikost úložiště využijete.
Kolik objektů blob mám v úložišti vidět?
- Pro každý datový typ, který jste vybrali k exportu, se vytvoří nový objekt blob každou minutu, pokud jsou data k dispozici.
- Aplikacím s vysokým provozem se přidělují jednotky oddílů navíc. V tomto případě každá jednotka vytvoří objekt blob každou minutu.
Po opětovném vygenerování klíče do úložiště nebo změně názvu kontejneru nefunguje export?
Upravte export a vyberte kartu Exportovat cíl . Ponechte vybrané stejné úložiště jako předtím a potvrďte ho výběrem OK . Export se restartuje. Pokud ke změně došlo během posledních několika dnů, nepřijdete o data.
Můžu pozastavit export?
Ano. Vyberte Zakázat.
Ukázky kódů
- Ukázka Stream Analytics
- Export do SQL pomocí Stream Analytics
- Podrobné referenční informace k datovému modelu pro typy a hodnoty vlastností
Export na základě nastavení diagnostiky
Upřednostňovaný je export nastavení diagnostiky, protože poskytuje další funkce:
- Účty Azure Storage s virtuálními sítěmi, branami firewall a privátními propojeními.
- Export do Azure Event Hubs.
Export nastavení diagnostiky se od průběžného exportu dále liší následujícími způsoby:
- Aktualizované schéma.
- Telemetrická data se odesílají při příchodu místo v dávkovém nahrávání.
Důležité
Další náklady můžou vzniknout kvůli nárůstu volání do cíle, jako je účet úložiště.
Pokud chcete migrovat na nastavení diagnostiky, export:
- Povolte nastavení diagnostiky v klasické službě Application Insights.
- Konfigurace exportu dat: Vyberte Nastavení> diagnostikyPřidat nastavení diagnostiky v rámci prostředku Application Insights.
- Ověřte, že je nový export dat nakonfigurovaný stejně jako průběžný export.
Upozornění
Pokud chcete ukládat diagnostické protokoly v pracovním prostoru služby Log Analytics, je potřeba zvážit dva body, abyste se vyhnuli zobrazení duplicitních dat ve službě Application Insights:
- Cílem nemůže být pracovní prostor služby Log Analytics, na kterém je založený váš prostředek Application Insights.
- Uživatel Application Insights nemůže mít přístup k oběma pracovním prostorům. Režim řízení přístupu log Analytics nastavte na Vyžaduje oprávnění pracovního prostoru. Prostřednictvím řízení přístupu na základě role v Azure se ujistěte, že uživatel má přístup jenom k pracovnímu prostoru služby Log Analytics, na který je prostředek Application Insights založený.
Tyto kroky jsou nezbytné, protože služba Application Insights přistupuje k telemetrii napříč prostředky Application Insights (včetně pracovních prostorů služby Log Analytics), aby bylo možné poskytnout kompletní transakční operace a přesné mapy aplikací. Vzhledem k tomu, že diagnostické protokoly používají stejné názvy tabulek, může se zobrazit duplicitní telemetrie, pokud má uživatel přístup k více prostředkům, které obsahují stejná data.
Export datového modelu Application Insights
Tato tabulka obsahuje seznam vlastností telemetrie odesílané ze sad Application Insights SDK na portál. Tyto vlastnosti uvidíte ve výstupu dat z průběžného exportu. Zobrazují se také ve filtrech vlastností v Průzkumníku metrik a diagnostickém vyhledávání.
Důležité body:
[0]
v těchto tabulkách označuje bod v cestě, kam musíte vložit index; ale není to vždy 0.- Doba trvání je v desetinách mikrosekundy, takže 10000000 == 1 sekunda.
- Data a časy jsou UTC a jsou uvedeny ve formátu ISO.
yyyy-MM-DDThh:mm:ss.sssZ
Příklad
// A server report about an HTTP request
{
"request": [
{
"urlData": { // derived from 'url'
"host": "contoso.org",
"base": "/",
"hashTag": ""
},
"responseCode": 200, // Sent to client
"success": true, // Default == responseCode<400
// Request id becomes the operation id of child events
"id": "fCOhCdCnZ9I=",
"name": "GET Home/Index",
"count": 1, // 100% / sampling rate
"durationMetric": {
"value": 1046804.0, // 10000000 == 1 second
// Currently the following fields are redundant:
"count": 1.0,
"min": 1046804.0,
"max": 1046804.0,
"stdDev": 0.0,
"sampledValue": 1046804.0
},
"url": "/"
}
],
"internal": {
"data": {
"id": "7f156650-ef4c-11e5-8453-3f984b167d05",
"documentVersion": "1.61"
}
},
"context": {
"device": { // client browser
"type": "PC",
"screenResolution": { },
"roleInstance": "WFWEB14B.fabrikam.net"
},
"application": { },
"location": { // derived from client ip
"continent": "North America",
"country": "United States",
// last octagon is anonymized to 0 at portal:
"clientip": "168.62.177.0",
"province": "",
"city": ""
},
"data": {
"isSynthetic": true, // we identified source as a bot
// percentage of generated data sent to portal:
"samplingRate": 100.0,
"eventTime": "2016-03-21T10:05:45.7334717Z" // UTC
},
"user": {
"isAuthenticated": false,
"anonId": "us-tx-sn1-azr", // bot agent id
"anonAcquisitionDate": "0001-01-01T00:00:00Z",
"authAcquisitionDate": "0001-01-01T00:00:00Z",
"accountAcquisitionDate": "0001-01-01T00:00:00Z"
},
"operation": {
"id": "fCOhCdCnZ9I=",
"parentId": "fCOhCdCnZ9I=",
"name": "GET Home/Index"
},
"cloud": { },
"serverDevice": { },
"custom": { // set by custom fields of track calls
"dimensions": [ ],
"metrics": [ ]
},
"session": {
"id": "65504c10-44a6-489e-b9dc-94184eb00d86",
"isFirst": true
}
}
}
Kontext
Všechny typy telemetrie jsou doprovázeny kontextovou částí. Ne všechna tato pole se přenášejí s každým datovým bodem.
Cesta | Typ | Poznámky |
---|---|---|
context.custom.dimensions [0] | objekt [ ] | Páry řetězce klíč-hodnota nastavené pomocí parametru vlastních vlastností. Maximální délka klíče 100, hodnoty max délka 1024. Vlastnost lze prohledávat více než 100 jedinečných hodnot, ale nelze ji použít pro segmentaci. Maximálně 200 kláves na ikey. |
context.custom.metrics [0] | objekt [ ] | Páry klíč-hodnota nastavené pomocí vlastního parametru měření a trackmetrics. Maximální délka klíče 100, hodnoty můžou být číselné. |
context.data.eventTime | řetězec | UTC |
context.data.isSynthetic | boolean | Zdá se, že požadavek pochází z robota nebo webového testu. |
context.data.samplingRate | číslo | Procento telemetrie vygenerované sadou SDK odesílanou na portál Rozsah 0,0–100,0. |
context.device | object | Klientské zařízení |
context.device.browser | řetězec | IE, Chrome, ... |
context.device.browserVersion | řetězec | Chrome 48.0, ... |
context.device.deviceModel | řetězec | |
context.device.deviceName | řetězec | |
context.device.id | řetězec | |
context.device.locale | řetězec | en-GB, de-DE, ... |
context.device.network | řetězec | |
context.device.oemName | řetězec | |
context.device.os | řetězec | |
context.device.osVersion | řetězec | Hostitelský operační systém |
context.device.roleInstance | řetězec | ID hostitele serveru |
context.device.roleName | řetězec | |
context.device.screenResolution | řetězec | |
context.device.type | řetězec | POČÍTAČ, prohlížeč, ... |
context.location | object | Odvozeno z clientip . |
context.location.city | řetězec | Odvozeno z clientip , pokud je znám |
context.location.clientip | řetězec | Poslední osmiúhelník se anonymizuje na 0. |
context.location.continent | řetězec | |
context.location.country | řetězec | |
context.location.province | řetězec | Stát nebo kraj |
context.operation.id | řetězec | Položky, které mají stejné operation id položky, se na portálu zobrazí jako Související položky. Obvykle .request id |
context.operation.name | řetězec | adresa URL nebo název požadavku |
context.operation.parentId | řetězec | Umožňuje vnořené související položky. |
context.session.id | řetězec | Id skupiny operací ze stejného zdroje. Období 30 minut bez operace signalizuje konec relace. |
context.session.isFirst | boolean | |
context.user.accountAcquisitionDate | řetězec | |
context.user.accountId | řetězec | |
context.user.anonAcquisitionDate | řetězec | |
context.user.anonId | řetězec | |
context.user.authAcquisitionDate | řetězec | Ověřený uživatel |
context.user.authId | řetězec | |
context.user.isAuthenticated | boolean | |
context.user.storeRegion | řetězec | |
internal.data.documentVersion | řetězec | |
internal.data.id | řetězec | Unique id přiřazená při ingestované položce do Application Insights |
Událost
Vlastní události generované nástrojem TrackEvent()
Cesta | Typ | Poznámky |
---|---|---|
event [0] count | integer | 100/(vzorkovací frekvence). Například 4 => 25 %. |
název události [0] | řetězec | Název události. Maximální délka 250. |
adresa URL události [0] | řetězec | |
událost [0] urlData.base | řetězec | |
událost [0] urlData.host | řetězec |
Výjimky
Hlásí výjimky na serveru a v prohlížeči.
Cesta | Typ | Poznámky |
---|---|---|
basicException [0] – sestavení | řetězec | |
basicException [0] count | integer | 100/(vzorkovací frekvence). Například 4 => 25 %. |
basicException [0] exceptionGroup | řetězec | |
basicException [0] exceptionType | řetězec | |
basicException [0] failedUserCodeMethod | řetězec | |
basicException [0] failedUserCodeAssembly | řetězec | |
basicException [0] handledAt | řetězec | |
basicException [0] hasFullStack | boolean | |
basicException [0] id |
řetězec | |
Metoda basicException [0] | řetězec | |
basicException [0] zpráva | řetězec | Zpráva o výjimce. Maximální délka 10k. |
basicException [0] outerExceptionMessage | řetězec | |
basicException [0] outerExceptionThrownAtAssembly | řetězec | |
basicException [0] outerExceptionThrownAtMethod | řetězec | |
basicException [0] outerExceptionType | řetězec | |
basicException [0] outerId | řetězec | |
basicException [0] parsedStack [0] sestavení | řetězec | |
basicException [0] parsedStack [0] fileName | řetězec | |
basicException [0] parsedStack [0] úroveň | integer | |
basicException [0] parsedStack [0] řádek | integer | |
metoda basicException [0] parsedStack [0] | řetězec | |
basicException [0] zásobník | řetězec | Maximální délka 10 tisíc |
basicException [0] typeName | řetězec |
Trasování zpráv
Odesílají trackTrace a protokolovací adaptéry.
Cesta | Typ | Poznámky |
---|---|---|
message [0] loggerName | řetězec | |
message [0] parameters | řetězec | |
zpráva [0] raw | řetězec | Zpráva protokolu, maximální délka 10 tisíc. |
message [0] severityLevel | řetězec |
Vzdálená závislost
Odeslal(a) TrackDependency. Slouží k hlášení výkonu a využití volání závislostí na serveru a volání AJAX v prohlížeči.
Žádosti
Odesláno trackRequest. Standardní moduly ho používají k hlášení doby odezvy serveru měřené na serveru.
Výkon zobrazení stránky
Odesláno prohlížečem. Měří čas zpracování stránky od zahájení požadavku uživatelem na zobrazení dokončení (s výjimkou asynchronních volání AJAX).
Kontextové hodnoty zobrazují verzi operačního systému klienta a prohlížeče.
Cesta | Typ | Poznámky |
---|---|---|
clientPerformance [0] clientProcess.value | integer | Čas od konce přijetí kódu HTML do zobrazení stránky. |
clientPerformance [0] name | řetězec | |
clientPerformance [0] networkConnection.value | integer | Doba potřebná k navázání síťového připojení |
clientPerformance [0] receiveRequest.value | integer | Čas od konce odeslání požadavku do přijetí kódu HTML v odpovědi. |
clientPerformance [0] sendRequest.value | integer | Doba potřebná k odeslání požadavku HTTP |
clientPerformance [0] total.value | integer | Čas od zahájení odesílání požadavku do zobrazení stránky. |
clientPerformance [0] url | řetězec | Adresa URL tohoto požadavku |
clientPerformance [0] urlData.base | řetězec | |
clientPerformance [0] urlData.hashTag | řetězec | |
clientPerformance [0] urlData.host | řetězec | |
clientPerformance [0] urlData.protocol | řetězec |
Page Views
Odesláno trackPageView() nebo stopTrackPage
Dostupnost
Hlásí webové testy dostupnosti.
Metriky
Vygenerováno pomocí TrackMetric().
Hodnota metriky se nachází v context.custom.metrics[0]
Příklad:
{
"metric": [ ],
"context": {
...
"custom": {
"dimensions": [
{ "ProcessId": "4068" }
],
"metrics": [
{
"dispatchRate": {
"value": 0.001295,
"count": 1.0,
"min": 0.001295,
"max": 0.001295,
"stdDev": 0.0,
"sampledValue": 0.001295,
"sum": 0.001295
}
}
]
}
}
}
Informace o hodnotách metrik
Hodnoty metrik, jak v sestavách metrik, tak i jinde, se hlásí se standardní strukturou objektů. Příklad:
"durationMetric": {
"name": "contoso.org",
"type": "Aggregation",
"value": 468.71603053650279,
"count": 1.0,
"min": 468.71603053650279,
"max": 468.71603053650279,
"stdDev": 0.0,
"sampledValue": 468.71603053650279
}
V současné době ( i když se to může v budoucnu změnit) ve všech hodnotách hlášených ze standardních modulů count==1
sady SDK a pouze name
pole a value
jsou užitečná. Jediným případem, kdy by se liší, by bylo, kdybyste napsali vlastní volání TrackMetric, ve kterých nastavíte ostatní parametry.
Účelem ostatních polí je umožnit agregaci metrik v sadě SDK, aby se snížil provoz na portálu. Můžete například před odesláním každé sestavy metriky zprůměrovat několik po sobě jdoucích čtení. Pak byste vypočítali minimální, maximální, směrodatnou odchylku a agregační hodnotu (součet nebo průměr) a nastavili počet na počet čtení reprezentovaných sestavou.
Ve výše uvedených tabulkách jsme vynechali počet zřídka používaných polí, min, max, stdDev a sampledValue.
Místo předběžné agregace metrik můžete použít vzorkování , pokud potřebujete snížit objem telemetrie.
Doby trvání
Pokud není uvedeno jinak, jsou doby trvání vyjádřeny v desetinách mikrosekundy, takže hodnota 10000000,0 znamená 1 sekundu.