スタートガイド
クラッシュデータやエラーデータを分析するのに、次の 4 つのナビゲーションコンポーネントが役立ちます。
- プロジェクトセレクター - クラッシュやエラーが報告されているさまざまなプロジェクト間を切り替えることができます。
- フィルター - ワーキングセットを定義します。時間枠や追加条件を指定して、分析するエラーやフィンガープリントの範囲を指示します。
- 保存されたビュー - 一般に、選択したプロジェクトに迅速にアクセスして共有するためのアクセスフィルター。管理者ユーザーは特定のプロジェクトのチームのデフォルトのビューを保存し、ユーザーはさらにそのビューをユーザーのデフォルトによりパーソナライズできます。
- ツールと結果リスト - トリアージ、参照、デバッグの各ツールを使用して、クラッシュの優先順位付け、分析、デバッグを行うことができます。
フィルター
時間枠のフィルター
左上に時間枠のフィルターがあります。これを使用すると、特定の期間に発生した問題、つまり問題が初めて検出されたタイミングでフィルタリングできます。これは、ある問題が具体的にいつ発生したかを特定するのに役立ちます。
フィルター演算子
次は、特定のバージョン、特定のユーザー、具体的なオペレーティングシステムなどからのクラッシュを識別するフィルターを追加できます。フィルターは、クラッシュとともに提供されるあらゆるシステムやカスタムメタデータに対して適用できます。データ型によっては、非包含、正規表現、逆正規表現、最小、最大など、通常の等号演算子や包含演算子を超えた強力なフィルター演算子を利用できます。利用できる各種演算子の例については、以下の画像を参照してください。
大文字と小文字を区別しないフィルタリング
デフォルトでは、すべての検索演算子で大文字と小文字が区別されます。大文字と小文字を区別せずにフィルタリングする場合は、/<こちら>/i の中に正規表現または逆正規表現を入力して、大文字と小文字を区別しない検索を呼び出します。
たとえば、ユーザー入力の記述が「banana」、「Banana」、または「BaNaNa」であることがわかっているとします。description regular-expression /banana/i
にすることで、それらのいずれも含まれるようになりました。
集計フィルター
集計フィルターを使用すると、ユニーク数、一連の値からの最小値または最大値など、集計に基づいて追加のフィルターを適用できます。この機能を使用すると、次のような質問をすることができます。
「10 台以上の一意のサーバーに影響を及ぼしたクラッシュを表示する」
「バージョン 2.1.0 で導入された可能性のあるクラッシュを表示する」
「2 つ以上のリリースチャンネルで発生したクラッシュを表示する」
「問題に影響を及ぼしている具体的なシーンを絞り込めるように、そのゲーム内で最大でも 1 つの一意のシーンに影響を及ぼしたクラッシュを表示する」
ツールと結果リスト
ワーキングセットを定義したら、結果リストを表示して管理するためのツールを選択します。結果リストは、トリアージツールのこちらのコンテキストに表示されます。
結果リストは、使用しているツールによって異なります。以下の例ではトリアージツールの結果リストを使用しますが、参照ツールとデバッグツールに用意されている各種機能も確認しておいてください。
まず、結果リストの上部に、表示されている問題の数と合計を示す情報テキストが表示されます。これにより、フィルターウィンドウ外で特定された追加のクラッシュまたはエラーの数を確認できます。
使用しているツールに応じて、さまざまな方法で結果リストを操作し、エラーデータの調査を続行できます。
- トリアージツールには、フィンガープリント別にグループ化されたエラーが表示されます。フィンガープリントの解決をサポートするさまざまなアクションのほか、フィンガープリントの「詳細」ビューを開き、そのフィンガープリントに関する集計情報を掘り下げるさらに多くのイントロスペクションを利用できます。
- 参照ツールでは、グループ化する属性を選択することで、エラーデータをより細かく調査できます。ユーザーは通常、ユーザー ID 別(ユーザー別の影響を確認する)、ホストまたはデバイス ID 別(各ホストに対する影響を確認する)、OS バージョン別(ある OS パッチ適用後に発生した問題を特定する)、または対象のアプリケーションにとって有用なカスタム属性別にグループ分けします。
- デバッグツールでは、フィルター条件に基づいて個々のすべてのエラーを検索できます。これにより、類似したエラーのグループを反復処理して、追加の傾向や共通点を特定できます。
次のステップ
学習計画の次のステップについては、次のドキュメント項目を確認してください。
- トリアージガイド - 発生数が最も多いクラッシュやエラーを確認し、割り当て、Jira チケットへのリンクなどのアクションを実行できます。
- 参照ガイド - 強力なグループツールや視覚化ツールをカスタマイズ可能な方法で使用して、エラーデータをカスタマイズ可能な方法で分析できます。
- デバッグガイド - シンボル化されたコールスタック、システム属性やカスタム属性、その他有用な情報が含まれる、具体的なエラーレポートを表示できます。
コンソールのユースケース
新しいウェブコンソールには、Backtrace を操作するための強化されたインターフェースと対話モデルが用意されています。これは、新しく開発またはリリースされたソフトウェアに影響を及ぼしている問題を検出して解決することに取り組んでいる、エンジニアやエンジニアリングマネージャー、QA 担当者やサポート担当者、ビジネスリーダーやプロダクトリーダーなどのチームメンバーのニーズに対応するために開発されました。
- エンジニアリングマネージャー - 入ってくるエラー(クラッシュや例外)をトリアージし、割り当てられたエラーの状態を確認します。エラーデータ全体を参照、分析し、クエリを実行します。
- エンジニア - 割り当てられたエラーをデバッグして解決します。まだ割り当てられていないエラーを自分に割り当てることもあります。
- QA 担当者 - 開発中の新しいリリースの安定性を確認し、発生するリグレッションを特定して、必要とされる新しいテストを把握します。
- サポートスタッフ - 顧客から報告された問題を調査します。エラーが修正済みであるかどうか、どのような回避策がある可能性があるかを把握します。
- ビジネスリーダーやプロダクトリーダー - システム全体の正常性を把握します。プラスまたはマイナスの傾向を早期に特定する警告インジケーターを探します。