title | description | keywords | author | ms.author | ms.date | ms.topic | ms.assetid | ms.service |
---|---|---|---|---|---|---|---|---|
Exporting Diagnostics Data |
How to export personal information from crashes and errors to your users |
GDPR, DSR, privacy, EU |
lucen-ms |
lucen |
07/30/2019 |
article |
2B51F9FA-75B1-4B73-8587-992F22CB0631 |
vs-appcenter |
[!INCLUDE Retirement announcement for App Center]
This article walks you through how to export data per your user request. To export data, you have two options:
- Use Azure Blob Storage
- Call our APIs for specific crash/error information
Export all your errors and symbolicated crashes, including stack traces and attachments, to Azure Blog Storage. You need an Azure subscription to export your data to Azure Blob Storage. You can learn more about how App Center works with Azure Blob Storage in the App Center Export documentation.
To export Diagnostics data to Blob Storage, call the following App Center API:
POST https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/export_configurations
Use one of the following payloads to export your crashes to Azure Blob Storage:
Payload for Standard Export :
{
"type" : "blob_storage_linked_subscription",
"subscription_id": "<Your-Azure-Subscription-ID",
"export_entities": [ "crashes" ]
}
Payload for Custom Export :
{
"type" : "blob_storage_connection_string",
"connection_string": "<Your-blob-storage-connection-string",
"export_entities": [ "crashes" ]
}
To find the location in blob storage, call the following App Center API:
GET https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/export_configurations
These are the different APIs you must call to export the associated Diagnostics information.
1. GET the crash/error log metadata for every crash/error in a crash/error group by calling:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors
2. GET the stacktrace by calling:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/stacktrace
3. GET any recorded events by calling:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/session_logs
4. GET any attachments IDs by calling:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments
- If this is a text attachment, you can GET the text by calling:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentId}/text
- If this is a binary attachment, you can GET URI location by calling:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentIdd}/location
Prerequisite: The following process requires you have a way to map the App Center install IDs and your users.
To provide a specific user with their data, you must search the exported data and copy the logs with a specific install ID in a different file. That file will contain all the data that has been exported corresponding to that specific user.