Telemetrie exporteren uit Application InsightsExport telemetry from Application Insights

Wilt u de telemetrie langer houden dan de standaard retentie periode?Want to keep your telemetry for longer than the standard retention period? Of verwerk het op een specifieke manier?Or process it in some specialized way? Continue export is ideaal voor dit.Continuous Export is ideal for this. De gebeurtenissen die u in de Application Insights Portal ziet, kunnen worden geëxporteerd naar de opslag in Microsoft Azure in JSON-indeling.The events you see in the Application Insights portal can be exported to storage in Microsoft Azure in JSON format. Van daaruit kunt u uw gegevens downloaden en de code schrijven die u nodig hebt om deze te verwerken.From there, you can download your data and write whatever code you need to process it.

Voordat u doorlopend exporteren instelt, zijn er enkele alternatieven die u wellicht wilt overwegen:Before you set up continuous export, there are some alternatives you might want to consider:

Nadat u uw gegevens hebt gekopieerd naar de opslag ruimte (waar u deze zo lang mogelijk kunt blijven), is deze nog steeds beschikbaar in Application Insights voor de gebruikelijke Bewaar periode.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.

Geavanceerde opslag configuratie voor continue exportContinuous Export advanced storage configuration

Continue export biedt geen ondersteuning voor de volgende functies/configuraties van Azure Storage:Continuous Export does not support the following Azure storage features/configurations:

Een continue export makenCreate a Continuous Export

  1. Open in de resource Application Insights voor uw app onder configureren aan de linkerkant de optie doorlopend exporteren en kies toevoegen:In the Application Insights resource for your app under configure on the left, open Continuous Export and choose Add:

  2. Kies de gegevens typen voor telemetrie die u wilt exporteren.Choose the telemetry data types you want to export.

  3. Maak of selecteer een Azure Storage-account waar u de gegevens wilt opslaan.Create or select an Azure storage account where you want to store the data. Ga naar de pagina met officiële prijzenvoor meer informatie over de opties voor opslag prijzen.For more information on storage pricing options, visit the official pricing page.

    Klik op toevoegen, bestemming exporteren, opslag account en vervolgens een nieuwe winkel maken of een bestaande Store kiezen.Click Add, Export Destination, Storage account, and then either create a new store or choose an existing store.

    Waarschuwing

    De opslag locatie wordt standaard ingesteld op dezelfde geografische regio als uw Application Insights-resource.By default, the storage location will be set to the same geographical region as your Application Insights resource. Als u in een andere regio opslaat, kunnen er kosten in rekening worden gebracht.If you store in a different region, you may incur transfer charges.

  4. Maak of selecteer een container in de opslag.Create or select a container in the storage.

Zodra u uw export hebt gemaakt, wordt deze gestart.Once you've created your export, it starts going. U ontvangt alleen gegevens die binnenkomen nadat u de export hebt gemaakt.You only get data that arrives after you create the export.

Er kan een vertraging van ongeveer een uur optreden voordat de gegevens in de opslag worden weer gegeven.There can be a delay of about an hour before data appears in the storage.

Continue export bewerkenTo edit continuous export

Klik op doorlopend exporteren en selecteer het opslag account dat u wilt bewerken.Click on continuous export and select the storage account to edit.

Continue export stoppenTo stop continuous export

Als u het exporteren wilt stoppen, klikt u op uitschakelen.To stop the export, click Disable. Wanneer u nogmaals op inschakelen klikt, wordt het exporteren opnieuw gestart met nieuwe gegevens.When you click Enable again, the export will restart with new data. De gegevens die in de portal zijn ontvangen, worden niet weer gegeven terwijl het exporteren is uitgeschakeld.You won't get the data that arrived in the portal while export was disabled.

Als u de export permanent wilt stoppen, verwijdert u deze.To stop the export permanently, delete it. Hierdoor worden uw gegevens niet verwijderd uit de opslag.Doing so doesn't delete your data from storage.

Kunt u een export niet toevoegen of wijzigen?Can't add or change an export?

  • Als u exports wilt toevoegen of wijzigen, hebt u de machtiging voor eigenaar, bijdrager of Application Insights Inzender nodig.To add or change exports, you need Owner, Contributor, or Application Insights Contributor access rights. Meer informatie over rollen.Learn about roles.

Welke gebeurtenissen krijgt u?What events do you get?

De geëxporteerde gegevens zijn de ruwe telemetriegegevens die we van uw toepassing ontvangen, behalve dat er locatie gegevens worden toegevoegd die worden berekend op basis van het IP-adres van de client.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.

Gegevens die zijn verwijderd door middel van steek proeven , worden niet opgenomen in de geëxporteerde gegevens.Data that has been discarded by sampling is not included in the exported data.

