Export telemetrie z Application InsightsExport telemetry from Application Insights

Chcete udržet telemetrii déle než standardní doba uchovávání?Want to keep your telemetry for longer than the standard retention period? Nebo ji zpracujete specializovaným způsobem?Or process it in some specialized way? Pro tuto dobu je ideální pro průběžný export.Continuous Export is ideal for this. Události, které vidíte na portálu Application Insights, se dají exportovat do úložiště v Microsoft Azure ve formátu JSON.The events you see in the Application Insights portal can be exported to storage in Microsoft Azure in JSON format. Odtud si můžete stáhnout svá data a napsat kód, který budete potřebovat k jeho zpracování.From there, you can download your data and write whatever code you need to process it.

Poznámka

Průběžný export podporují pouze klasické prostředky Application Insights.Continuous export is only supported for classic Application Insights resources. Prostředky Application Insights založené na pracovním prostoru musí používat nastavení diagnostiky.Workspace-based Application Insights resources must use diagnostic settings.

Před nastavením průběžného exportu je možné zvážit několik možností:Before you set up continuous export, there are some alternatives you might want to consider:

Po průběžném exportu kopíruje vaše data do úložiště (kde může zůstat tak dlouho, jak budete chtít), je stále k dispozici v Application Insights pro obvyklou dobu uchování.After Continuous Export copies your data to storage (where it can stay for as long as you like), it's still available in Application Insights for the usual retention period.

Průběžný export – Pokročilá konfigurace úložištěContinuous Export advanced storage configuration

Průběžný export nepodporuje následující funkce a konfigurace služby Azure Storage:Continuous Export does not support the following Azure storage features/configurations:

Vytvoření průběžného exportuCreate a Continuous Export

  1. V Application Insights prostředek pro aplikaci v části konfigurovat na levé straně otevřete průběžný export a klikněte na Přidat:In the Application Insights resource for your app under configure on the left, open Continuous Export and choose Add:

  2. Vyberte datové typy telemetrie, které chcete exportovat.Choose the telemetry data types you want to export.

  3. Vytvořte nebo vyberte účet služby Azure Storage , do kterého chcete ukládat data.Create or select an Azure storage account where you want to store the data. Další informace o cenových možnostech úložiště najdete na stránce oficiálních cen.For more information on storage pricing options, visit the official pricing page.

    Klikněte na Přidat, exportovat cíl, účet úložiště a pak buď vytvořte nové úložiště, nebo vyberte existující úložiště.Click Add, Export Destination, Storage account, and then either create a new store or choose an existing store.

    Upozornění

    Ve výchozím nastavení bude umístění úložiště nastaveno na stejnou geografickou oblast jako prostředek Application Insights.By default, the storage location will be set to the same geographical region as your Application Insights resource. Pokud ukládáte do jiné oblasti, můžete účtovat poplatky za přenos.If you store in a different region, you may incur transfer charges.

  4. Vytvořte nebo vyberte kontejner v úložišti.Create or select a container in the storage.

Poznámka

Po vytvoření exportu začnou nově přijímaná data zacházet do služby Azure Blob Storage.Once you've created your export, newly ingested data will begin to flow to Azure Blob storage. Průběžný export bude přenášet jenom novou telemetrii, která se vytvoří nebo ingestuje po povolení průběžného exportu.Continuous export will only transmit new telemetry that is created/ingested after continuous export was enabled. Žádná data, která existovala před povolením průběžného exportu, se neexportují, a neexistuje žádný podporovaný způsob, jak s využitím průběžného exportu zpětně exportovat dříve vytvořená data.Any data that existed prior to enabling continuous export will not be exported, and there is no supported way to retroactively export previously created data using continuous export.

Může to trvat přibližně hodinu, než se data objeví v úložišti.There can be a delay of about an hour before data appears in the storage.

Po dokončení prvního exportu najdete v kontejneru úložiště objektů BLOB v Azure strukturu podobnou následující: (Tato operace se bude lišit v závislosti na shromažďovaných datech.)Once the first export is complete you will find a structure similar to the following in your Azure Blob storage container: (This will vary depending on the data you are collecting.)

