Compartilhar via

Exportando dados de diagnóstico

  • Artigo

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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 simbólicas, 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 Armazenamento de Blobs do Azure. Você pode saber mais sobre como o App Center funciona com Armazenamento de Blobs do Azure na documentação 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 para exportar suas falhas para Armazenamento de Blobs do Azure:

Payload para Exportação Padrão:

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

Payload para Exportação Personalizada:

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

Para localizar o local no 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 de log de falha/erro para cada falha/erro em um grupo de erros/falha 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 todas 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
  1. 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 aos 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.