Exporter la télémétrie depuis Application InsightsExport telemetry from Application Insights

Vous souhaitez conserver votre télémétrie plus longtemps que la période de rétention standard ?Want to keep your telemetry for longer than the standard retention period? Ou la traiter d’une façon spécialisée ?Or process it in some specialized way? L’exportation continue est idéale dans ce cas.Continuous Export is ideal for this. Les événements que vous voyez dans le portail Application Insights peuvent être exportés vers le stockage Microsoft Azure au format JSON.The events you see in the Application Insights portal can be exported to storage in Microsoft Azure in JSON format. À partir de là, vous pouvez télécharger vos données et écrire le code dont vous avez besoin pour les traiter.From there, you can download your data and write whatever code you need to process it.

Important

L’exportation continue a été dépréciée.Continuous export has been deprecated. Migrez vers une ressource Application Insights basée sur un espace de travail pour utiliser les paramètres de diagnostic pour l’exportation des données de télémétrie.Migrate to a workspace-based Application Insights resource to use diagnostic settings for exporting telemetry.

Notes

L’exportation continue est uniquement prise en charge pour les ressources Application Insights classiques.Continuous export is only supported for classic Application Insights resources. Les ressources Application Insights basées sur un espace de travail doivent utiliser des paramètres de diagnostic.Workspace-based Application Insights resources must use diagnostic settings.

Avant de configurer l’exportation continue, d’autres options doivent être prises en considération :Before you set up continuous export, there are some alternatives you might want to consider:

Une fois que l’exportation continue a copié vos données vers l’espace de stockage (où elles peuvent rester aussi longtemps que vous le souhaitez), elles restent disponibles dans Application Insights pendant la période de rétention habituelle.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.

Régions prises en chargeSupported Regions

L’exportation continue est prise en charge dans les régions suivantes :Continuous Export is supported in the following regions:

  • Asie Sud-EstSoutheast Asia
  • Centre du CanadaCanada Central
  • Inde centraleCentral India
  • Europe NordNorth Europe
  • Sud du Royaume-UniUK South
  • Australie EstAustralia East
  • Japon EstJapan East
  • Centre de la CoréeKorea Central
  • France CentreFrance Central
  • Asie EstEast Asia
  • USA OuestWest US
  • USA CentreCentral US
  • USA Est 2East US 2
  • États-Unis - partie centrale méridionaleSouth Central US
  • USA Ouest 2West US 2
  • Afrique du Sud NordSouth Africa North
  • Centre-Nord des États-UnisNorth Central US
  • Brésil SudBrazil South
  • Suisse NordSwitzerland North
  • Sud-Australie EstAustralia Southeast
  • Ouest du Royaume-UniUK West
  • Allemagne Centre-OuestGermany West Central
  • Suisse OuestSwitzerland West
  • Centre de l’Australie 2Australia Central 2
  • Émirats arabes unis CentreUAE Central
  • Brésil Sud-EstBrazil Southeast
  • Centre de l’AustralieAustralia Central
  • Émirats arabes unis NordUAE North
  • Norvège EstNorway East
  • OuJapon EstJapan West

Notes

Les applications déjà configurées dans les régions Europe Ouest et USA Est sont prises en charge, mais l’intégration de nouvelles applications dans ces régions n’est pas prise en charge.Applications already configured in West Europe and East US are supported but onboarding of new applications in those regions is not supported.

Configuration de stockage avancée de l’exportation continueContinuous Export advanced storage configuration

L’exportation continue ne prend pas en charge les fonctionnalités/configurations de stockage Azure suivantes :Continuous Export does not support the following Azure storage features/configurations:

Créez une exportation continue.Create a Continuous Export

Notes

Une application ne peut pas exporter plus de 3 To de données par jour.An application cannot export more than 3TB of data per day. Si plus de 3 To par jour sont exportés, l’exportation est désactivée.If more than 3TB per day is exported, the export will be disabled. Pour exporter sans limite, utilisez l’exportation basée sur les paramètres de diagnostic.To export without a limit use diagnostic settings based export.

  1. Dans la ressource Application Insights de votre application, sous Configurer, à gauche, ouvrez Exportation continue et choisissez Ajouter :In the Application Insights resource for your app under configure on the left, open Continuous Export and choose Add:

  2. Choisissez les types de données de télémétrie que vous souhaitez exporter.Choose the telemetry data types you want to export.

  3. Créez ou sélectionnez le compte de stockage Azure sur lequel vous voulez stocker les données.Create or select an Azure storage account where you want to store the data. Pour plus d’informations sur les options de tarification de stockage, consultez la page officielle sur la tarification.For more information on storage pricing options, visit the official pricing page.

    Cliquez sur Ajouter, Destination de l’exportation, Compte de stockage, puis créez un magasin ou choisissez un magasin existant.Click Add, Export Destination, Storage account, and then either create a new store or choose an existing store.

    Avertissement

    Par défaut, l’emplacement de stockage est défini dans la même région géographique que votre ressource Application Insights.By default, the storage location will be set to the same geographical region as your Application Insights resource. Si vous utilisez une autre région de stockage, vous risquez de subir des frais de transfert.If you store in a different region, you may incur transfer charges.

  4. Créez ou sélectionnez un conteneur dans votre stockage.Create or select a container in the storage.

