Exporter

Important

Visual Studio App Center doit être mis hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager de migrer.

En savoir plus sur les chronologies et les alternatives de support.

App Center vous permet d’exporter en continu toutes vos données brutes Analytics dans Azure. Vous pouvez exporter des données Analytics vers Stockage Blob et Application Insights (Azure Monitor). En exportant les données, vous bénéficiez des avantages suivants :

• Conservation illimitée des données
• Analyse détaillée de l’utilisation
• Tableau de bord unifié
• Fonctionnalités enrichies supplémentaires d’Application Insights telles que les entonnoirs, la rétention

App Center exporte en permanence des données Analytics vers Application Insights à partir du moment où vous configurez l’exportation, ainsi que deux jours de données remblayées. Avec le nouveau tableau de bord mis à jour dans Application Insights, les utilisateurs d’App Center peuvent obtenir une vue unifiée de l’analyse d’application et du back-end sur un tableau de bord.

App Center exporte en permanence des données Analytics vers Le Stockage Blob à partir du moment où vous configurez l’exportation, ainsi que 28 jours de données remblayées. En savoir plus sur le stockage Blob

Vous pouvez également exporter des données vers Azure usage général v2 Storage Blob. Les comptes de stockage v2 à usage général prennent en charge les dernières fonctionnalités du Stockage Azure, et intègrent toutes les fonctionnalités des comptes de stockage v1 à usage général et des comptes de stockage d’objets blob.

En savoir plus sur usage général stockage v2En savoir plus sur Application Insights

Stockage Blob Azure

Stockage Blob Azure est un service permettant de stocker de grandes quantités de données d’objet non structurées, telles que des données texte ou binaires, disponibles dans le monde entier via HTTP ou HTTPS. Vous pouvez utiliser stockage Blob pour exposer des données publiquement ou pour stocker des données en privé.

Les données sont exportées chaque minute et un sous-dossier est créé à chaque fois. Les données sont stockées au format année/mois/jour/heure/minute (par exemple, https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data) par défaut lorsque le blob_path_format_kind est défini sur WithoutAppId. Lorsque la propriété a la configWithAppIdvaleur , les données sont stockées au format appId/year/month/day/hour/minute , qui préfixe le chemin par défaut avec appID. L’affichage des données dans Stockage Blob Azure prend jusqu’à 5 minutes.

Les données sont divisées en données « Analytics » (sessions, événements), « Plantages », « Erreurs » et « Pièces jointes ». En savoir plus sur l’exportation de données diagnostics

Le contenu du fichier blob est un tableau JSON de journaux d’activité d’appareil client, qui ressemble à ceci pour les données Analytics :

[
    {
        "AppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "Timestamp": "2017-12-09T04:02:53.618Z",
        "InstallId": "e589a371-ea0c-4479-9a7b-9f834adec040",
        "MessageType": "EventLog",
        "IngressTimestamp": "2017-12-09T04:02:57.987Z",
        "MessageId": "980e21a0-0cbb-48ac-8820-28acf4beb00d",
        "EventId": "ad980536-e743-48a9-ab7e-cb043602d2c9",
        "EventName": "log_out",
        "CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "IsTestMessage": "False",
        "SdkVersion": "1.0",
        "Model": "PC",
        "OemName": "Samsung",
        "OsName": "Android",
        "OsVersion": "8.1.0",
        "OsApiLevel": "2",
        "Locale": "EN",
        "TimeZoneOffset": "PT2M",
        "ScreenSize": "320x240",
        "AppVersion": "1.1.0",
        "AppBuild": "1",
        "AppNamespace": "com.microsoft.test",
        "CarrierName": "AT&T",
        "CarrierCountry": "US",
        "CountryCode": "US",
        "WrapperSdkVersion": "1.0",
        "WrapperSdkName": "mobilecenter.xamarin","Properties": "{\"extra_00\":\"5bcacf3598ca44ebbbc99e4488cfc854\",\"extra_01\":\"2673e48867c74d51af8dc24c762a8b28\",\"extra_02\":\"5b76c801e5074cd3a13ea37253b94484\",\"extra_03\":\"c1e76aa252c947d4b4bcd4d1d96a7be6\",\"extra_04\":\"caea50034c4f441a963700fa3cf70d03\"}",
        "SessionId": "10df497a-4261-4995-b466-3fd77ac47395",
        "SdkName": "mobilecenter.android",
        "OsBuild": "2",
        "WrapperRuntimeVersion": "None",
        "LiveUpdateDeploymentKey": "stage",
        "LiveUpdatePackageHash": "dsadsdasd3211321233",
        "LiveUpdateReleaseLabel": "2.0"
    }
]

