JPN
설치∙사용 가이드 자주 묻는 질문 개발자 포럼 릴리즈 노트

エラー詳細

IMQA Crashのエラー詳細は、特定のエラーがアプリのどのバージョンでどれほど発生し、どのユーザー環境で主に発生するかを分析することができます。コールスタックとエラー発生ルートなどを確認でき、管理者はそのエラーにタグをつけたり、処理過程を記録・確認することができます。

1. 概要

「ダッシュボード」または「エラー検索」で特定のエラーをクリックすると移動でき、IMQA Crashエラー詳細は、以下のとおりに構成されています。

❶ エラー情報 ❷ エラー分布 ❸ ユーザー情報 ❹ 性能情報 ❺ タグ ❻ コールスタック/インスタンス/移動ルート

2. エラー情報

管理者は、エラー情報と累積回数を確認でき、処理過程を記録・確認することができます。

クラッシュ

❶ エラー情報 エラー名、クラス名、エラーが発生したコードラインナンバーが表示されます。

アプリの最新バージョンで該当するエラーが新規で発生した場合、復号化されたクラッシュ情報を確認するためには該当するバージョンのProguard設定が必要です。Proguardの設定に関する詳しい内容は「IMQA Crash ユーザガイド > すべてのプロジェクト管理 > Proguardの設定」をご参照ください。

❷ 状態 担当者は、確認後にエラーの処理状態を変更することができます。クリックすると、状態を変更できるオプションが表示されます。状態変更基準は特に定められていないため、管理者の判断によって以下のように設定することができます。

  • 新規New: 新たに発生したエラーの場合

  • 処理Open: 担当者が原因を把握して処理中の場合

  • 完了Fixed: 担当者が処理業務を完了した場合

  • 閉じるClose: 管理者が確認し、当該エラーの処理業務を完了した場合

状態変更を実施したエラーは、同バージョンまたは下位バージョンで同じエラーが発生した場合、状態が別途に変更されることはありません。ただし、上位バージョンで同じエラーが発生した場合、当該エラーと区分するため新規エラーとして作成されます。

❸ 最新バージョン/累積 発生したエラーのうち最も最新のアプリバージョン、当該エラーの発生総累積回数が表示されます。

Webクラッシュ

❶キャッチされたエラーインスタンス Webビューでエラーが生成された場合は、そのエラーのキャッチされたエラーインスタンス名を表示します。

❷ カスタムエラーメッセージ 特定のエラータイプエラーが生成されたときにユーザーが指定したメッセージを表示します。

throw new Error("ユーザーが指定したエラーメッセージ");

WebViewが収集するデフォルトのエラーメッセージを目的のエラーメッセージに変更して収集できます。 詳細なWebエラー分析のためにエラーメッセージを指定することをお勧めします。 エラーメッセージの指定の詳細については、「IMQA Crashインストールガイド> Custom Web Crashの発生>カスタムエラーメッセージの指定」を参照してください。

❸エラータイプ/コードライン番号 Webビューエラーの種類とそのエラーの行番号を確認できます。

エラータイプ説明

Error

ユーザーが設定したエラータイプです。

EvalError

eval()で発生するエラーです。

RangeError

変数の有効な範囲を外れた場合に作成されるエラーです。

ReferenceError

誤った参照をした場合に作成されるエラーです。

SyntaxError

誤った構文がある場合のエラーです。

TypeError

有効なデータ型でない場合におけるタイプのエラーです。

URIError

encodeURI()やdecodeURI()の関数に無効なパラメーターを渡した場合に作成されるエラーです。

AggregateError

複数のエラーを一つのエラーで包むエラータイプです。

3. エラー分布

直近の1週間に当該エラーがアプリのどのバージョンでどれほど発生したのか表示されます。発生推移とアプリバージョン別の比率を確認できます。

  • アプリバージョン別エラー発生比率: 直近の1週間の日別エラー発生数がアプリバージョン別に割り当てられます。

Y軸は、エラー発生数を表します。当該エラーを処理した後、最新バージョンでも再発生したのか容易に把握することができます。

また、特定の日付にエラー発生数が急激に増加した場合、アプリのどのバージョンで発生したかを確認してみてください。アプリの特定のバージョンにおいてエラーの発生が続く場合には、アプリの当該バージョンを利用するユーザーにアップデートをすすめることができます。

4. ユーザー情報

直近の1週間に当該エラーがどのようなユーザー環境で多く発生したのかが表示されます。

  • Wi-Fi/通信会社Carrier: 当該エラーが発生したユーザーのネットワーク環境が表示されます。Wi-Fi環境と通信会社別に確認することができます。

  • GPS: 当該エラーが発生したユーザーのGPS状態が表示されます。「ON」と「OFF」で表します。

  • アプリバージョンApp Version: 当該エラーが発生したユーザーのアプリバージョンが表示されます。

  • OSバージョンOS Version: 当該エラーが発生したユーザーのOSバージョンが表示されます。

  • デバイスDevice: 当該エラーが発生したユーザーのデバイスが表示されます。

「Unknown Device」は、デバイス情報が収集されていないことを意味します。Macのような機器からシミュレーターでテストした場合などがあります。

  • 国Country: 当該エラーが発生したユーザーが接続している国が表示されます。

