コンテンツにスキップ

Error(エラー)


アプリの使用中にブラウザで発生するフロントエンドエラー(エラータイプ、エラー内容など)を確認できます。

Error エクスプローラーでは、次のことができます。

  • すべてのエラータイプと関連するエラー詳細をまとめて確認できます。

  • Sourcemap 変換により難読化されたコードを復元し、エラー調査時にソースコードを特定しやすくすることで、ユーザーがより迅速に問題を解決できるよう支援します。

エクスプローラー一覧

すべてのエラー

Error エクスプローラーでは、ユーザーアクセス時のページアドレス、コードエラータイプ、エラー内容などをすばやく確認できます。

  • エラー内容 Load failed:response がないエラーで、SDK がデフォルトで Load failed を付加します。

  • エラー内容 Network request failed:response がエラーを返す場合です。

パターン

発生頻度の高いエラーを確認する場合は、Guance ワークスペースの RUM > エクスプローラー > Error で、パターンリストを選択します。

パターンは、すべてのエラーのトレースデータを対象に、クラスタリングフィールドに基づいて類似度を計算・分析します。右上で選択した時間範囲で現在の期間を固定し、その期間内の 10000 件のデータを取得してパターン分析を行い、類似度の高いエラートレースを集約します。共通の Pattern クラスタを抽出・集計することで、異常なトレースの早期発見と問題の特定を支援します。

デフォルトでは error_message フィールドに基づいて集約し、クラスタリングフィールドをカスタム入力できます(最大 3 個)。

  • パターンリストで 1 つのクラスタをクリックすると Pattern クラスタ詳細が開き、関連するエラーレコードを確認できます。エラーレコードをクリックすると、対応する Error 詳細ページに移動します。

  • パターンページで並べ替えアイコン & をクリックすると、ドキュメント数を昇順/降順で並べ替えられます(デフォルトは降順)。

関連エラーの表示列

Pattern クラスタ詳細の関連エラーリストで、表示列をクリックすると、使用可能なフィールドの検索と追加、選択可能な列の削除、列順序の変更、デフォルト列への復元ができます。詳細な操作はクラスタ詳細の表示列を参照してください。

デフォルトでは時間、エラータイプ、ページアドレス、エラー内容が表示されます。時間列は保持され先頭列に固定され、その他の列は調整できます。同じフィールドを重複して追加することはできません。

たとえば、version と env を追加すると、各エラーレコードのアプリバージョンと環境を直接比較できます。選択可能なフィールドは、現在のアプリ、ワークスペース、データ権限で実際に使用可能なフィールドに準拠します。また、すでに報告済みで表示列のルールに適合するカスタムフィールドも含まれます。レコードに選択したフィールドがない場合は「—」と表示されます。

関連エラーリストには最大 50 件のレコードが表示されます。リストに特定のバージョンのレコードが表示されないことは、そのバージョンでエラーが発生していないことを意味せず、エラーが修正済みであると判断する根拠にもなりません。

詳細ページ

リストで確認したいデータの詳細ページをクリックすると、ユーザーアクセス時のエラー詳細(エラー詳細、拡張フィールド、関連するトレースなど)を確認できます。

ソース

ソースでは、現在の 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 は、エラーデータをワンクリックで解析する機能を提供します。大規模モデルを利用してデータから重要な情報を自動抽出し、オンライン検索エンジンや運用ナレッジベースと組み合わせて、考えられる障害原因を迅速に分析し、初期的な解決策を提示します。

  1. 単一のデータをクリックし、詳細ページを展開します。
  2. 右上の「Obsy Copilot エラー分析」をクリックします。
  3. 異常分析を開始します。

フィードバック

このページは役に立ちましたか?