Azure Application Insights

Application Insights est un service de gestion des performances des applications (APM) qui offre des fonctionnalités d’interrogation, de segmentation, de filtrage et d’analyse de l’utilisation sur vos données d’événements App Center. En ajoutant le Kit de développement logiciel (SDK) App Center à votre application et en exportant les données dans une ressource Application Insights de type App Center, vous aurez accès aux fonctionnalités suivantes :

• Application Insights Analytics. Utilisez un langage de requête puissant pour analyser vos données d’événements brutes et créer des visualisations. Vous pouvez exporter les résultats de vos requêtes dans Power BI ou Excel.
• Utilisateurs, sessions et événements. Découvrez combien de personnes utilisent chaque page et chaque fonctionnalité de votre application, puis segmentez par pays, navigateur ou d’autres propriétés pour comprendre pourquoi.
• Entonnoirs et flux utilisateur. Comprendre comment les utilisateurs naviguent dans votre application. Identifiez les goulots d’étranglement. Découvrez des façons d’augmenter les taux de conversion et d’éliminer les points de difficultés.
• Rétention. Découvrez le nombre d’utilisateurs qui reviennent pour utiliser votre application. Découvrez où et pourquoi ils abandonnent.
• Classeurs. Créez des classeurs interactifs qui combinent des visualisations d’analyse de l’utilisation, des requêtes Application Insights Analytics et du texte pour partager des informations sur votre équipe.

Les champs App Center sont mappés au format Application Insights. Voici l’équivalence entre les champs mappés :

Application Insights	App Center
timestamp	Heure de l’événement
name	Nom de l’événement personnalisé ou du type de données
customDimensions	Cela inclut plusieurs champs indiqués dans le tableau ci-dessous
session_Id	Identificateur de session unique
user_Id	Identificateur d’installation
application_Version	Version de l’application
client_Type, client_Model	Modèle de l'appareil
client_OS	Type et version du système d’exploitation
sdkVersion	Version du Kit de développement logiciel (SDK) App Center

Le tableau ci-dessous montre le mappage de champs pour le champ « customDimensions ».

Application Insights	App Center
AppBuild	Numéro de build de l’application
AppId	App Center App ID
AppNamespace	Espace de noms d’application
CarrierCountry	Pays du transporteur
CarrierName	Type d’opérateur
EventId	ID d’événement App Center
IngressTimestamp	Horodatage de l’ingestion du journal
Paramètres régionaux	Langue de l’appareil
MessageType	Type d’événement (session, événement, ...)
OsApiLevel	Niveau DE l’API du système d’exploitation
OsBuild	Numéro de build du système d’exploitation
OsName	Nom du système d’exploitation
OsVersion	Version du SE
Propriétés	Propriétés attachées à un événement personnalisé
Taille d’écran	Taille de l’écran de l’appareil
SdkName	Nom du Kit de développement logiciel (SDK) App Center
SdkVersion	Version du Kit de développement logiciel (SDK) App Center
TimeZoneOffset	Décalage de fuseau horaire
UserId	Identificateur d’utilisateur personnalisé (jeu de développeurs)
WrapperRuntimeVersion	Version du runtime du wrapper du Kit de développement logiciel (SDK) App Center
WrapperSdkName	Nom du wrapper du Kit de développement logiciel (SDK) App Center
WrapperSdkVersion	Version du wrapper du Kit de développement logiciel (SDK) App Center