個別のユーザー環境は、「エラー詳細 > インスタンス > 詳細」で確認できます。

5. 性能情報

当該エラー発生時の平均リソース使用量が表示されます。

  • CPU使用量Usage: 当該エラー発生時の平均CPU使用量が「%」で表示されます。

  • メモリ使用量Usage: 当該エラー発生時の平均メモリ使用量が「MB」で表示されます。

個別のユーザーリソース使用量は、「エラー詳細 > インスタンス > 詳細」で確認できます。

6. タグ

当該エラーに対する追加情報を、タグで自由に管理することができます。タグは、SDKでエラー種類とランクを設定する際にも設定することができます。

「Android > Crash SDK設定 > Custom Crash発生」をご参照ください。

① タグに希望するタグ名を入力して、[+]アイコンをクリックしてください。

② 画面下の空きスペースに登録したタグが表示されます。[X]アイコンをクリックすると削除できます。

登録したタグは、「エラー検索」ページで検索ワードとして活用することができます。アプリのターゲットとなるユーザー環境でタグを管理したり、発生状況、高いリソース使用量の記録などに活用してみてください。1つのエラーには、同じ名前のタグを登録することはできません。

7. コールスタック/インスタンス/移動ルート

クラッシュが発生したスタック情報とスレッド全体のスタックを確認することができます。個別ユーザーの詳細情報と移動ルートを分析することができます。

コールスタック

クラッシュ発生スタック情報とスレッド全体のスタックを確認して、エラーの原因と発生位置を把握することができます。スタックに関する情報をファイル形式でダウンロードして、メンバーと共有することもできます。

❶ スタックフィルター 基本のクラッシュ情報が画面の最上部に表示され、他のThread Call Stackで発生したエラーを確認できるよう、他のStack情報を選択して見ることができます。

❷ クラッシュ発生スタック クラッシュスタック情報のうち上位スタックラインが表示されます。

❸ すべてのスタック スレッド全体のスタック情報が表示されます。より正確にエラーの原因を把握するための参考にすることができます。

❹ 原本ダウンロード スタックに関する情報を「txt」ファイル形式でダウンロードしてメンバーと共有することができます。[Download Raw File]をクリックすると、「stacktrace.txt」ファイルが「Download」フォルダに保存されます。

インスタンス

クラッシュが発生したユーザー情報を確認することができます。個別のユーザーのLogCat(ログキャット、ログ詳細情報)、画面移動ルート、ユーザー環境に対する詳細情報を確認することができます。

❶ ユーザー情報 個別のユーザーのIPアドレス、アプリバージョン、デバイス、国情報が表示され、LogCat、移動ルート、詳細情報をポップアップで確認することができます。

❷ LogCat *Androidアプリ専用 Androidアプリの場合は、LogCat情報を確認することができます。個別ユーザー項目でLogCat [view]をクリックすると、LogCat情報のポップアップが表示されます。

LogCatとは、Androidの詳細ログ情報を意味し、エラースタック情報では把握できない問題を、クラッシュ発生時点以前に記録されたログ情報として表示します。

❸ 移動ルート 個別ユーザー項目で移動ルート [view]をクリックすると、移動ルート情報のポップアップが表示されます。

❹ 詳細 ユーザーのデバイス、アプリ情報、OSなどの環境情報を詳細に確認することができます。個別ユーザー項目で詳細 [view]をクリックすると、詳細情報のポップアップが表示されます。

  • ユーザー情報: ユーザーの名前、固有ID、IPアドレス、Eメールアドレスが表示されます。

ユーザー情報は、SDKが別途提供するAPIを通してデータを提供する場合のみ名前、固有ID、Eメールアドレスが表示されます。

  • デバイス: 当該ユーザーのデバイス関連情報が表示されます。

  • アプリ情報: 当該ユーザーのアプリ実行開始時間、バージョンなどの情報が表示されます。

  • OS: 当該ユーザーのプラットフォーム、OSバージョン、ルーティングの有無などが表示されます。

  • SDK: 当該ユーザーのアプリにインストールされたIMQA SDKバージョンが表示されます。

  • ユーザー定義ログCustom Logs: SDKから別途提供されるAPIを通してログ情報を送信した場合に提供されるログ情報が表示されます。

  • ユーザー定義キーCustom Keys: SDKから別途提供される APIを通してキー/値情報を送信した場合に提供されるキー/値情報が表示されます。

移動ルート

クラッシュが発生したユーザーが移動したイベントルートを確認することができます。

Sankeyダイアグラムは、全体のフローにおいて最も主となる重要な流れを探すときに役立ちます。エラー発生時点までのユーザーの主なイベントを、視覚的に把握することができます。画面と画面の間のエリアにカーソルを重ねると、「順序：イベント → 順序：イベント：ユーザー数」でツールチップが表示されます。

  • ユーザー数: 特定の画面から特定の画面へ移動したユーザー数がカウントされます。

エラー発生地点までの特定ルートが大きく強調される場合、当該ルートをたどって移動する多くのユーザーが問題を抱えていると解析することができます。当該ルートがアプリの目標ルートの場合は、問題を速やかに解決する必要があると言えます。

PreviousダッシュボードNextエラー検索

Last updated