診斷功能

  • 發行項

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center，直到完全淘汰為止，但有數個建議的替代方案可以考慮移轉至。

深入瞭解支持時程表和替代方案。

在本節中，您將瞭解 App Center 診斷服務可用的功能集。

損毀和錯誤分析

在 App Center 診斷中，您可以檢視 App Center 自動產生的分析數據，以瞭解應用程式中何時發生當機或錯誤。

依預設，App Center 會在並排檢視中顯示應用程式每天的當機和錯誤。

使用左上方的索引標籤，向下切入至損毀與錯誤。 當您這樣做時，左側圖表會指出每天當機/錯誤的數目，而右側圖表會顯示受影響的用戶數目。 依應用程式版本、時間範圍和狀態篩選圖表，以取得更焦點的檢視。

注意

App Center 會篩選潛在的敏感性資訊。 將篩選的敏感性資訊範例包括 URL、JSON 字串和要求標識碼。

App Center 會顯示當機和錯誤的分析

分組

App Center 診斷群組會以相似度來損毀和錯誤，例如問題的原因，以及應用程式發生問題的位置。 針對每個當機和錯誤群組，App Center 會顯示失敗的程式代碼行、類別或方法名稱、檔名、行號、損毀或錯誤類型和訊息，讓您一目了然地了解這些群組。 選取群組以檢視詳細資訊，並存取詳細問題報告和記錄的清單。 這可讓您更深入地探討並使用我們的功能集，以進一步瞭解應用程式在當機或錯誤期間的行為。

如果當機是因為無法呼叫 URL (所造成，例如「呼叫錯誤 azure.com 或 google.com」) App Center 可以將該 URL (當機分組，例如，所有無法呼叫 azure.com 都會分組在一起，而且無法呼叫 google.com 會群組在一起) 。 不過，由於我們會從損毀記錄檔中移除前面加上 HTTP 或 HTTPS 的 URL，因此只有在避免此語法時，此群組才會運作，例如：「呼叫 http://azure.com"時發生錯誤;不會與其他 Azure 呼叫分組，但「呼叫 azure.com 錯誤」將會分組為類似的錯誤報告。

App Center 會根據相似性將當機和錯誤分組

用戶識別

App Center 診斷可讓您將使用者標識元附加至損毀和錯誤。 若要這樣做，請在目標平臺 Android、Apache Cordova、iOS、macOS、React Native、tvOS、Unity、UWP、WPF/WinForms 和 MAUI/Xamarin 中使用 App Center SDK。 按兩下群組內的問題時，您會發現與當機或錯誤相關聯的使用者識別碼。

附加使用者標識碼之後，您可以使用 App Center 的搜尋功能來搜尋具有指定識別碼的當機。 瞭解如何遵循 App Center 的 搜尋檔來執行這項操作。

附件

在 App Center 診斷 UI 中，您可以檢視和下載損毀和錯誤報告的二進位和文字附件。

您可以閱讀 Android、iOS、macOS、React Native、UWP、WPF/WinForms 和 MAUI/Xamarin 應用程式的 SDK 當機檔，瞭解如何將附件新增至損毀報告。

只有 Android、Unity、UWP、WPF、WinForms 和 Xamarin 平臺才支援已處理錯誤的附件。 瞭解如何在 Android、 Unity、 UWP、 WPF/WinForms 和 MAUI/Xamarin 應用程式的 SDK 檔中，將附件新增至錯誤報告。

若要檢視並下載附件，請選取當機或錯誤群組、特定裝置報告，然後按兩下 [附件] 索引標籤。

App Center 可讓您將附件新增至損毀和錯誤報告

當機前的事件

追蹤導致當機的事件，以擷取應用程式狀態的相關實用資訊。

若要定義自定義事件，請參閱適用於 Android、iOS、macOS、React Native、Windows 和 MAUI/Xamarin 的 SDK 檔。

若要在當機前檢視事件，請選取損毀群組、特定裝置報告，然後按兩下 [事件] 索引標籤。

App Center 可讓您追蹤導致損毀的事件

索引鍵/值組

您可以量身打造傳送至 App Center 的錯誤報告，以包含錯誤的其他內容，方法是將字串值的字典傳遞 (做為索引鍵/值組，) 至 TrackError 方法。 這些屬性是選擇性的。 若要設定機碼值組，請查看Android、MAUI/Xamarin、Unity、UWP和 WPF/WinForms 檔。

注意

此功能僅支援 Android、iOS、Xamarin、React Native、Unity、UWP、WinForms 和 WPF 錯誤。

匯出診斷數據

App Center 可以將診斷 (當機，並將原始數據) 錯誤導出至 Azure。 將診斷數據匯出至 Blob 記憶體，以自訂數據。

若要匯出當機、附件和錯誤，您必須呼叫 匯出組態 API：

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

在 exportEntities API 屬性的 欄位中，您必須指出您想要匯出的數據類型：當機、錯誤、附件。 這樣做時，將會匯出完整的符號損毀和對應的堆疊追蹤。

深入瞭解 的優點，以及如何在 導出檔中匯出您的數據。

執行緒

在當機報告中，您可以看到應用程式當機時作用中的目前線程。 當機的線程會以紅色醒目提示，讓您進一步瞭解應用程式的狀態。

App Center 會在當機時顯示目前的線程

注意

在 Windows 上，報表只會顯示發生損毀之線程的堆疊追蹤。 Windows 不支援在當機時顯示其他線程的狀態。

設定警示

藉由設定 App Center 應用程式定義設定來傳送電子郵件通知，隨時掌握當機情況。 您可以為每個應用程式設定此設定，以在建立新的當機群組時立即傳送電子郵件，或傳送每日摘要電子郵件，並傳送應用程式最上層損毀的電子郵件。 若要設定這些警示：

  1. 登入 App Center 並選取您的應用程式
  2. 在左側功能表中，流覽至 [ 設定]
  3. 按兩下 [Email 通知]
  4. 選取 [立即]、[ 每日] 或 [ 永不]。 默認組態設定為 [永不]。

設定當機電子郵件通知頻率的螢幕快照

您可以在我們的 App Center 儀錶板檔中深入瞭解通知。

建立錯誤追蹤器

您可以整合協力廠商 Bug 追蹤器工具與 App Center，以掌握最新資訊並更妥善地管理損毀。 若要了解如何開始使用，請閱讀 Bug 追蹤器文件。

將報表上傳至 App Center

透過 API 上傳損毀的文件已移動。