导出诊断数据

  • 项目

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方法。

本文介绍如何根据用户请求导出数据。 若要导出数据，有两个选项：

  1. 使用 Azure Blob 存储
  2. 调用我们的 API 以获取特定的崩溃/错误信息

使用 Azure Blob 存储

将所有错误和符号化崩溃（包括堆栈跟踪和附件）导出到 Azure 博客存储。 需要一个 Azure 订阅才能将数据导出到 Azure Blob 存储。 可以在 App Center 导出文档中了解有关 App Center 如何与Azure Blob 存储配合使用的详细信息。

若要将诊断数据导出到 Blob 存储，请调用以下 App Center API：

POST https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/export_configurations

使用以下有效负载之一将崩溃导出到Azure Blob 存储：

标准导出的有效负载：

{
  "type" : "blob_storage_linked_subscription",
  "subscription_id": "<Your-Azure-Subscription-ID",
  "export_entities": [ "crashes" ]
}

自定义导出的有效负载：

{
  "type" : "blob_storage_connection_string",
  "connection_string": "<Your-blob-storage-connection-string",
  "export_entities": [ "crashes" ]
}

若要在 Blob 存储中查找位置，请调用以下 App Center API：

GET https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/export_configurations

调用我们的 API 以获取特定的崩溃/错误信息

这些是导出关联诊断信息时必须调用的不同 API。

1. 通过调用以下方法获取崩溃/错误组中每个故障/错误的崩溃/错误日志元数据：

https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors

2. 通过调用以下方法获取堆栈跟踪：

https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/stacktrace

3. 通过调用以下项获取任何记录的事件：

https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/session_logs

4. 通过调用以下方法获取任何附件 ID：

https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments
  1. 如果这是文本附件，可以通过调用以下方法获取文本：
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentId}/text
  1. 如果这是二进制附件，可以通过调用以下方法获取 URI 位置：
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentIdd}/location

如何向用户提供此数据的副本

前提： 以下过程要求你能够映射 App Center 安装 ID 和用户。

若要向特定用户提供其数据，必须搜索导出的数据，并在其他文件中复制具有特定安装 ID 的日志。 该文件将包含与该特定用户对应的已导出的所有数据。