此頁面提供故障排除幫助和有關使用 Crashlytics 的常見問題解答。如果找不到您要查找的內容或需要其他幫助,請聯繫Firebase 支持。
一般故障排除/常見問題解答
如果您沒有看到無崩潰的用戶、麵包屑日誌和/或速度警報,我們建議您檢查您的應用的 Google Analytics 配置。
確保您已在 Firebase 項目中啟用了 Google Analytics 。
確保在 Firebase 控制台的集成> Google Analytics頁面中為 Google Analytics 啟用數據共享。請注意,數據共享設置顯示在 Firebase 控制台中,但在 Google Analytics 控制台中進行管理。
除了 Firebase Crashlytics SDK 之外,請確保您已將適用於 Google Analytics 的 Firebase SDK 添加到您的應用程序 ( iOS+ | Android )。
確保您使用的是所有 Firebase SDK ( iOS+ | Android ) 的最新版本。
特別要檢查您是否至少使用以下版本的 Google Analytics Firebase SDK: iOS+ — v6.3.1+(v8.9.0+ for macOS 和 tvOS)| Android — v17.2.3+(BoM v24.7.1+) 。
您可能會注意到 Firebase 控制台的問題表中列出的問題有兩種不同的格式。您可能還會注意到在您的某些問題中稱為“變體”的功能。這就是為什麼!
2023 年初,我們推出了改進的事件分組分析引擎以及更新的設計和一些針對新問題(如變體!)的高級功能。查看我們最近的博客文章了解所有詳細信息,但您可以閱讀下面的重點內容。
Crashlytics 分析您應用中的所有事件(例如崩潰、非致命事件和 ANR)並創建稱為問題的事件組——一個問題中的所有事件都有一個共同的故障點。
為了將事件分組到這些問題中,改進的分析引擎現在會查看事件的許多方面,包括堆棧跟踪中的幀、異常消息、錯誤代碼和其他平台或錯誤類型特徵。
但是,在這組事件中,導致失敗的堆棧跟踪可能不同。不同的堆棧跟踪可能意味著不同的根本原因。為了表示問題中的這種可能差異,我們現在在問題中創建變體——每個變體都是問題中具有相同故障點和相似堆棧跟踪的事件的子組。使用變體,您可以調試問題中最常見的堆棧跟踪,並確定是否有不同的根本原因導致失敗。
以下是您將體驗到的這些改進:
問題行中顯示的改進元數據
現在可以更輕鬆地理解和分類應用中的問題。更少的重複問題
行號更改不會導致新問題。更容易調試具有各種根本原因的複雜問題
使用變體調試問題中最常見的堆棧跟踪。更有意義的警報和信號
一個新問題實際上代表一個新錯誤。更強大的搜索
每個問題都包含更多可搜索的元數據,例如異常類型和包名稱。
以下是這些改進的實施方式:
當我們從您的應用中獲得新事件時,我們將檢查它們是否與現有問題相匹配。
如果沒有匹配項,我們將自動將更智能的事件分組算法應用於事件,並使用改進後的元數據設計創建新問題。
這是我們對事件分組進行的第一次重大更新。如果您有任何反饋或遇到任何問題,請通過提交報告讓我們知道。
無崩潰值表示在特定時間段內與您的應用互動但未發生崩潰的用戶百分比。
以下是計算無崩潰用戶百分比的公式。其輸入值由 Google Analytics 提供。
CRASH_FREE_USERS_PERCENTAGE = 1 - ( CRASHED_USERS / ALL_USERS ) x 100
當崩潰發生時,Google Analytics 發送一個
app_exception
事件類型, CRASHED_USERS表示與該事件類型關聯的用戶數。ALL_USERS表示在您從 Crashlytics 儀表板右上角的下拉菜單中選擇的時間段內與您的應用互動的用戶總數。
無崩潰用戶百分比是一段時間內的聚合,而不是平均值。
例如,假設您的應用程序有三個用戶;我們稱他們為用戶 A、用戶 B 和用戶 C。下表顯示了每天有哪些用戶與您的應用互動,以及哪些用戶當天發生了崩潰:
週一 | 週二 | 週三 | |
---|---|---|---|
與您的應用互動的用戶 | 甲、乙、丙 | 甲、乙、丙 | 一個,乙 |
發生崩潰的用戶 | C | 乙 | A |
星期三,您的無崩潰用戶百分比為 50%(2 個用戶中有 1 個沒有崩潰)。
您的兩名用戶在周三使用了您的應用,但只有其中一名(用戶 B)沒有崩潰。在過去 2 天內,您的無崩潰用戶百分比為 33.3%(每 3 個用戶中就有 1 個沒有崩潰)。
在過去的兩天裡,您的三位用戶與您的應用進行了互動,但其中只有一位(用戶 C)沒有發生崩潰。在過去 3 天內,您的無崩潰用戶百分比為 0%(3 個用戶中有 0 個沒有崩潰)。
在過去三天裡,您的三位用戶與您的應用進行了互動,但其中零位用戶沒有發生崩潰。
註釋允許項目成員通過問題、狀態更新等對特定問題進行評論。
當項目成員發布註釋時,它會標有他們的 Google 帳戶的電子郵件地址。所有有權查看註釋的項目成員都可以看到此電子郵件地址以及註釋。
下面描述了查看、寫入和刪除筆記所需的訪問權限:
具有以下任何角色的項目成員都可以查看和刪除現有註釋並在問題上編寫新註釋。
具有以下任何角色的項目成員可以查看發佈在問題上的註釋,但他們不能刪除或編寫註釋。
集成
如果您的項目將 Crashlytics 與 Google 移動廣告 SDK 一起使用,則崩潰報告器可能會在註冊異常處理程序時進行干擾。要解決此問題,請通過調用disableSDKCrashReporting
關閉移動廣告 SDK 中的崩潰報告。
將 Crashlytics 關聯到 BigQuery 後,無論您的 Firebase 項目位於何處,您創建的新數據集都會自動位於美國。
平台支持
回歸問題
當您之前關閉問題時,問題已經回歸,但 Crashlytics 收到一份新報告,表明問題再次發生。 Crashlytics 會自動重新打開這些倒退的問題,以便您可以根據您的應用適當地解決它們。
下面是一個示例場景,解釋了 Crashlytics 如何將問題歸類為回歸:
- Crashlytics 有史以來第一次收到有關崩潰“A”的崩潰報告。 Crashlytics 為該崩潰打開一個相應的問題(問題“A”)。
- 您快速修復此錯誤,關閉問題“A”,然後發布新版本的應用程序。
- 在您關閉問題後,Crashlytics 會收到有關問題“A”的另一份報告。
- 如果報告來自 Crashlytics 在您關閉問題時知道的應用程序版本(意味著該版本已針對任何崩潰發送了崩潰報告),則 Crashlytics 不會將該問題視為倒退。該問題將保持關閉狀態。
- 如果報告來自您關閉問題時 Crashlytics不知道的應用程序版本(意味著該版本根本沒有針對任何崩潰發送任何崩潰報告),那麼 Crashlytics 會認為問題已倒退並會重新打開問題.
當問題回歸時,我們會發送回歸檢測警報並向問題添加回歸信號,讓您知道 Crashlytics 已重新打開問題。如果您不希望某個問題因我們的回歸算法而重新打開,請“靜音”該問題而不是將其關閉。
如果報告來自在您關閉問題時根本沒有發送過任何崩潰報告的舊應用程序版本,則 Crashlytics 會認為該問題已回歸併將重新打開該問題。
這種情況可能發生在以下情況:您已經修復了一個錯誤並發布了應用的新版本,但您仍然有用戶使用未修復錯誤的舊版本。如果碰巧,當您關閉問題時,其中一個舊版本根本沒有發送任何崩潰報告,並且這些用戶開始遇到該錯誤,那麼這些崩潰報告將觸發回歸問題。
如果您不希望某個問題因我們的回歸算法而重新打開,請“靜音”該問題而不是將其關閉。