Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
メインコンテンツへスキップ
Sentryはエラー追跡およびパフォーマンス監視プラットフォームで、アプリの問題解決と継続的な学習に役立ちます。@amazon-devices/sentry__react-nativeライブラリは、VegaプラットフォームにSentry用のReact Native SDKを実装します。 この段階では、Sentry機能の一部はVega用に設定されていません。Vega開発者フォーラムで質問を投稿したり、問題を報告したりできます。

インストール

  1. package.jsonファイルにJavaScriptライブラリの依存関係を追加します。
  2. npm installコマンドを使用して、依存関係をインストールします。

例

アプリの最上位でSentryを初期化します。 Sentryを初期化するには、Sentry.init({...})メソッドを使用します。必須のパラメーターはdsn(データソース名の略)のみです。Sentryプロジェクトの設定ページからdsnを見つけることができます。
Sentryを初期化した後、検出されなかったすべての例外が自動的に検出され、Sentryによって報告されます。イベントを手動で送信する必要はありません。 以下に示すように、Sentry.setContext()またはSentry.setUser()を使用して、Sentryイベントに情報を追加することもできます。

APIリファレンス

  • Sentry.init(options: ReactNativeOptions) - Sentryを初期化します。これを呼び出すと、すべてのエラーがSentryによって報告されます。Sentry.init()を呼び出す前にアプリケーションがクラッシュしたり、検出されない例外が発生したりした場合、それがSentryで検出されることはありません。
  • Sentry.nativeCrash() - このメソッドはネイティブクラッシュをトリガーします。Vegaデバイスおよびシミュレーター上で動作することがテストにより確認されています。
  • Sentry.setUser(user: User) - ユーザーデータ(例:username、email)を設定します。このデータはSentryイベントに含まれます。
  • Sentry.setContext(contextKey: string, contextData: Object) - 渡されたcontextKeyの下に追加されるカスタムデータを設定します。このデータはSentryイベントに含まれます。
  • Sentry.flush() - すべてのSentryイベントが送信されるまで待機します。
  • Sentry.captureMessage(message: string) - メッセージイベントをキャプチャし、Sentryに送信します。
  • Sentry.captureException(exception: Error) - 例外イベントをキャプチャし、Sentryに送信します。

その他の構成

Sentryエラーに読み取り可能なスタックトレースを追加する

アプリをビルドしたら、アプリのリリース名、バージョン、およびdist番号をSentryに通知し、JavaScriptバンドルとデバッグファイルのソースマップを送信する必要があります。これにより、Sentryがイベントを検出し、情報を読み取り可能なスタックトレースに正しくマッピングできます。 アプリをビルドすると、フォルダ構造は以下のようになります。
  1. Sentryの初期化時にリリースバージョンとdistバージョンを作成します。$SENTRY_RELEASE_VERSION(例:my-kepler-project@2.3.12)と$SENTRY_DIST_NUMBER(例:52)を定義する必要があります。詳細については、Sentryの公式ドキュメント(英語のみ)を参照してください。
  2. Sentry Metro Serializerをmetro.config.jsに追加して、アプリを再ビルドします。
  3. sentry-cliをインストールします。詳細については、Sentryの公式ドキュメント(英語のみ)を参照してください。
  4. 新しいSentryリリースを作成します。以前に定義した$SENTRY_RELEASE_VERSIONを渡す必要があります。詳細については、Sentryの公式ドキュメント(英語のみ)を参照してください。
  5. JavaScriptシンボリケーションのソースマップをアップロードします。sentry-wizardがまだサポートされていないことに注意してください。詳細については、Sentryの公式ドキュメント(英語のみ)を参照してください。
Sentryに情報を送信すると、アプリでエラーが発生した場所に関する正確な情報を受け取ることができます。

実装の詳細

  • sentry-wizardとSentry React Native Metro Pluginはまだサポートされていません。@sentry/wizardはVegaプロジェクトでは動作しません。
  • withSentryConfig metro tool - Vegaプロジェクトでは動作しません。
  • Tracingは実装されていません。
  • Profilingは実装されていません。

既知の問題と制限事項

SentryオフラインサポートはVegaでは機能しません。 Sentry.init() オプションが不足しています。

サポートされているバージョン

関連リソース

その他のライブラリについては、サポート対象のサードパーティのライブラリとサービスを参照してください。
最終更新日 2026年10月26日