NázevName PopisDescription
DostupnostAvailability Oznamuje webové testy dostupnosti.Reports availability web tests.
UdálostEvent Vlastní události generované TrackEvent ().Custom events generated by TrackEvent().
VýjimkyExceptions Oznamuje výjimky na serveru a v prohlížeči.Reports exceptions in the server and in the browser.
ZprávyMessages Odesílá TrackTracea adaptéry protokolování.Sent by TrackTrace, and by the logging adapters.
MetrikyMetrics Vygenerováno voláními rozhraní API metriky.Generated by metric API calls.
Čítače výkonuPerformanceCounters Čítače výkonu shromážděné nástrojem Application Insights.Performance Counters collected by Application Insights.
ŽádostiRequests Odesílá TrackRequest.Sent by TrackRequest. Standardní moduly tuto metodu používají k hlášení doby odezvy serveru měřenou na serveru.The standard modules use this to reports server response time, measured at the server.

Úprava průběžného exportuTo edit continuous export

Klikněte na průběžný export a vyberte účet úložiště, který chcete upravit.Click on continuous export and select the storage account to edit.

Zastavení průběžného exportuTo stop continuous export

Pokud chcete export zastavit, klikněte na zakázat.To stop the export, click Disable. Když znovu kliknete na tlačítko Povolit, export se restartuje s novými daty.When you click Enable again, the export will restart with new data. Data, která se dostanou na portálu, se nezobrazí, když je export zakázaný.You won't get the data that arrived in the portal while export was disabled.

Pokud chcete export zastavit trvale, odstraňte ho.To stop the export permanently, delete it. Tím nedojde k odstranění dat ze služby Storage.Doing so doesn't delete your data from storage.

Nelze přidat nebo změnit export?Can't add or change an 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.To add or change exports, you need Owner, Contributor, or Application Insights Contributor access rights. Přečtěte si o rolích.Learn about roles.

Jaké události získáte?What events do you get?

Exportovaná data jsou nezpracovaná telemetrie z vaší aplikace, s výjimkou toho, že přidáváme data o umístění, která počítáme z IP adresy klienta.The exported data is the raw telemetry we receive from your application, except that we add location data, which we calculate from the client IP address.

Data Zahozená vzorkováním nejsou obsažena v exportovaných datech.Data that has been discarded by sampling is not included in the exported data.

Jiné počítané metriky nejsou zahrnuty.Other calculated metrics are not included. Nebudete třeba exportovat průměrné využití procesoru, ale vyexportujeme nezpracované telemetrie, ze které se vypočítá průměr.For example, we don't export average CPU utilization, but we do export the raw telemetry from which the average is computed.

Data také obsahují výsledky všech webových testů dostupnosti , které jste nastavili.The data also includes the results of any availability web tests that you have set up.

Poznámka

Kontrol.Sampling. Pokud vaše aplikace odesílá velké množství dat, může se aktivovat funkce vzorkování, která bude odesílat pouze zlomek generované telemetrie.If your application sends a lot of data, the sampling feature may operate and send only a fraction of the generated telemetry. Další informace o vzorkování.Learn more about sampling.

Kontrola datInspect the data

Úložiště si můžete prohlédnout přímo na portálu.You can inspect the storage directly in the portal. V levém horním rohu klikněte na domů v horní části, kde se říká "služby Azure" vybrat účty úložiště, vyberte název účtu úložiště, na stránce Přehled vyberte objekty blob v části služby a nakonec vyberte název kontejneru.Click home in the leftmost menu, at the top where it says "Azure services" select Storage accounts, select the storage account name, on the overview page select Blobs under services, and finally select the container name.

