Appticsコンソールにおけるクラッシュレポート

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

アプリのクラッシュとは、致命的な例外によってアプリが強制終了する現象です。同じ一意の問題が原因で複数回クラッシュが発生する場合もあります。Instant エラーレポート機能を利用すると、こうしたクラッシュの通知を即座に受け取ることができ、詳細なクラッシュレポートにアクセスし、実用的なインサイト（クラッシュ分析）を得ることで、リアルタイムでクラッシュ発生の根本原因を特定するのに役立ちます。

Apptics のクラッシュレポートには、クラッシュログ、スタックトレース、デバイスタイムライン、その他の診断情報も含まれており、個別の問題がアプリのバージョン、OSバージョン、影響を受けたデバイス、デバイスモデル、デバイスIDなどにどのような影響を与えているかを把握できます。

アプリ内のクラッシュのトラッキングを開始するには、当社のSDKをアプリと連携する必要があります。SDKの実装方法については、以下を参照してください。

Appticsで扱うクラッシュの種類

クラッシュ

これは、未処理の例外や重大な実行時エラーなどが原因で、アプリが予期せず終了する代表的なケースです。

アプリのハング（ANRエラー）

ANR（App Not Responding）エラーは、ユーザーの入力やイベント、描画処理などに5秒以内に応答できない場合に発生します。ANRは、アプリのメインスレッド（特にUIスレッド）が長時間ブロックされた際に起こります。アプリがハングした場合やANRが発生した場合、すぐにクラッシュはしませんが、ユーザーは手動でアプリを終了せざるを得なくなります。

アプリ起動エラー

これは、アプリが正しく初期化できず、起動直後に即座にクラッシュする現象です。主に、起動ロジックの設定ミスや依存関係の不足が原因となります。

CPU例外

プロセッサが予期しない問題（無効な操作や不正なメモリアクセスなど）に遭遇し、通常のアプリ実行が妨げられる際に発生するエラーです。こうした例外は、アプリのクラッシュやハングを引き起こす場合があり、多くの場合、コードの低レベルな問題や設定ミスが原因となります。

ディスク書き込みエラー

ディスク書き込みエラーは、アプリがデバイスのストレージにデータを書き込めない場合に発生します。主な原因は、空き容量不足、権限の問題、ファイルシステムの破損、書き込み時の競合状態（レースコンディション）などです。これにより、クラッシュやデータの不整合、さらにはデータの永久的な消失に至ることもあります。

クラッシュ分析ダッシュボード

品質> Crashに移動します。選択した日付範囲で、クラッシュの合計数、報告されたクラッシュの原因となった一意の問題数、影響を受けたユニークデバイス数、クラッシュフリーなデバイスの割合（%）（クラッシュフリー単価）が表示されます。
グラフにより、クラッシュの発生件数、クラッシュの種類、選択した日付範囲内で各プラットフォームごとに発生したクラッシュのタイムラインを視覚的に把握できます。

下までスクロールすると、すべてのユニークな問題のリストとともに、問題の説明、影響を受けたOSバージョン、アプリバージョン、クラッシュの合計数、影響を受けたデバイスの合計数、コメントなどの詳細が表示されます。

クラッシュのグループ化

Appticsは各クラッシュインスタンスを自動的に追跡し、スタックトレースに基づいてグループ化し、クラッシュごとにユニークなフィンガープリントを提供します。これにより、クラッシュのトリアージにかかる時間を短縮し、それぞれのクラッシュの背後にあるユニークな問題を特定できます。
さらに分かりやすくするため、コンソールに表示される各ユニークな問題の横にタグが表示されます。一つ目のタグはクラッシュの種類を示し、もう一つのタグはクラッシュが報告されたアプリのフレームワーク（Native、React Native、Flutter）を示します。

クラッシュレポートの分析

Appticsのクラッシュ追跡には、シンボリケートされたクラッシュレポートやエラーログ、スタックトレース、スレッド、デバイス詳細、クラッシュ発生環境、ブレッドクラム、その他の診断情報が含まれており、問題の根本原因のデバッグと特定に役立ちます。

ユニークな問題リストから個別の問題をクリックして、さらに詳細を確認できます。

