Error¶
ユーザーがアプリケーションを使用中にブラウザが送出したフロントエンドエラーを確認できます。エラーの種類やエラー内容などが含まれます。
Error エクスプローラーでは、以下の操作が可能です。
- すべてのエラータイプとその関連エラー詳細を一元的に確認できます。
- Sourcemap 変換により、難読化されたコードを元に戻し、エラー調査時のソースコード特定を容易にし、問題解決を迅速化します。
エクスプローラー一覧¶
すべてのエラー¶
Error エクスプローラーでは、ユーザーアクセス時のページアドレス、コードエラーの種類、エラー内容などを迅速に確認できます。
- エラー内容「Load failed」：
responseがないエラーです。デフォルトで SDK に Load failed が追加されます。 - エラー内容「Network request failed」：
responseがエラーを返した場合です。
パターン¶
発生頻度の高いエラーを確認したい場合は、Guanceワークスペースの RUM > エクスプローラー > Error で、パターン一覧を選択してください。
パターンは、すべてのエラーのトレースデータをクラスタリングフィールドに基づいて類似度計算・分析するものです。右上の時間ウィジェットで選択した時間範囲に基づき、その時間範囲内の 10000 件のデータを取得してパターン分析を行い、類似度の高いエラートレースを集約し、共通のパターンを抽出・統計することで、異常トレースの迅速な発見と問題特定を支援します。
デフォルトでは error_message フィールドに基づいて集約されます。クラスタリングフィールドはカスタム入力可能で、最大 3 つまで入力できます。
- パターン一覧から任意のエラーをクリックすると、関連するすべての Error を表示できます。トレースをクリックすると詳細ページに移動して分析を確認できます。
- パターンページでソートアイコン & をクリックすると、ドキュメント数を昇順/降順で並べ替えられます（デフォルトは降順）。
詳細ページ¶
一覧から確認したいデータの詳細ページをクリックすると、エラー詳細、拡張フィールド、関連トレースなど、ユーザーアクセス時のエラー詳細を確認できます。
ソース¶
ソースでは、現在の Error の Session / View / Action の詳細を確認でき、現在の Session ID / View ID / Action ID をフィルター/コピーして確認できます。
エラー分布図¶
エラー分布図は、類似度の高いエラーを集約して統計し、エクスプローラーで選択した時間範囲に基づいて自動的に適切な時間間隔を選択し、エラーの分布傾向を表示します。これにより、エラーが頻発する時間帯を直感的に確認し、エラー問題を迅速に特定できます。
エラー詳細¶
エラー詳細では、エラーの具体的な内容を確認できます。
Sourcemap 変換¶
アプリケーションを本番環境にリリースする際、コード漏洩などのセキュリティ問題を防ぐため、通常、ビルドプロセスでファイルの変換や圧縮などの処理が行われます。これらの対策はコードの安全性を確保する一方で、収集されたエラースタック情報は難読化された状態となるため、直接問題を特定できず、その後のバグ調査に支障をきたします。
Guanceは、アプリケーションに Sourcemap 機能を提供し、難読化されたコードを復元してエラー調査時のソースコード特定を容易にし、問題解決を迅速化します。
RUM の Sourcemap 設定 または Datakit コレクターの Sourcemap 変換 で設定できます。設定完了後、エラー詳細で解析されたコードと元のコードを確認できます。
注意：現在、Sourcemap 設定は RUM の Web タイプのアプリケーションのみサポートしています。
解析コード例¶
RUM で Sourcemap 変換を設定した場合の解析コード例：
元のコード例¶
Datakit コレクターで Sourcemap 変換を設定した場合の解析コード例：
注意：RUM と Datakit コレクターの両方で Sourcemap を設定した場合、RUM で設定した解析形式が表示されます。
拡張フィールド¶
検索バーにフィールド名または値を入力して、すばやく検索・特定できます。
フィールドエイリアスをチェックすると、フィールド名の後ろに表示されます。必要に応じて選択してください。
トレース詳細ページでは、拡張フィールドで現在のトレースの関連フィールド属性を確認できます。
| フィールド | 属性 |
|---|---|
| フィールド値でフィルター | 該当フィールドをエクスプローラーに追加し、そのフィールドに関連するすべてのデータを表示します。トレースエクスプローラーで該当フィールドに関連するトレース一覧をフィルターして確認できます。 |
| フィールド値で除外フィルター | 該当フィールドをエクスプローラーに追加し、そのフィールド以外のデータを表示します。 |
| 表示列に追加 | 該当フィールドをエクスプローラー一覧に追加して表示します。 |
| コピー | 該当フィールドをクリップボードにコピーします。 |
Obsy Copilot エラー分析¶
Guanceは、エラーデータをワンクリックで解析する機能を提供します。大規模言語モデルを活用してデータから重要な情報を自動抽出し、オンライン検索エンジンや運用ナレッジベースと組み合わせることで、考えられる障害原因を迅速に分析し、初期対応策を提供します。
- 単一のデータをクリックして詳細ページを展開します。
- 右上の「Obsy Copilot エラー分析」をクリックします。
- 異常分析を開始します。