Chcete-li zkontrolovat službu Azure Storage v aplikaci Visual Studio, otevřete zobrazení, Průzkumník cloudu.To inspect Azure storage in Visual Studio, open View, Cloud Explorer. (Pokud nemáte příkaz nabídky, musíte nainstalovat sadu Azure SDK: otevřete dialogové okno Nový projekt , rozbalte položku Visual C#/Cloud a vyberte možnost získat Microsoft Azure SDK pro .NET.)(If you don't have that menu command, you need to install the Azure SDK: Open the New Project dialog, expand Visual C#/Cloud and choose Get Microsoft Azure SDK for .NET.)

Po otevření úložiště objektů BLOB se zobrazí kontejner se sadou souborů objektů BLOB.When you open your blob store, you'll see a container with a set of blob files. Identifikátor URI jednotlivých souborů odvozený od názvu prostředku Application Insights, jeho klíče instrumentace, typu telemetrie/data a času.The URI of each file derived from your Application Insights resource name, its instrumentation key, telemetry-type/date/time. (Název prostředku je malými písmeny a klíč instrumentace vynechává pomlčky.)(The resource name is all lowercase, and the instrumentation key omits dashes.)

Kontrola úložiště objektů BLOB pomocí vhodného nástroje

Datum a čas jsou UTC a jsou v době, kdy byla telemetrie uložena do úložiště – ne za čas, který byl vygenerován.The date and time are UTC and are when the telemetry was deposited in the store - not the time it was generated. Takže pokud napíšete kód pro stažení dat, může se pomocí dat pohybovat lineárně.So if you write code to download the data, it can move linearly through the data.

Tady je forma cesty:Here's the form of the path:

$"{applicationName}_{instrumentationKey}/{type}/{blobDeliveryTimeUtc:yyyy-MM-dd}/{ blobDeliveryTimeUtc:HH}/{blobId}_{blobCreationTimeUtc:yyyyMMdd_HHmmss}.blob"

KdeWhere

  • blobCreationTimeUtcje čas, kdy byl objekt BLOB vytvořen v interním přípravném úložišti.blobCreationTimeUtc is the time when blob was created in the internal staging storage
  • blobDeliveryTimeUtcje čas, kdy se objekt BLOB kopíruje do cílového úložiště pro exportblobDeliveryTimeUtc is the time when blob is copied to the export destination storage

Formát datData format

  • Každý objekt BLOB je textový soubor, který obsahuje více řádků oddělených znakem \n.Each blob is a text file that contains multiple '\n'-separated rows. Obsahuje telemetrii zpracovávanou za časové období zhruba půl minuty.It contains the telemetry processed over a time period of roughly half a minute.

  • Každý řádek představuje datový bod telemetrie, jako je například požadavek nebo zobrazení stránky.Each row represents a telemetry data point such as a request or page view.

  • Každý řádek je neformátovaný dokument JSON.Each row is an unformatted JSON document. Chcete-li zobrazit řádky, otevřete objekt BLOB v aplikaci Visual Studio a vyberte možnost Upravit > Rozšířené > soubory formátu:If you want to view the rows, open the blob in Visual Studio and choose Edit > Advanced > Format File:

    Zobrazení telemetrie s vhodným nástrojem

Doba trvání se nachází v taktech, kde 10 000 taktes = 1 ms.Time durations are in ticks, where 10 000 ticks = 1 ms. Například tyto hodnoty zobrazují čas 1 MS k odeslání požadavku z prohlížeče, 3 MS pro příjem a 1,8 s pro zpracování stránky v prohlížeči:For example, these values show a time of 1 ms to send a request from the browser, 3 ms to receive it, and 1.8 s to process the page in the browser:

"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}

Podrobný odkaz na datový model pro typy a hodnoty vlastností.Detailed data model reference for the property types and values.

Zpracování datProcessing the data

V malém měřítku můžete napsat nějaký kód, který bude odčítat vaše data, číst je do tabulky a tak dále.On a small scale, you can write some code to pull apart your data, read it into a spreadsheet, and so on. Například:For example:

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.For a larger code sample, see using a worker role.

Odstranit stará dataDelete your old data

Zodpovídáte za správu kapacity úložiště a odstranění starých dat v případě potřeby.You are responsible for managing your storage capacity and deleting the old data if necessary.

Pokud znovu vygenerujete klíč úložiště...If you regenerate your storage key...

Pokud změníte klíč k vašemu úložišti, průběžný export přestane fungovat.If you change the key to your storage, continuous export will stop working. Ve vašem účtu Azure se zobrazí oznámení.You'll see a notification in your Azure account.

Otevřete kartu Průběžný export a upravte export.Open the Continuous Export tab and edit your export. Upravte Cíl exportu, ale ponechte vybrané stejné úložiště.Edit the Export Destination, but just leave the same storage selected. Kliknutím na OK potvrďte provedené změny.Click OK to confirm.

Průběžný export se restartuje.The continuous export will restart.

Exportovat ukázkyExport samples

V případě větších škálování zvažte clustery HDInsight -Hadoop v cloudu.On larger scales, consider HDInsight - Hadoop clusters in the cloud. HDInsight poskytuje různé technologie pro správu a analýzu velkých objemů dat a můžete ji použít ke zpracování dat exportovaných z Application Insights.HDInsight provides a variety of technologies for managing and analyzing big data, and you could use it to process data that has been exported from Application Insights.

Otázky a odpovědiQ & A

  • Ale stačí jednorázové stažení grafu.But all I want is a one-time download of a chart.

    Ano, můžete to udělat.Yes, you can do that. V horní části karty klikněte na exportovat data.At the top of the tab, click Export Data.

  • Nastavil (a) export, ale ve Storu nejsou žádná data.I set up an export, but there's no data in my store.

    Dostala se Application Insights od vaší aplikace získat veškerou telemetrii od chvíle, kdy jste nastavili export?Did Application Insights receive any telemetry from your app since you set up the export? Dostanete jenom nová data.You'll only receive new data.

  • Při pokusu o nastavení exportu byl odepřen přístup.I tried to set up an export, but was denied access

    Pokud účet vlastní vaše organizace, musíte být členem skupin vlastníci nebo přispěvatelé.If the account is owned by your organization, you have to be a member of the owners or contributors groups.

  • Můžu exportovat přímo do vlastního místního úložiště?Can I export straight to my own on-premises store?

    Ne, je nám líto.No, sorry. Náš Exportní modul v tuto chvíli funguje jenom s Azure Storage.Our export engine currently only works with Azure storage at this time.

  • Existuje nějaké omezení množství dat, které jste umístili do Storu?Is there any limit to the amount of data you put in my store?

    Ne.No. Data budeme uchovávat, dokud neodstraníte export.We'll keep pushing data in until you delete the export. Zastavíme se, pokud máme vnější omezení pro úložiště objektů blob, ale to je poměrně velké.We'll stop if we hit the outer limits for blob storage, but that's pretty huge. Můžete určit, kolik úložiště používáte.It's up to you to control how much storage you use.

  • Kolik objektů BLOB se má v úložišti zobrazit?How many blobs should I see in the storage?

    • Pro každý datový typ, který jste vybrali k exportu, se vytvoří nový objekt BLOB každou minutu (pokud jsou k dispozici data).For every data type you selected to export, a new blob is created every minute (if data is available).
    • Pro aplikace s vysokým provozem jsou navíc přiděleny další jednotky oddílu.In addition, for applications with high traffic, additional partition units are allocated. V takovém případě každá jednotka vytvoří objekt BLOB každou minutu.In this case, each unit creates a blob every minute.
  • Znovu vygeneroval (a) klíč do úložiště nebo změnil název kontejneru a teď export nefunguje.I regenerated the key to my storage or changed the name of the container, and now the export doesn't work.

    Upravte export a otevřete kartu exportovat cíl. ponechte stejné úložiště jako předtím a kliknutím na OK potvrďte.Edit the export and open the export destination tab. Leave the same storage selected as before, and click OK to confirm. Export se restartuje.Export will restart. Pokud byla změna během posledních několika dní, ztratíte data.If the change was within the past few days, you won't lose data.

  • Můžu pozastavit export?Can I pause the export?

    Yes.Yes. Klikněte na Zakázat.Click Disable.

Ukázky kódůCode samples