Eksportowanie danych diagnostycznych

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

1. Korzystanie z usługi Azure Blob Storage
2. Użyj naszych interfejsów API w celu uzyskania określonych informacji o awarii/błędzie

Korzystanie z usługi Azure Blob Storage

Eksportuj wszystkie błędy i symboliczne awarie, w tym ślady stosu i załączniki, do usługi Azure Blog Storage. Do wyeksportowania danych do usługi Azure Blob Storage potrzebna jest subskrypcja platformy Azure. Więcej informacji na temat sposobu działania centrum aplikacji z usługą 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 usługi Azure Blob Storage:

Ładunek dla eksportu standardowego

{
  "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

Użyj naszych interfejsów API w celu uzyskania 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łędów dla każdej awarii/błędu w grupie awarii/błędów, wywołując polecenie:

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

2. Pobierz stacktrace, wywołując:

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. Pobierz wszystkie identyfikatory załączników, wywołując następujące wywołanie:

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

2. Jeśli jest to załącznik binarny, możesz uzyskać 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 udostępnić kopię tych danych użytkownikom

Warunek wstępny: Poniższy proces wymaga posiadania możliwości mapowania identyfikatorów instalacyjnych App Center i powiązania ich z użytkownikami.

Aby zapewnić określonemu użytkownikowi dane, należy przeszukać wyeksportowane dane i skopiować dzienniki z określonym identyfikatorem instalacji w innym pliku. Ten plik będzie zawierać wszystkie wyeksportowane dane odpowiadające temu konkretnemu użytkownikowi.