App Quality Insights を使用して Firebase Crashlytics の問題を分析する

Firebase Crashlytics のアプリのクラッシュ データを Android Studio で直接確認して対処することができます。この統合では、スタック トレース データとクラッシュ統計情報が Crashlytics から Studio IDE の [App Quality Insights] ツール ウィンドウに取り込まれるため、ブラウザと Studio IDE の間を行き来する必要がありません。開発チームは次のような主要な機能を利用できます。

• 関連する Crashlytics イベントデータがある場合、コード内の行がハイライト表示されます。
• 上位のクラッシュのスタック トレースを確認し、スタック トレースをクリックしてコード内の関連する行に移動できます。
• 上位のクラッシュや非致命的なイベントに関する概要の統計情報（デバイスのメーカーや Android のバージョン別にグループ化されたものなど）を確認できます。
• 重大度、時間、アプリのバージョンなどの属性でイベントをフィルタできます。
• ブラウザリンクを取得して Crashlytics ダッシュボード ページを開き、イベントの詳細を確認できます。

Crashlytics をまだ利用していない場合、Crashlytics の詳細については、Firebase Crashlytics をご覧ください。

使ってみる

Android Studio で Crashlytics のデータを表示するには、アプリ プロジェクトで Firebase と Crashlytics を設定する必要があります。手順は次のとおりです。Android Studio で [Tools] > [Firebase] に移動して Firebase Assistant を開き、[Crashlytics] をクリックします。チュートリアルに沿って Firebase と Crashlytics をプロジェクトに追加します。Firebase Assistant のワークフローについて詳しくは、Firebase の Android 向けスタートガイドをご覧ください。

すでに Firebase と Crashlytics をアプリに追加している場合は、IDE でアバター アイコン をクリックしてデベロッパー アカウントにログインします。ログイン後、[App Quality Insights] ツール ウィンドウをクリックします。[Issues]、[Sample Stack Trace]、[Details] の各パネルに Crashlytics のレポートが表示されます。

Android Studio で Crashlytics のデータを操作する

[App Quality Insights] ツール ウィンドウには、発生したイベントについて分析するための豊富なデータと、イベントのソースにすばやく移動するためのリンクが表示されます。

1. プロジェクトに複数のアプリ モジュールが含まれている場合は、モジュールのプルダウン メニューから、イベントデータを表示するモジュールが選択されていることを確認します。
2. アプリケーション ID のプルダウン メニューを使用して、分析したいアプリ ID を選択します。たとえば、IDE でアプリのデバッグ バージョンを操作しているときに、ユーザーがインストールしているアプリの製品版のイベントデータを表示する場合があります。
3. [Issues] パネルには、Crashlytics にデータがある上位のイベントが表示され、クラッシュの影響の大きい順に並べ替えられています。

4. スタック トレースが表示されているパネルには、[Issues] パネルでクリックしたイベントの、最近発生した事象の詳細が表示されます。イベントのスタック トレースを確認し、スタック トレースをクリックしてコードベース内の関連する行に移動できます。

   また、影響を受けるデバイスタイプ、その Android バージョン、イベントの発生時刻に関する情報のほか、Firebase Crashlytics ダッシュボードのイベントへのリンクも表示されます。[Close] ボタンをクリックして、パネルから直接問題をクローズします。

5. [Details] パネルには、デバイスタイプと Android バージョンごとのクラッシュ数の内訳が表示されるため、最も影響を受けているユーザー グループを特定できます。また、クラッシュが発生したアプリのバージョンと影響を受けるユーザーの数も表示されます。
6. 問題に関するメモを確認します。また、問題にメモを添付して Firebase コンソールに表示し、チームメイトが確認できるようにします。問題に関するメモを作成するには、その問題を選択して [Notes] パネルを開きます。メモを作成するには、Crashlytics プロジェクトへの書き込み権限が必要です。問題にメモが付いている場合は、[ Issues ] パネルに「メモ」アイコン が表示されます。

   

7. さまざまなフィルタを使用して、特定のイベントのサブセットを絞り込むことができます。致命的なイベント または非致命的なイベント を選択あるいは選択解除し、時間、アプリのバージョン、Crashlytics シグナル、デバイス メーカーとモデル、Android プラットフォーム バージョンでフィルタできます。なお、Crashlytics シグナルの状態では、過去にクローズされた問題が新バージョンのアプリで再発した場合、問題は「回帰」と見なされます。

スタック トレースからコードに移動できるだけでなく、コードからスタック トレースに移動することもできます。Android Studio では、クラッシュに関連するコード行に、クラッシュ ガターアイコン を使ってアノテーションを付けるようになったため、該当する行を簡単に見つけてデバッグできます。

クラッシュ アイコンにカーソルを合わせると、そのコード行に関係するイベントの数とイベントの頻度を示すポップアップが表示されます。

クラッシュ アイコンをクリックすると、特定のイベントの発生頻度や影響を受けるユーザーの数を含む、イベントのより詳細なリストが表示されます。特定のイベントをクリックすると、[App Quality Insights] ツール ウィンドウにイベントの詳細が表示されます。

オフライン時に一部機能の制限付きで調査する

[Refresh] をクリックするなどして新たなリクエストを行う際に、Android Studio が Crashlytics と通信できない場合、[App Quality Insights] ウィンドウで [Offline Mode] に入ることができます。

このモードでは、引き続きキャッシュ データの問題と最新のイベントを調査できます。フィルタ オプションの変更や問題のクローズなど、特定の機能は使用できません。Crashlytics への接続を再試行してオンライン状態に戻すには、[Reconnect] をクリックします。