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

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

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

Č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ů

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:

  1. Povolte nastavení diagnostiky v klasické službě Application Insights.
  2. Konfigurace exportu dat: Vyberte Nastavení> diagnostikyPřidat nastavení diagnostiky v rámci prostředku Application Insights.
  3. 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.

Cesta Typ Poznámky
remoteDependency [0] async boolean
remoteDependency [0] baseName řetězec
remoteDependency [0] commandName řetězec Například "home/index"
remoteDependency [0] count integer Vzorkovací frekvence 100/(). Například 4 => 25 %.
remoteDependency [0] dependencyTypeName řetězec HTTP, SQL, ...
remoteDependency [0] durationMetric.value číslo Doba od volání po dokončení odpovědi podle závislosti
remoteDependency [0] id řetězec
remoteDependency [0] name ř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

Odesláno trackRequest. Standardní moduly ho používají k hlášení doby odezvy serveru měřené na serveru.

Cesta Typ Poznámky
request [0] count integer Vzorkovací frekvence 100/(). 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
request [0] name řetězec GET/POST + url base. Maximální délka 250
request [0] responseCode integer Odpověď HTTP odeslaná klientovi
úspěch požadavku [0] 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 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

Cesta Typ Poznámky
počet zobrazení [0] integer Vzorkovací frekvence 100/(). Například 4 => 25 %.
view [0] durationMetric.value integer Hodnota je volitelně nastavená v trackPageView() nebo pomocí parametru startTrackPage() – stopTrackPage(). Není to stejné jako hodnoty clientPerformance.
view [0] name řetězec Název stránky. Maximální délka 250
zobrazit [0] url řetězec
view [0] urlData.base řetězec
view [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
dostupnost [0] počet 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) 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.

Viz také