Exportando dados de diagnóstico

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

Este artigo explica como exportar dados de acordo com sua solicitação de usuário. Para exportar dados, você tem duas opções:

1. Usar o Armazenamento de Blobs do Azure
2. Chamar nossas APIs para obter informações específicas de falha/erro

Usar o Armazenamento de Blobs do Azure

Exporte todos os erros e falhas simbolizadas, incluindo rastreamentos de pilha e anexos, para o Armazenamento de Blogs do Azure. Você precisa de uma assinatura do Azure para exportar seus dados para o Armazenamento de Blobs do Azure. Saiba mais sobre como o App Center funciona com o Armazenamento de Blobs do Azure na documentação de Exportação do App Center.

Para exportar dados de diagnóstico para o Armazenamento de Blobs, chame a seguinte API do App Center:

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

Use uma das seguintes cargas úteis para exportar seus crashes para o Armazenamento de Blobs do Azure:

Carga para exportação padrão:

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

Carga para exportação personalizada:

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

Para encontrar a localização em armazenamento de blobs, chame a seguinte API do App Center:

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

Chamar nossas APIs para obter informações específicas de falha/erro

Essas são as diferentes APIs que você deve chamar para exportar as informações de diagnóstico associadas.

1. OBTENHA os metadados do log de falha/erro para cada falha/erro em um grupo de falhas/erros chamando:

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

2. OBTENHA o stacktrace chamando:

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

3. OBTER todos os eventos gravados chamando:

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

4. Obtenha as IDs de anexos chamando:

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

1. Se esse for um anexo de texto, você poderá obter o texto chamando:

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

2. Se esse for um anexo binário, você poderá obter o local do URI chamando:

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

Como fornecer uma cópia desses dados para meus usuários

Pré-requisito: O processo a seguir exige que você tenha uma maneira de mapear as IDs de instalação do App Center e seus usuários.

Para fornecer dados a um usuário específico, você deve pesquisar os dados exportados e copiar os logs com uma ID de instalação específica em um arquivo diferente. Esse arquivo conterá todos os dados que foram exportados correspondentes a esse usuário específico.