ブラウザおよびモバイルのエラーログを追跡する

概要

Error Tracking は、ブラウザおよびモバイル向け Datadog Log SDK で収集したエラーを処理します。スタックトレースを含むエラーが収集されるたびに、Error Tracking はそれを処理し、類似したエラーをまとめた issue にグループ化します。

ログのエラーに不可欠な属性は、ログの error.stack にあるスタックトレースです。もし、スタックトレースを Datadog に送信しているが、error.stack にない場合、ジェネリックログリマッパーをセットアップして、スタックトレースを Datadog の正しい属性にリマップすることが可能です。

クラッシュレポートは Error Tracking に表示されます。

セットアップ

まだ Datadog Browser Logs SDK を設定していない場合は、アプリ内セットアップ手順に従うか、Browser Logs のセットアップドキュメントを参照してください。

  1. Logs Browser SDK の最新版をダウンロードしてください。エラー追跡には、少なくとも v4.36.0 が必要です。

  2. SDK の初期化の際に、アプリケーションの versionenvservice を構成します。例えば、NPM で

    import { datadogLogs } from '@datadog/browser-logs'
    
    datadogLogs.init({
      clientToken: '<DATADOG_CLIENT_TOKEN>',
      site: '<DATADOG_SITE>',
      service: '<MY_SERVICE>',
      env: '<MY_ENV>',
      forwardErrorsToLogs: true,
      sessionSampleRate: 100,
    })
    
  3. キャッチした例外を自分でログに残すには、オプションのエラーパラメーターを使用することができます。

    try {
      throw new Error('wrong behavior');
    } catch(err) {
      datadogLogs.logger.error("an error occurred", {usr: {id: 123}}, err);
    }
    

: エラー追跡は、Error のインスタンスであるエラーのみを考慮します。

まだ Datadog Android Logs SDK を設定していない場合は、アプリ内セットアップ手順に従うか、Android Logs のセットアップドキュメントを参照してください。

  1. Datadog Android SDK for Logs の最新版をダウンロードします。

  2. SDK の初期化の際に、アプリケーションの versionenvservice を構成します。

  3. キャッチした例外を自分でログに残すには、オプションで以下を使用できます。

    try {
      doSomething()
    } catch (e: IOException) {
      logger.e("an exception occurred", e)
    }
    

まだ Datadog iOS Logs SDK を設定していない場合は、アプリ内セットアップ手順に従うか、iOS Logs のセットアップドキュメントを参照してください。

  1. Datadog iOS SDK for Logs の最新版をダウンロードします。

  2. SDK の初期化の際に、アプリケーションの versionenvservice を構成します。

  3. キャッチした例外を自分でログに残すには、オプションで以下を使用できます。

    do {
      // ...
    } catch {
      logger.error("an exception occurred", error)
    }
    

まだ Datadog Kotlin Multiplatform Logs SDK を設定していない場合は、アプリ内セットアップ手順に従うか、Kotlin Multiplatform Logs のセットアップドキュメントを参照してください。

  1. Datadog Kotlin Multiplatform SDK for Logs の最新バージョンをダウンロードしてください。

  2. SDK の初期化時に、アプリケーションの versionenvservice を設定します。

  3. キャッチした例外を自分でログに残すには、オプションで以下を使用できます。

    try {
      doSomething()
    } catch (e: IOException) {
      logger.error("an exception occurred", e)
    }
    

その他の参考資料

PREVIEWING: guacbot/translation-pipeline