Udostępnij za pośrednictwem


Eksportowanie danych diagnostycznych

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

W tym artykule opisano sposób eksportowania danych na żądanie użytkownika. Aby wyeksportować dane, dostępne są dwie opcje:

  1. Korzystanie z Azure Blob Storage
  2. Wywoływanie naszych interfejsów API pod kątem określonych informacji o awarii/błędzie

Korzystanie z Azure Blob Storage

Wyeksportuj wszystkie błędy i symboliczne awarie, w tym ślady stosu i załączniki, do usługi Azure Blog Storage. Potrzebujesz subskrypcji platformy Azure, aby wyeksportować dane do Azure Blob Storage. Więcej informacji na temat sposobu działania centrum aplikacji z Azure Blob Storage można dowiedzieć się w dokumentacji eksportowania centrum aplikacji.

Aby wyeksportować dane diagnostyczne do usługi Blob Storage, wywołaj następujący interfejs API centrum aplikacji:

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

Użyj jednego z następujących ładunków, aby wyeksportować awarie do Azure Blob Storage:

Ładunek dla eksportu w warstwie Standardowa:

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

Ładunek dla eksportu niestandardowego:

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

Aby znaleźć lokalizację w magazynie obiektów blob, wywołaj następujący interfejs API centrum aplikacji:

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

Wywoływanie naszych interfejsów API pod kątem określonych informacji o awarii/błędzie

Są to różne interfejsy API, które należy wywołać, aby wyeksportować skojarzone informacje diagnostyczne.

1. Pobierz metadane dziennika awarii/błędu dla każdej awarii/błędu w grupie awarii/błędów, wywołując następujące polecenie:

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

2. Pobierz stos, wywołując polecenie :

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

3. Pobierz wszystkie zarejestrowane zdarzenia, wywołując:

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

4. Uzyskaj identyfikatory załączników, wywołując:

https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments
  1. Jeśli jest to załącznik tekstowy, możesz pobrać tekst, wywołując następujące wywołanie:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentId}/text
  1. Jeśli jest to załącznik binarny, możesz pobrać lokalizację identyfikatora URI, wywołując następujące wywołanie:
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentIdd}/location

Jak podać kopię tych danych użytkownikom

Warunkiem wstępnym: Poniższy proces wymaga mapowania identyfikatorów instalacji centrum App Center i użytkowników.

Aby podać określonego użytkownika z danymi, należy przeszukać wyeksportowane dane i skopiować dzienniki o określonym identyfikatorze instalacji w innym pliku. Ten plik będzie zawierać wszystkie dane, które zostały wyeksportowane odpowiadające temu konkretnemu użytkownikowi.