タイムラインのグラフでは、時間ごとのクラッシュの合計数と、影響を受けたデバイスのユニークな数が表示されます。ユニークな問題によるクラッシュ数、影響を受けたデバイス数、最新の影響を受けたアプリバージョンなどの統計情報を確認できます。
その他のグラフでは、影響を受けたデバイス、OSバージョン、アプリバージョンに関するインサイトも確認できます。

スタックトレース

デフォルトで現在のスレッドを含むシンボリケートされたスタックトレースを確認でき、問題のデバッグや解決に役立ちます。すべてのスレッドを表示をクリックすると、すべてのスレッドを含む完全なスタックトレースが表示されます。

何らかの理由でシンボリケート/デオブフスケートされたスタックトレースが表示されない場合は、iOSの場合はSymbolicate、Androidの場合はDeobfuscate
をクリックしてください。

<> 生データテキストボタンをクリックすると、問題に関する生データを含む完全なスタックトレースも表示できます。
crash_log.txtをクリックしてクラッシュファイルをダウンロードし、必要に応じてローカルマシンでシンボリケートできます。

AI解析

AI解析をクリックすると、デバイス情報、クラッシュ概要、解析、結論、利用可能であれば対処法を含むAI作成済みのクラッシュ解析レポートを取得できます。

個別クラッシュインスタンスの分析

クラッシュ詳細ページでリストを表示をクリックすると、そのユニークな問題によって発生したすべてのクラッシュインスタンスがリストで表示されます。
リストには、影響を受けたデバイスモデル、アプリバージョン、OSバージョン、デバイスID、クラッシュが発生した時刻、Appticsで受信された時刻などの詳細が含まれます。

デバイスタイムライン

個別のクラッシュインスタンスをクリックして、デバイスタイムラインを表示します。該当デバイスのクラッシュインスタンスの詳細が表示されます。

デバイスタイムラインでは、デバイス固有の以下の情報が確認できます：

Apptics SDK バージョン
アプリバージョン
OS バージョン
バッテリーステータス
ネットワーク EDGE
WiFi 強度
デバイスの向き
デバイスID
デバイスモデル
UUID

Breadcrumbs とセッションデータ

さらに詳細に調査し、セッションデータを分析できます。クラッシュインスタンスが発生したセッション中に実行された処理、API 通話、画面遷移などのトレースを確認できます。

処理トレースでは、問題発生時に行われた処理を示します。
API 通話トレースでは、問題発生時に実行されたすべての API 通話の一覧が表示されます。
画面トレースでは、問題発生時に遷移したすべての画面の一覧が表示されます。

ユーザー情報とカスタムプロパティ

カスタムプロパティを表示をクリックすると、特定のクラッシュに対してカスタムプロパティが利用可能かどうかを確認できます。

個人情報が利用可能をクリックすると、ユーザーIDやメールアドレス（利用可能な場合）などのユーザー情報を取得できます。

メモ: ユーザー情報の閲覧は役割に基づく操作であり、適切な権限を持つプロジェクトメンバーのみが表示できます。ユーザー情報が閲覧されるたびに、そのデータがAppticsコンソールの監査ログに、Zohoのプライバシーポリシーに従い記録されます。

課題管理

課題の優先順位付け

クラッシュを重大度に応じて優先付けすることができます。重大度は「表示停止」「クリティカル」「メジャーアップデート」「マイナーアップデート」「なし」から設定可能です。

問題解決のためのコラボレーション

チームメンバーがコメントを追加したり、タグ付けを行ったり、他のメンバーに割り当てたりして、個人の問題を迅速に解決できるようにします。

Apptics では、コンソール内で問題を管理することができます。これは Apptics をプロジェクト管理ツールと連携していない場合に利用できます。コンソール内で問題の対応やクローズも可能です。また、「すべて」「開く」「完了済み」の問題を表示できます。

Zoho Projects での問題の割り当て

Zoho Projects をご利用の場合、Zoho Apptics と連携し、これらの問題を課題として割り当てて効率的に管理できます。（詳しくはZoho Projects 連携ガイドをご参照ください。）
Zoho Projects 連携を有効にすると、ユニークな問題リストに「プロジェクト」という追加の列が表示され、「Assign」オプションが利用できるようになります。
Assignをクリックすると、個人の問題を Zoho Projects の課題として割り当てることができます。