Andere berekende metrische gegevens worden niet opgenomen.Other calculated metrics are not included. We exporteren bijvoorbeeld geen gemiddeld CPU-gebruik, maar we exporteren de ruwe telemetrie waarvan het gemiddelde wordt berekend.For example, we don't export average CPU utilization, but we do export the raw telemetry from which the average is computed.

De gegevens bevatten ook de resultaten van alle beschik bare-webtesten die u hebt ingesteld.The data also includes the results of any availability web tests that you have set up.

Notitie

Proef.Sampling. Als uw toepassing veel gegevens verzendt, kan de bemonsterings functie worden gebruikt en kan slechts een fractie van de gegenereerde telemetrie worden verzonden.If your application sends a lot of data, the sampling feature may operate and send only a fraction of the generated telemetry. Meer informatie over steekproeven.Learn more about sampling.

De gegevens controlerenInspect the data

U kunt de opslag direct in de portal inspecteren.You can inspect the storage directly in the portal. Klik op Start in het meest linkse menu, waar u ' Azure-Services ' selecteert, selecteer opslag accounts, selecteer de naam van het opslag account op de pagina overzicht Selecteer blobs onder Services en selecteer ten slotte de container naam.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.

Als u Azure Storage wilt controleren in Visual Studio, opent u weer gave, Cloud Explorer.To inspect Azure storage in Visual Studio, open View, Cloud Explorer. (Als u deze menu opdracht niet hebt, moet u de Azure SDK installeren: Open het dialoog venster New Project , vouw Visual C#/Cloud uit en kies Get Microsoft Azure SDK voor .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.)

Wanneer u uw BLOB-archief opent, ziet u een container met een set BLOB-bestanden.When you open your blob store, you'll see a container with a set of blob files. De URI van elk bestand dat is afgeleid van uw Application Insights resource naam, de bijbehorende instrumentatie sleutel, telemetrie-type/datum/tijd.The URI of each file derived from your Application Insights resource name, its instrumentation key, telemetry-type/date/time. (De resource naam is allemaal kleine letters en de instrumentatie sleutel laat streepjes.)(The resource name is all lowercase, and the instrumentation key omits dashes.)

Inspecteer de BLOB Store met een geschikt hulp programma

De datum en tijd zijn UTC en wanneer de telemetrie in de Store is gestort, niet de tijd dat deze is gegenereerd.The date and time are UTC and are when the telemetry was deposited in the store - not the time it was generated. Dus als u code schrijft voor het downloaden van de gegevens, kan deze lineair door de gegevens worden verplaatst.So if you write code to download the data, it can move linearly through the data.

Dit is de vorm van het pad:Here's the form of the path:

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

WaarWhere

  • blobCreationTimeUtc is tijd waarop blob is gemaakt in de interne staging-opslagblobCreationTimeUtc is time when blob was created in the internal staging storage
  • blobDeliveryTimeUtc is de tijd waarop de BLOB wordt gekopieerd naar de export doel opslagblobDeliveryTimeUtc is the time when blob is copied to the export destination storage

Gegevens indelingData format

  • Elke blob is een tekst bestand dat meerdere \n-gescheiden rijen bevat.Each blob is a text file that contains multiple '\n'-separated rows. Het bevat de telemetrie die gedurende een periode van ongeveer een halve minuut is verwerkt.It contains the telemetry processed over a time period of roughly half a minute.
  • Elke rij vertegenwoordigt een telemetrie-gegevens punt, zoals een aanvraag of pagina weergave.Each row represents a telemetry data point such as a request or page view.
  • Elke rij is een niet-opgemaakt JSON-document.Each row is an unformatted JSON document. Als u een ster wilt maken, opent u het in Visual Studio en kiest u bewerken, Geavanceerd, indelings bestand:If you want to sit and stare at it, open it in Visual Studio and choose Edit, Advanced, Format File:

De telemetrie weer geven met een geschikt hulp programma

Tijds duursen zijn in tikken, waarbij 10 000 Ticks = 1 MS.Time durations are in ticks, where 10 000 ticks = 1 ms. Deze waarden tonen bijvoorbeeld een tijd van 1 MS om een aanvraag te verzenden vanuit de browser, 3 MS om deze te ontvangen en 1,8 s om de pagina in de browser te verwerken: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}

Gedetailleerde gegevens model verwijzing voor de eigenschaps typen en-waarden.Detailed data model reference for the property types and values.

De gegevens verwerkenProcessing the data

Op een kleine schaal kunt u code schrijven om uw gegevens uit elkaar te halen, deze in een werk blad te lezen, enzovoort.On a small scale, you can write some code to pull apart your data, read it into a spreadsheet, and so on. Bijvoorbeeld: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);
        }
     }
  }
}

