診斷功能

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

附加使用者識別碼之後,您可以使用 App Center 的搜尋功能來搜尋具有指定識別碼的損毀。 若要瞭解如何執行這項操作,請遵循 App Center 的 搜尋檔

附件

在 App Center 診斷 UI 中,您可以查看和下載損毀和錯誤報表的二進位和文字附件。

您可以閱讀 AndroidApache CordovaiOSmacOSReact NativeUWPWPF/WinFormsXamarin 應用程式的 SDK 損毀檔,瞭解如何將附件新增至您的損毀報表。

只有 Android、Unity、UWP、WPF、WinForms 和 Xamarin 平臺支援處理錯誤的附件。 瞭解如何在 AndroidUnityUWPWPF/WinFormsXamarin 應用程式的 SDK 檔中,為您的錯誤報表新增附件。

若要查看及下載附件,請選取損毀或錯誤群組、特定裝置報表,然後按一下 [附件] 索引標籤。

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

損毀之前的事件

追蹤導致損毀的事件,以捕捉您的應用程式狀態相關實用資訊。

若要定義自訂事件,請參閱適用于AndroidiOSmacOSReact NativeWindowsXamarinSDK 檔

若要在損毀之前查看事件,請選取損毀群組、特定裝置報表,然後按一下 [事件] 索引標籤。

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

索引鍵/值組

您可以自訂傳送至 App Center 的錯誤報表,以包含錯誤的額外內容,方法是將字串值的字典 (做為) 的索引鍵/值組,傳遞給 TrackError 方法。 這些屬性是選擇性的。 若要設定機碼值組,請查看我們的 AndroidXamarinUnityUWPWPF/WinForms 檔。

注意

這項功能目前僅支援 Android、Xamarin、Unity、UWP、WinForms 和 WPF 錯誤。

匯出診斷資料

App Center 可以將診斷 (損毀和錯誤) 原始資料匯出至 Azure。 將診斷資料匯出至 Blob 儲存體,以便自訂資料。

若要匯出損毀、附件和錯誤,您必須呼叫 匯出設定 API

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

exportEntities [API] 屬性的欄位中,您必須指定要匯出的資料類型:損毀、錯誤、附件。 當您這樣做時,將會匯出完整的 symbolicated 損毀和對應的堆疊追蹤。

深入瞭解的優點,以及如何在 匯出檔中匯出您的資料。

執行緒

在損毀報表中,您可以看到應用程式損毀時目前作用中的執行緒。 損毀的執行緒會以紅色反白顯示,讓您更瞭解應用程式的狀態。

App Center 會在損毀時顯示目前的執行緒

注意

在 Windows 中,報表只會顯示來自損毀之執行緒的堆疊追蹤。 當 Windows 不支援當機時,顯示其他執行緒的狀態。

[設定警示]

設定 App Center 應用程式定義以傳送電子郵件通知,以保持當機的最上層。 您可以針對每個應用程式設定這項設定,以便在建立新的損毀群組時立即傳送電子郵件,或傳送每日摘要電子郵件與應用程式的最大損毀。 若要設定這些警示:

  1. 登入 App Center,然後選取您的應用程式
  2. 在左側功能表中,流覽至 [設定]。
  3. 按一下 [電子郵件通知]
  4. 立即每天永不 選取。 預設設定為 [ 永不]。

螢幕擷取畫面:設定當機電子郵件通知頻率

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

建立 Bug 追蹤程式

您可以將協力廠商錯誤追蹤器工具與 App Center 整合,以隨時掌握最新資訊並更妥善地管理您的損毀。 閱讀 bug 追蹤程式檔 ,以瞭解如何開始使用。

設定資料保留

您可以透過我們的 Api (如 App CENTER API 檔或 [應用程式設定] 頁面中所列),將您的診斷資料保留設定為28或90天。 如果您將保留設定從90變更為28天,則會移除超過28天的任何現有診斷資料,而且任何新的資料只會儲存28天。

如果您將設定從28變更為90天,將不會回填較舊的診斷資料。 如果您想要儲存超過90天的資料,請將您的原始資料匯出至 Azure Blob 儲存體。 若要開始使用,請閱讀「 匯出診斷資料」一節

應用程式設定頁面中的資料保留設定

將報表上傳至 App Center

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