Notes

Une fois votre exportation créée, les données nouvellement ingérées commencent à circuler vers Stockage Blob Azure.Once you've created your export, newly ingested data will begin to flow to Azure Blob storage. L’exportation continue transmet uniquement les nouvelles données de télémétrie créées/ingérées après activation de l’exportation continue.Continuous export will only transmit new telemetry that is created/ingested after continuous export was enabled. Les données présentes avant l’activation de l’exportation continue ne sont pas exportées, et il n’existe aucun moyen permettant d’exporter rétroactivement des données créées précédemment à l’aide de l’exportation continue.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.

Il peut y avoir un délai d'environ une heure avant que les données n’apparaissent dans le stockage.There can be a delay of about an hour before data appears in the storage.

Une fois la première exportation terminée, vous trouverez une structure similaire à ce qui suit dans votre conteneur de stockage d’objets blob Azure : (Cela varie en fonction des données que vous collectez.)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.)

NomName DescriptionDescription
DisponibilitéAvailability Consigne les tests web de disponibilité.Reports availability web tests.
EventEvent Événements personnalisés générés par TrackEvent().Custom events generated by TrackEvent().
ExceptionsExceptions Signale des exceptions sur le serveur et dans le navigateur.Reports exceptions in the server and in the browser.
MessagesMessages Envoyé par TrackTrace et par les adaptateurs de journalisation.Sent by TrackTrace, and by the logging adapters.
MétriquesMetrics Généré par les appels d’API des métriques.Generated by metric API calls.
PerformanceCountersPerformanceCounters Compteurs de performances collectés par Application Insights.Performance Counters collected by Application Insights.
DemandesRequests Envoyées par TrackRequest.Sent by TrackRequest. Les modules standard les utilisent pour consigner le temps de réponse du serveur, mesuré sur le serveur.The standard modules use this to reports server response time, measured at the server.

Pour modifier une exportation continueTo edit continuous export

Cliquez sur Exportation continue et sélectionnez le compte de stockage à modifier.Click on continuous export and select the storage account to edit.

Pour suspendre une exportation continueTo stop continuous export

Pour arrêter l’exportation, cliquez sur Désactiver.To stop the export, click Disable. Lorsque vous cliquez de nouveau sur Activer, l’exportation redémarre avec de nouvelles données.When you click Enable again, the export will restart with new data. Vous n’obtiendrez pas les données qui sont arrivées sur le portail alors que l’exportation était désactivée.You won't get the data that arrived in the portal while export was disabled.

Pour arrêter définitivement l’exportation, supprimez-la simplement.To stop the export permanently, delete it. Cette opération ne supprime pas vos données du stockage.Doing so doesn't delete your data from storage.

Impossible d’ajouter ou de modifier une exportation ?Can't add or change an export?

  • Pour ajouter ou modifier des exportations, vous devez disposer de droits d’accès de propriétaire, de contributeur ou de contributeur Application Insights.To add or change exports, you need Owner, Contributor, or Application Insights Contributor access rights. En savoir plus sur les rôles.Learn about roles.

Quels sont les événements que vous obtenez ?What events do you get?

Les données exportées sont les données de télémétrie brutes que nous recevons de votre application. Toutefois, nous ajoutons les données d’emplacement que nous calculons à partir de l’adresse IP du 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.

Les données qui ont été ignorées par l’ échantillonnage ne sont pas incluses dans les données exportées.Data that has been discarded by sampling is not included in the exported data.

Les autres mesures calculées ne sont pas incluses.Other calculated metrics are not included. Par exemple, nous n’exportons pas l’utilisation moyenne du processeur, mais nous exportons la télémétrie brute à partir de laquelle la moyenne est calculée.For example, we don't export average CPU utilization, but we do export the raw telemetry from which the average is computed.

Les données incluent également les résultats de n’importe quel test web de disponibilité que vous avez configuré.The data also includes the results of any availability web tests that you have set up.

Notes

Échantillonnage.Sampling. Si votre application envoie beaucoup de données, la fonctionnalité d’échantillonnage peut fonctionner et envoyer seulement une partie des données de télémétrie générées.If your application sends a lot of data, the sampling feature may operate and send only a fraction of the generated telemetry. En savoir plus sur l'échantillonnage.Learn more about sampling.