Zie een werk rollen gebruikenvoor een groter code voorbeeld.For a larger code sample, see using a worker role.

Oude gegevens verwijderenDelete your old data

U bent verantwoordelijk voor het beheren van uw opslag capaciteit en het verwijderen van de oude gegevens, indien nodig.You are responsible for managing your storage capacity and deleting the old data if necessary.

Als u uw opslag sleutel opnieuw genereert...If you regenerate your storage key...

Als u de sleutel naar uw opslag wijzigt, werkt doorlopend exporteren niet meer.If you change the key to your storage, continuous export will stop working. U ziet een melding in uw Azure-account.You'll see a notification in your Azure account.

Open het tabblad doorlopend exporteren en bewerk de export.Open the Continuous Export tab and edit your export. Bewerk het export doel, maar laat dezelfde opslag geselecteerd.Edit the Export Destination, but just leave the same storage selected. Klik op OK om te bevestigen.Click OK to confirm.

De continue export wordt opnieuw gestart.The continuous export will restart.

Voor beelden exporterenExport samples

Overweeg op grotere schaal HDInsight -Hadoop-clusters in de Cloud.On larger scales, consider HDInsight - Hadoop clusters in the cloud. HDInsight biedt diverse technologieën voor het beheren en analyseren van big data, en u kunt deze gebruiken voor het verwerken van gegevens die zijn geëxporteerd uit 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.

Vragen en antwoordenQ & A

  • Maar het enige wat ik wil, is een eenmalige down load van een grafiek.But all I want is a one-time download of a chart.

    Ja, dat kunt u doen.Yes, you can do that. Klik boven aan het tabblad op gegevens exporteren.At the top of the tab, click Export Data.

  • Ik heb een export ingesteld, maar er zijn geen gegevens in mijn Store.I set up an export, but there's no data in my store.

    Heeft Application Insights telemetrie van uw app ontvangen sinds u de export hebt ingesteld?Did Application Insights receive any telemetry from your app since you set up the export? U ontvangt alleen nieuwe gegevens.You'll only receive new data.

  • Ik heb geprobeerd een export in te stellen, maar de toegang is geweigerdI tried to set up an export, but was denied access

    Als het account eigendom is van uw organisatie, moet u lid zijn van de groepen eigen aren of Inzender.If the account is owned by your organization, you have to be a member of the owners or contributors groups.

  • Kan ik rechtstreeks naar mijn eigen on-premises Store exporteren?Can I export straight to my own on-premises store?

    Nee, helaas.No, sorry. Onze export engine werkt momenteel alleen met Azure Storage.Our export engine currently only works with Azure storage at this time.

  • Geldt er een limiet voor de hoeveelheid gegevens die u in mijn Store plaatst?Is there any limit to the amount of data you put in my store?

    Nee.No. Het pushen van gegevens wordt bewaard totdat u de export verwijdert.We'll keep pushing data in until you delete the export. We stoppen als we de buitenste limieten voor Blob-opslag hebben bereikt, maar dat is tamelijk groot.We'll stop if we hit the outer limits for blob storage, but that's pretty huge. U kunt bepalen hoeveel opslag ruimte u gebruikt.It's up to you to control how much storage you use.

  • Hoeveel blobs moet er worden weer geven in de opslag?How many blobs should I see in the storage?

    • Voor elk gegevens type dat u hebt geselecteerd om te exporteren, wordt elke minuut een nieuwe BLOB gemaakt (als er gegevens beschikbaar zijn).For every data type you selected to export, a new blob is created every minute (if data is available).
    • Daarnaast worden er voor toepassingen met veel verkeer extra partitie-eenheden toegewezen.In addition, for applications with high traffic, additional partition units are allocated. In dit geval maakt elke eenheid elke minuut een blob.In this case, each unit creates a blob every minute.
  • Ik heb de sleutel opnieuw gegenereerd voor mijn opslag of de naam van de container gewijzigd en nu werkt de export niet.I regenerated the key to my storage or changed the name of the container, and now the export doesn't work.

    Bewerk de export en open het tabblad uitvoer bestemming. Wijzig dezelfde opslag als voorheen en klik op OK om te bevestigen.Edit the export and open the export destination tab. Leave the same storage selected as before, and click OK to confirm. Het exporteren wordt opnieuw gestart.Export will restart. Als de wijziging in de afgelopen paar dagen valt, gaan er geen gegevens verloren.If the change was within the past few days, you won't lose data.

  • Kan ik het exporteren onderbreken?Can I pause the export?

    Ja.Yes. Klik op uitschakelen.Click Disable.

CodevoorbeeldenCode samples