共用方式為


診斷功能

這很重要

Visual Studio App Center 於 2025 年 3 月 31 日淘汰,但分析和診斷功能除外,這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。

在本節中,您將瞭解 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 診斷可讓您將使用者 ID 附加至當機和錯誤。 若要這樣做,請在目標平臺 AndroidiOSmacOSReact NativetvOSUnityUWPWPF/WinFormsMAUI/Xamarin 中使用 App Center SDK。 按兩下群組內的問題時,您會發現與當機或錯誤相關聯的使用者識別碼。

附加使用者標識碼之後,您可以使用 App Center 的搜尋功能來搜尋具有指定識別碼的當機。 瞭解如何透過 App Center 的 搜尋文件來完成此操作。

附件

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

您可以閱讀 AndroidiOSmacOSReact NativeUWPWPF/WinFormsMAUI/Xamarin 應用程式的 SDK 當機檔,瞭解如何將附件新增至當機報表。

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

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

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

當機前的事件

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

若要定義自定義事件,請參閱適用於AndroidiOSmacOSReact NativeWindowsMAUI/XamarinSDK 檔

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

App Center 可讓您追蹤導致當機的事件

鍵值對

您可以將字串值字典(作為索引鍵/值組)傳遞至 TrackError 方法,來自訂傳送至 App Center 的錯誤報告,以包含錯誤的其他上下文。 這些屬性是選擇性的。 若要設定索引鍵值組,請查看我們的 AndroidMAUI/XamarinUnityUWPWPF/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. 按兩下 [電子郵件通知]
  4. 選取 [立即]、[ 每日] 或 [ 永不]。 默認組態設定為 [永不]。

螢幕截圖的設定會造成電子郵件通知頻率錯誤

您可以在 App Center 儀表板文件中瞭解更多有關通知的資訊。

建立 Bug 追蹤器

您可以將第三方錯誤追蹤器工具與 App Center 整合,以隨時掌握資訊並更妥善地管理損毀。 閱讀 Bug 追蹤器檔 ,以瞭解如何開始使用。

將報表上傳至 App Center

透過 API 上傳錯誤報告的文件已移動。