Inspection des donnéesInspect the data

Vous pouvez inspecter le stockage directement sur le portail.You can inspect the storage directly in the portal. Cliquez sur Accueil dans le menu de gauche. En haut, sous « Services Azure », sélectionnez Comptes de stockage, puis sélectionnez le nom du compte de stockage. Dans la page de présentation, sous les services, sélectionnez Objets blob. Enfin, sélectionnez le nom du conteneur.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.

Pour examiner le stockage Azure dans Visual Studio, ouvrez Afficher, Cloud Explorer.To inspect Azure storage in Visual Studio, open View, Cloud Explorer. (Si vous n’avez pas cette commande de menu, vous devez installer le SDK Azure : ouvrez la boîte de dialogue Nouveau projet, développez Visual C#/Cloud et choisissez Obtenir Microsoft Azure SDK pour .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.)

Lorsque vous ouvrez votre magasin d’objets blob, vous voyez un conteneur avec un ensemble de fichiers blob.When you open your blob store, you'll see a container with a set of blob files. L'URI de chaque fichier est dérivé du nom de votre ressource Application Insights, sa clé d'instrumentation, le type/la date/l'heure de télémétrie.The URI of each file derived from your Application Insights resource name, its instrumentation key, telemetry-type/date/time. (Le nom de la ressource est tout en minuscules et la clé d'instrumentation omet les tirets.)(The resource name is all lowercase, and the instrumentation key omits dashes.)

Inspectez le magasin d’objets blob avec un outil adapté.

La date et l’heure sont au format UTC et correspondent au moment où la télémétrie a été placée dans le magasin, et pas au moment où elle a été générée.The date and time are UTC and are when the telemetry was deposited in the store - not the time it was generated. Par conséquent, si vous écrivez du code pour télécharger les données, il peut parcourir les données de façon linéaire.So if you write code to download the data, it can move linearly through the data.

Voici le format du chemin d’accès :Here's the form of the path:

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

WhereWhere

  • blobCreationTimeUtc correspond à l'heure de création de l’objet blob dans le stockage intermédiaire interneblobCreationTimeUtc is the time when blob was created in the internal staging storage
  • blobDeliveryTimeUtc est l’heure de copie de l’objet blob vers le stockage de destination d’exportationblobDeliveryTimeUtc is the time when blob is copied to the export destination storage

Format de donnéesData format

  • Chaque objet blob est un fichier texte qui contient plusieurs lignes séparées par des \n.Each blob is a text file that contains multiple '\n'-separated rows. Il contient les données de télémétrie traitées sur une période de trente secondes environ.It contains the telemetry processed over a time period of roughly half a minute.

  • Chaque ligne représente un point de données de télémétrie, par exemple une demande ou un affichage de page.Each row represents a telemetry data point such as a request or page view.

  • Chaque ligne est un document JSON sans mise en forme.Each row is an unformatted JSON document. Si vous souhaitez afficher les lignes, ouvrez le blob dans Visual Studio et choisissez Modifier > le fichier de format > avancé :If you want to view the rows, open the blob in Visual Studio and choose Edit > Advanced > Format File:

    Consultez la télémétrie avec un outil approprié.

Les durées sont exprimées en nombre de cycles, où 10 000 cycles = 1 ms.Time durations are in ticks, where 10 000 ticks = 1 ms. Par exemple, ces valeurs indiquent une durée de 1 ms pour envoyer une demande à partir du navigateur, 3 ms pour la recevoir et 1,8 s pour traiter la page dans le navigateur :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}

Référence de modèle de données détaillé pour les valeurs et types de propriétés.Detailed data model reference for the property types and values.

Traitement des donnéesProcessing the data

À petite échelle, vous pouvez écrire du code pour décomposer vos données, les lire dans une feuille de calcul et ainsi de suite.On a small scale, you can write some code to pull apart your data, read it into a spreadsheet, and so on. Par exemple :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);
         }
      }
   }
}

Pour obtenir un exemple de code plus long, consultez Utilisation d’un rôle de travail.For a larger code sample, see using a worker role.

Supprimer les anciennes donnéesDelete your old data

C’est à vous de gérer votre capacité de stockage et de supprimer les anciennes données si nécessaire.You are responsible for managing your storage capacity and deleting the old data if necessary.

Si vous régénérez votre clé de stockage...If you regenerate your storage key...

Si vous modifiez la clé de votre stockage, l’exportation continue cesse de fonctionner.If you change the key to your storage, continuous export will stop working. Vous voyez alors une notification dans votre compte Azure.You'll see a notification in your Azure account.

Ouvrez l’onglet Exportation continue et modifiez votre exportation.Open the Continuous Export tab and edit your export. Modifiez la destination de l’exportation, mais laissez le même stockage sélectionné.Edit the Export Destination, but just leave the same storage selected. Cliquez sur OK pour confirmer.Click OK to confirm.

