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é

Před nastavením průběžného exportu můžete zvážit několik alternativ:

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:

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.

  1. 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.

  2. Zvolte datové typy telemetrie, které chcete exportovat.

  3. 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.

  4. 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 na 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. V době, kdy byl export zakázán, se nezobrazí data, která přišla na portál.

Pokud chcete export trvale zastavit, odstraňte ho. Tím nedojde k odstranění 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. Přečtěte si o rolích.

Jaké události obdrží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, která byla zahozena vzorkováním , nejsou zahrnuta v exportovaných datech.

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 zahrnují také 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ího klíče a typu telemetrie, data a času. Název prostředku je všechna malá písmena a instrumentační klíč vynechá pomlčky.

Snímek obrazovky znázorňující kontrolu úložiště objektů blob pomocí vhodného nástroje

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.

Datum a čas jsou UTC a jsou okamžikem uložení telemetrie do úložiště, nikoli časem, kdy byla vygenerována. Z tohoto důvodu, pokud napíšete kód pro stažení dat, může se data 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 řádky. Obsahuje telemetrii zpracovávanou během časového období zhruba půl minuty.

  • Každý řádek představuje datový bod telemetrie, například žádost 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.

    Snímek obrazovky znázorňující zobrazení telemetrie pomocí vhodného nástroje

Doba trvání je v ticích, kde 10 000 klíštěte = 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é informace o datovém modelu pro typy a hodnoty vlastností najdete v tématu Export datového modelu Application Insights.

Zpracování dat

V malém měřítku můžete napsat kód, který rozdělí data a přeč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

V případě potřeby zodpovídáte za správu kapacity úložiště a odstranění starých dat.

Opětovné vygenerování klíče ú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.

Q & A

Tato část obsahuje odpovědi na běžné otázky.

Můžu si graf jednorázově stáhnout?

Můžete to udělat. V horní části karty vyberte Exportovat data.

Nastavil(a) jsem export, ale proč v obchodě nejsou žádná data?

Obdržela Služba Application Insights od nastavení exportu z vaší aplikace nějakou telemetrii? Budete dostávat 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 skupin Vlastníci nebo Přispěvatelé.

Můžu exportovat přímo do vlastního místního obchodu?

No. Náš exportní modul v současné době funguje jenom se službou Azure Storage.

Je 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. Pokud dosáhneme vnějších limitů služby Blob Storage, zastavíme se, 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 každou minutu vytvoří nový objekt blob, pokud jsou data k dispozici.
  • Pro aplikace s vysokým provozem se přidělují další jednotky oddílů. V tomto případě každá jednotka vytvoří objekt blob každou minutu.

Vygeneroval(a) jsem klíč do úložiště nebo změnil(a) název kontejneru, ale proč export nefunguje?

Upravte export a vyberte kartu Exportovat cíl . Ponechte stejné úložiště vybrané jako předtím a potvrďte to 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ů

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é

Kvůli zvýšenému počtu volání do cíle, jako je účet úložiště, můžou vzniknout další náklady.

Pokud chcete migrovat na nastavení diagnostiky, export:

  1. Zakažte aktuální průběžný export.
  2. Migrujte aplikaci do pracovního prostoru.
  3. Povolte export nastavení diagnostiky. V rámci prostředku Application Insights vyberte Nastavení>diagnostiky Přidat nastavení diagnostiky .

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 stejný pracovní prostor služby Log Analytics, na který je váš prostředek Application Insights založený.
  • 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 Application Insights přistupuje k telemetrii napříč prostředky Application Insight, včetně pracovních prostorů služby Log Analytics, a poskytuje tak kompletní transakční operace a přesné mapy aplikací. Vzhledem k tomu, že diagnostické protokoly používají stejné názvy tabulek, je možné zobrazit duplicitní telemetrii, 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í.

