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 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 config
WithAppId
valeur , 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"
}
]
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
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.
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.
- 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.
- Connectez-vous au portail App Center.
- Accédez aux paramètres utilisateur.
- Sous Azure, cliquez sur Ajouter un abonnement
- Sélectionnez un abonnement Azure existant ou créez-en un.
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.
- Sur le portail App Center, choisissez l’application.
- Accédez aux paramètres de l’application.
- Cliquez sur Exporter et sélectionnez l’option Nouvelle exportation .
- Sélectionnez Stockage blob ou Application Insights en fonction des besoins de votre application.
- 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.
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.
L’exportation personnalisée permet aux utilisateurs de personnaliser leur configuration d’exportation dans Azure.
Pour le stockage Blob
- Connectez-vous au portail Azure.
- Cliquez sur Créer une ressource
- Recherchez le compte de stockage dans Rechercher sur la Place de marché.
- Cliquez sur Créer. La page Créer un compte de stockage s’ouvre.
- Sélectionnez un abonnement Azure.
- 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)
- Pour les types de comptes, vous verrez la liste déroulante suivante. Trois options sont prises en charge. Choisissez ce qui vous convient.
- Cliquez sur Vérifier + créer
- Une fois la validation passée
- Cliquer sur Créer
- Une fois le déploiement réussi, accédez à la ressource
- Recherchez les clés d’accès dans l’onglet Paramètres
- Copiez le chaîne de connexion et ajoutez-le dans vos configurations personnalisées App Center.
Pour Application Insights
- Connectez-vous au portail Azure.
- Sélectionnez Créer un outil> de gestion des ressources > Application Insights.
- Une zone de configuration s’affiche
- Définissez le type d’application sur application App Center.
- 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.
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
estyear/month/day/hour/minute
- lorsque l’énumération est définie sur
WithAppId=true
estappId/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.
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.
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
, crashes
et 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.
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
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 :