L’exportation continue redémarre.The continuous export will restart.

Exemples d’exportationExport samples

À plus grande échelle, envisagez d’utiliser des clusters HDInsight - Hadoop dans le cloud.On larger scales, consider HDInsight - Hadoop clusters in the cloud. HDInsight propose de nombreuses technologies pour gérer et analyser Big Data, et vous pouvez l’utiliser pour traiter les données qui ont été exportées depuis 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.

Questions et réponsesQ & A

  • Je veux simplement télécharger un graphique.But all I want is a one-time download of a chart.

    Oui, vous pouvez le faire.Yes, you can do that. En haut de l’onglet, cliquez sur Exporter les données.At the top of the tab, click Export Data.

  • J’ai configuré une exportation, mais il n’y a pas de données dans mon magasin.I set up an export, but there's no data in my store.

    Application Insights a-t-il reçu de la télémétrie de votre application depuis que vous avez configuré l’exportation ?Did Application Insights receive any telemetry from your app since you set up the export? Vous recevrez uniquement les nouvelles données.You'll only receive new data.

  • J’ai essayé de configurer une exportation, mais l’accès lui a été refusé.I tried to set up an export, but was denied access

    Si le compte appartient à votre organisation, vous devez être membre du groupe des propriétaires ou des collaborateurs.If the account is owned by your organization, you have to be a member of the owners or contributors groups.

  • Puis-je exporter directement vers mon propre magasin local ?Can I export straight to my own on-premises store?

    Non.No, sorry. Pour le moment, notre moteur d’exportation fonctionne uniquement avec le stockage Azure.Our export engine currently only works with Azure storage at this time.

  • Existe-t-il une limite à la quantité de données qu’il est possible de placer dans mon magasin ?Is there any limit to the amount of data you put in my store?

    Non.No. Nous transmettons les données jusqu’à ce que vous supprimiez l’exportation.We'll keep pushing data in until you delete the export. Nous arrêtons si nous atteignons les limites extérieures du stockage d’objets blob, mais ceci représente un volume très important.We'll stop if we hit the outer limits for blob storage, but that's pretty huge. C’est à vous de contrôler la quantité de stockage vous utilisez.It's up to you to control how much storage you use.

  • Combien d’objets blob devrais-je voir dans le stockage ?How many blobs should I see in the storage?

    • Pour chaque type de données que vous avez choisi d'exporter un objet blob est créé toutes les minutes (si les données sont disponibles).For every data type you selected to export, a new blob is created every minute (if data is available).
    • En outre, pour les applications avec un trafic élevé, des unités de partition supplémentaires sont allouées.In addition, for applications with high traffic, additional partition units are allocated. Dans ce cas, chaque unité crée un objet blob par minute.In this case, each unit creates a blob every minute.
  • J’ai régénéré la clé de mon espace de stockage ou modifié le nom du conteneur et l’exportation ne fonctionne plus.I regenerated the key to my storage or changed the name of the container, and now the export doesn't work.

    Modifiez l’exportation et ouvrez l’onglet de destination d’exportation. Conservez le même stockage que celui sélectionné auparavant, puis cliquez sur OK pour confirmer.Edit the export and open the export destination tab. Leave the same storage selected as before, and click OK to confirm. L’exportation redémarre.Export will restart. Si la modification a eu lieu dans les derniers jours, vous ne perdrez pas de données.If the change was within the past few days, you won't lose data.

  • Est-il possible de suspendre l’exportation ?Can I pause the export?

    Oui.Yes. Cliquez sur Désactiver.Click Disable.

Exemples de codeCode samples

Exportation basée sur les paramètres de diagnosticDiagnostic settings based export

L’exportation basée sur les paramètres de diagnostic utilise un schéma différent de celui de l’exportation continue.Diagnostic settings based export uses a different schema than continuous export. Elle prend également en charge les fonctionnalités que l’exportation continue n’a pas :It also supports features that continuous export does not like:

  • Comptes de stockage Azure avec des réseaux virtuels, des pare-feu et des liens privés.Azure storage accounts with vnet, firewalls, and private links.
  • Exportez vers Event Hub.Export to event hub.

Pour migrer vers l’exportation basée sur les paramètres de diagnostic :To migrate to diagnostic settings based export:

  1. Désactivez l’exportation continue actuelle.Disable current continuous export.
  2. Migrez l’application vers l’espace de travail.Migrate application to workspace-based.
  3. Activez les paramètres de diagnostic d’exportation.Enable diagnostic settings export. Sélectionnez Paramètres de diagnostic > Ajouter des paramètres de diagnostic à partir de votre ressource Application Insights.Select Diagnostic settings > add diagnostic setting from within your Application Insights resource.