Odkazuje na poznámku:

  • [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
zpráva basicException [0] ř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 10k
basicException [0] typeName řetězec

Trasování zpráv

Odesílají trackTrace a adaptéry protokolování.

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 10k.
message [0] severityLevel řetězec

Vzdálená závislost

Odeslal(a) TrackDependency. Používá se k hlášení výkonu a využití volání závislostí na serveru a volání AJAX v prohlížeči.

Cesta Typ Poznámky
remoteDependency [0] async boolean
remoteDependency [0] baseName řetězec
remoteDependency [0] název_příkazu řetězec Například "home/index"
remoteDependency [0] count integer 100/(vzorkovací frekvence). Například 4 => 25 %.
remoteDependency [0] dependencyTypeName řetězec HTTP, SQL, ...
remoteDependency [0] durationMetric.value číslo Čas od volání do dokončení odpovědi podle závislosti
remoteDependency [0] id řetězec
remoteDependency [0] název řetězec Adresu url. Maximální délka 250.
remoteDependency [0] resultCode řetězec ze závislosti HTTP
remoteDependency [0] úspěch boolean
remoteDependency [0] – typ řetězec Http, Sql,...
remoteDependency [0] adresa URL řetězec Maximální délka 2000
remoteDependency [0] urlData.base řetězec Maximální délka 2000
remoteDependency [0] urlData.hashTag řetězec
remoteDependency [0] urlData.host řetězec Maximální délka 200

Žádosti

Odeslal TrackRequest. Standardní moduly to používají k hlášení doby odezvy serveru měřené na serveru.

Cesta Typ Poznámky
počet požadavků [0] integer 100/(vzorkovací frekvence). Příklad: 4 => 25 %.
request [0] durationMetric.value číslo Čas od přijetí požadavku do odpovědi. 1e7 == 1s
žádost [0] id řetězec Operation id
název žádosti [0] řetězec GET/POST + základ adresy URL. Maximální délka 250
request [0] responseCode integer Odpověď HTTP odeslaná klientovi
žádost [0] úspěch boolean Výchozí == (kód < odpovědi 400)
adresa URL požadavku [0] řetězec Nezahrnuje hostitele
request [0] urlData.base řetězec
request [0] urlData.hashTag řetězec
request [0] urlData.host řetězec

Výkon zobrazení stránky

Odesláno prohlížečem. Měří čas zpracování stránky od zahájení požadavku uživatelem k zobrazení dokončeného (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 Čas potřebný k odeslání požadavku HTTP.
clientPerformance [0] total.value integer Čas od zahájení odesílání požadavku na 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

Cesta Typ Poznámky
počet zobrazení [0] integer 100/(vzorkovací frekvence). Například 4 => 25 %.
zobrazení [0] durationMetric.value integer Hodnota, která je volitelně nastavená v trackPageView() nebo startTrackPage() – stopTrackPage(). Ne stejné jako hodnoty clientPerformance.
název zobrazení [0] řetězec Název stránky. Maximální délka 250
zobrazit adresu URL [0] řetězec
view [0] urlData.base řetězec
zobrazení [0] urlData.hashTag řetězec
view [0] urlData.host řetězec

Dostupnost

Hlásí webové testy dostupnosti.

Cesta Typ Poznámky
dostupnost [0] availabilityMetric.name řetězec dostupnosti
availability [0] availabilityMetric.value číslo 1.0 nebo 0.0
počet dostupnosti [0] integer Vzorkovací frekvence 100/(). Například 4 => 25 %.
dostupnost [0] dataSizeMetric.name řetězec
availability [0] dataSizeMetric.value integer
dostupnost [0] durationMetric.name řetězec
availability [0] durationMetric.value číslo Doba trvání testu. 1e7==1s
zpráva o dostupnosti [0] řetězec Diagnostika selhání
dostupnost [0] výsledek řetězec Úspěch/neúspěch
dostupnost [0] runLocation řetězec Geografický zdroj http req
dostupnost [0] testName řetězec
availability [0] testRunId řetězec
dostupnost [0] testTimestamp řetězec

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, jsou ve všech hodnotách hlášených ze standardních modulů count==1 SADY SDK užitečné pouze name pole a value . Jediným případem, kdy by se odlišily, 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. Před odesláním každé sestavy metrik můžete například 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.

Viz také