コンテンツにスキップ

カスタムエラーを送信する¶

Browser RUM SDK は、未処理のフロントエンド例外を自動的に収集します。ビジネスコードでキャッチされたが、依然として監視が必要な例外については、addError(error, context?) を使用して能動的に送信します。

パラメーター¶

パラメーター	型	必須	説明
`error`	Unknown	はい	元の `Error` オブジェクトを渡すことを推奨します。これにより message と stack が保持されます。
`context`	Object	いいえ	エラー発生時のビジネスフィールド。例：ページ状態、API名、リトライ回数など。

NPM の例¶

import { datafluxRum } from "@cloudcare/browser-rum"

async function submit() {
  try {
    await submitOrder()
  } catch (error) {
    datafluxRum.addError(error, {
      operation: "submit_order",
      retry_count: 1
    })
  }
}

CDN の例¶

同期ロード非同期ロード

fetch("/api/orders").catch(function (error) {
  window.DATAFLUX_RUM &&
    window.DATAFLUX_RUM.addError(error, {
      operation: "submit_order"
    })
})

fetch("/api/orders").catch(function (error) {
  window.DATAFLUX_RUM.onReady(function () {
    window.DATAFLUX_RUM.addError(error, {
      operation: "submit_order"
    })
  })
})

注意事項¶

元の Error オブジェクトを優先的に渡し、error.message のみを渡さないでください。
Context にパスワード、トークン、完全なリクエストボディなどの機密データを書き込まないでください。
同じ例外が SDK によって自動収集され、かつ addError() が呼び出された場合、2 つの Error データが生成されます。この API は、すでに処理された、またはビジネス側で能動的に認識された例外に対してのみ呼び出してください。

確認¶

例外をトリガーした後、該当する Web アプリケーションの Error エクスプローラーで operation フィールドに submit_order を指定してフィルターし、エラーの message、stack、およびカスタム Context を確認してください。