Exemple de requête IA pour récupérer des événements personnalisés :

customEvents
    | where name == "YourEventName"
    | extend Properties = todynamic(tostring(customDimensions.Properties))
    | extend YourPropertyName = Properties.YourPropertyName

Plus d’informations sur Application Insights et App Center :

• En savoir plus sur Application Insights en général
• En savoir plus sur l’intégration à App Center sur l’IA blog
• En savoir plus sur le blog Better Decisions through Better Analytics on App Center

Prérequis

Vous devez disposer d’un abonnement Azure pour utiliser Export ; Si vous n’avez pas d’abonnement Azure, créez un compte Azure gratuit avant de commencer.

Liaison d’abonnement Azure

Notes

Cette étape n’est nécessaire que pour l’exportation standard ; L’exportation personnalisée ne nécessite pas d’abonnement Azure.

L’exportation standard des données d’application d’App Center vers Azure nécessite un abonnement Azure lié à l’application App Center. L’ajout de l’abonnement et sa liaison à une application doivent être effectués par le propriétaire de l’application (si l’application n’appartient pas à un organization) ou par l’administrateur du organization.

Ajout d’un abonnement Azure

• Application appartenant à un organization : si vous êtes l’administrateur organization, accédez à la section Gérer sous le organization auquel l’application appartient.
• Application appartenant à un utilisateur : Si vous êtes le propriétaire de l’application, procédez comme suit.

1. Connectez-vous au portail App Center.
2. Accédez aux paramètres utilisateur.
3. Sous Azure, cliquez sur Ajouter un abonnement
4. Sélectionnez un abonnement Azure existant ou créez-en un.

Liaison d’une application à un abonnement Azure

Une fois que vous avez ajouté votre abonnement Azure à l’utilisateur ou au compte d’organisation, vous devez fournir aux applications un accès afin que l’abonnement puisse être utilisé dans cette application. Ce faisant, vous autorisez n’importe quel gestionnaire/développeur de cette application à utiliser l’abonnement à des fins d’exportation. Cela a un coût associé facturé sur votre abonnement Azure.

Configurer l’exportation

1. Sur le portail App Center, choisissez l’application.
2. Accédez aux paramètres de l’application.
3. Cliquez sur Exporter et sélectionnez l’option Nouvelle exportation .
4. Sélectionnez Stockage blob ou Application Insights en fonction des besoins de votre application.
5. Sélectionnez le type de configuration souhaité (standard ou personnalisé).

App Center offre deux façons d’exporter vos données : l’exportation standard et l’exportation personnalisée. L’exportation standard vous permet d’exporter les données avec une expérience en un clic, à l’aide de l’abonnement Azure lié à l’application. L’exportation personnalisée vous offre plus de flexibilité et les configurations seront personnalisées dans Azure.

Exportation standard

L’exportation standard offre une expérience en un clic pour l’exportation de vos données. Avec cette option, toutes les ressources requises sont automatiquement créées dans Azure.

Exportation personnalisée

L’exportation personnalisée permet aux utilisateurs de personnaliser leur configuration d’exportation dans Azure.

Pour le stockage Blob

1. Connectez-vous au portail Azure.
2. Cliquez sur Créer une ressource
3. Recherchez le compte de stockage dans Rechercher sur la Place de marché.
4. Cliquez sur Créer. La page Créer un compte de stockage s’ouvre.
5. Sélectionnez un abonnement Azure.
6. Sélectionnez un groupe de ressources existant ou créez-en un. (Un groupe de ressources est un conteneur qui contient des ressources associées pour une solution Azure)
7. Pour les types de comptes, vous verrez la liste déroulante suivante. Trois options sont prises en charge. Choisissez ce qui vous convient.
8. Cliquez sur Vérifier + créer
9. Une fois la validation passée
10. Cliquer sur Créer
11. Une fois le déploiement réussi, accédez à la ressource
12. Recherchez les clés d’accès dans l’onglet Paramètres
13. Copiez le chaîne de connexion et ajoutez-le dans vos configurations personnalisées App Center.

