診断データのエクスポート
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
この記事では、ユーザー要求ごとにデータをエクスポートする方法について説明します。 データをエクスポートするには、次の 2 つのオプションがあります。
- Azure Blob Storage を使用する
- 特定のクラッシュ/エラー情報については、API を呼び出します
Azure Blob Storage を使用する
スタック トレースや添付ファイルなど、すべてのエラーとシンボル化されたクラッシュを Azure Blog Storage にエクスポートします。 データをAzure Blob Storageにエクスポートするには、Azure サブスクリプションが必要です。 App Center でのAzure Blob Storageの動作の詳細については、App Center のエクスポートに関するドキュメントを参照してください。
診断データを Blob Storage にエクスポートするには、次の App Center API を呼び出します。
POST https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/export_configurations
次のいずれかのペイロードを使用して、クラッシュをAzure Blob Storageにエクスポートします。
標準エクスポートのペイロード:
{
"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
- これがテキスト添付ファイルの場合は、次を呼び出してテキストを取得できます。
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentId}/text
- これがバイナリ添付ファイルの場合は、次を呼び出して URI の場所を取得できます。
https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentIdd}/location
このデータのコピーをユーザーに提供する方法
前提 条件: 次のプロセスでは、App Center のインストール ID とユーザーをマップする方法が必要です。
特定のユーザーにデータを提供するには、エクスポートされたデータを検索し、特定のインストール ID を持つログを別のファイルにコピーする必要があります。 そのファイルには、その特定のユーザーに対応してエクスポートされたすべてのデータが含まれます。