Pour Application Insights

1. Connectez-vous au portail Azure.
2. Sélectionnez Créer un outil> de gestion des ressources > Application Insights.
3. Une zone de configuration s’affiche
4. Définissez le type d’application sur application App Center.
5. Copiez la clé d’instrumentation à partir du Portail Azure et ajoutez-la dans vos configurations personnalisées App Center. Vous trouverez la clé d’instrumentation dans la page Vue d’ensemble de la ressource Application Insights.

Pour plus d’informations sur l’exportation, consultez le guide de démarrage rapide Application Insights.

Exportation de plusieurs applications vers le même compte de stockage

Lors de la configuration de l’exportation pour plusieurs applications, vous devez créer ou mettre à jour une configuration avec ( blob_path_format_kind partie du ExportBlobConfiguration modèle) défini sur WithAppId, qui préfixe le chemin d’exportation avec les appID respectifs.

Le chemin d’accès à l’objet blob est mis en forme comme suit :

• lorsque l’énumération est définie sur WithoutAppId=false est year/month/day/hour/minute
• lorsque l’énumération est définie sur WithAppId=true est appId/year/month/day/hour/minute

L’API de création de configuration d’exportation a été décrite ci-dessus. Pour les configurations existantes, voici l’API de mise à jour partielle :

PATCH /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}

La propagation des modifications prend de 5 à 10 minutes, et les entités à partir de ce point sont ensuite écrites à l’aide du nouveau format de chemin d’accès.

Refus du remplissage de retour

Par défaut, une nouvelle configuration d’exportation reremplit deux derniers jours de données pour les ressources IA et 30 jours pour le stockage blob. Il existe des scénarios où le remplissage en arrière n’est pas nécessaire ; par exemple, si cela entraînerait le remplacement ou la duplication de données. Dans ce cas, définissez backfill la propriété sur false lors de la création d’une nouvelle configuration.

Choix du type de données à exporter

Par défaut, une nouvelle configuration d’exportation exporte uniquement les données Analytics (événements, sessions, etc.) les données liées aux diagnostics peuvent être exportées en définissant Entities la propriété (export_entity modèle) vers une combinaison de errors, crasheset attachments. La propriété permet également d’exclure les données Analytics de l’exportation en ajoutant no_logs de la valeur au Entities tableau.

Mécanisme de désactivation automatique

App Center peut désactiver automatiquement une configuration d’exportation incorrecte pour éviter tout retard possible dans l’ensemble du pipeline d’exportation. Par exemple, App Center gère les échecs ci-dessous à partir d’Azure.

• La clé d’instrumentation Application Insights n’est pas valide.
• La ressource blob ne peut pas être authentifiée ou le nom distant ne peut pas être résolu.

Notes

Si l’exportation est réactivé, le flux de données continue à partir de ce moment sans remplissage arrière pour éviter un remplacement ou une duplication des données possibles. Si vous avez besoin de remplir à nouveau les données manquantes, vous devez recréer votre configuration d’exportation. Les données destinées à Application Insights restent 48 heures et 30 jours pour le Stockage Blob.

Vous pouvez utiliser l’une des API suivantes pour case activée le status afin d’effectuer une action de restauration.

GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations
GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}

Vous pouvez utiliser l’API suivante pour activer votre configuration d’exportation

POST /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}/enable

Tarifs

Pour configurer l’exportation, vous devez créer un abonnement Azure. L’exportation des données a un coût associé qui dépend du service Azure vers lequel vous exportez. Pour plus d’informations sur la tarification de chaque service, consultez :

Tarification d’Application Insights

Tarification Stockage Blob