AndroidのプロファイリングにProfilingManager経由のPerfettoを採用

Article by: Markus Hintersteiner(読了時間:3分) Sentry Android SDK 8.51.0以降、Android 15以上のデバイスでのプロファイリングは、Androidのシステム API ProfilingManagerを通じてPerfettoで動作するようになりました。これにより、従来のトレーサーによるクラッシュが減り、CPUとメモリのオーバーヘッドが下がり、より実態に近いプロファイルが得られます。 設定の変更は必要ありません。すでに継続的プロファイリングを使用していれば、Android 15以降のデバイスではアップグレードした時点で新しいプロファイラーに切り替わります。 メソッドトレーシングからProfilingManagerへ これまでSentry Android SDKは、AndroidのDebug.startMethodTracing APIを使ってアプリをプロファイリングしていました。このAPIはAndroidランタイムに組み込まれたトレーサーを使用して、スレッドをサンプリングします。現在Legacy Profilingと呼ばれているこのプロファイラーは、アプリのプロセス内で動作します。 8.51.0では、Android 15以上(API 35以上)の従来のプロファイラーをProfilingManagerに置き換えました。ProfilingManagerは、Perfettoベースのスタックサンプルを記録できます。Android 15未満のデバイスでは引き続き従来のプロファイラーが使用されるため、古いデバイスのカバレッジが失われることはありません。 アプリのプロセス外でプロファイリングするメリット プロファイリングをアプリのプロセス外に移すことには、以下3つのメリットがあります。 従来のトレーサーによるクラッシュがなくなる — Debug.startMethodTracing() APIが使うAndroidランタイムのトレーサーは、プロセス内のほかのコードがネイティブスレッドを作成してランタイムにアタッチし、デタッチせずに終了した場合、アプリをクラッシュさせることがあります。このバグの原因はSentryではありませんが、プロファイリングにこのトレーサーを使うことで、バグが表面化しやすくなる場合があります(sentry-java#2604)。Perfettoによるプロファイリングでは、このトレーサーを使用しません。 CPUとメモリのオーバーヘッドが下がる — メモリ割り当ての大部分を含め、プロファイリング処理のほとんどがアプリではなくシステムのプロセスで行われます。具体的な数値はまだ共有できませんが、従来のプロファイラーよりオーバーヘッドは小さくなっています。 より実態に近いプロファイルが得られる — プロファイラーが同じプロセス内でアプリのコードと競合しないため、計測対象のコードへの影響が小さくなります。 フレームチャートよりさらに詳しく調べたい場合は、SentryのプロファイルからPerfettoトレースの生データを直接ダウンロードし、ui.perfetto.devで開くことができます。 プロファイリングの実例 大規模なコードベースでは、どのコードがどこで実行されているかを把握するのは困難です。プロファイリングを使えば、どのコードが、どのスレッドで、どのくらいの時間実行されたかが正確にわかるため、望ましくない挙動を簡単に見つけることができます。 よくある例が、withContext(Dispatchers.IO)の書き忘れです。以下のプロファイルでメインスレッド(1)を見ると、ユーザー入力がディスパッチされ(2)、ViewModelが呼び出されています。ViewModelはリポジトリを呼び出し、リポジトリはGsonライブラリを使って大きなJSONアセットを解析しています(3)。 UI、ViewModel、リポジトリの各レイヤーは、それぞれ単体で見れば正しく見えます。しかし、どのレイヤーも処理をメインスレッドから移していません。プロファイルを見れば一目瞭然で、GsonがメインスレッドでJSONデータの解析に1秒以上を費やし、UIのフリーズを引き起こしています。修正はViewModelの1行で済むかもしれません。 対応デバイスとレート制限 ProfilingManagerはAndroid 15以降で利用できます。最新の数値では、アクティブなAndroidデバイスの約41%に相当します(apilevels.com)。古いデバイスでは、無効にしない限り従来のプロファイラーにフォールバックします(詳しくは後述)。 また、いつプロファイリングするかはシステムが判断します。Androidはプロファイリングのリクエストにレート制限をかけており、リクエストに必ず応えるとは保証していません。実際には、profileSessionSampleRateを1.0に設定していても、すべてのセッションでプロファイルが取得されるわけではありません。制限なしでローカルテストを行いたい場合は、デバイス上で制限を無効にできます。 始め方 まず、Sentry Android […]
【Sentry Flutter】Android のスコープ同期にかかるオーバーヘッドを削減

Article by: Gino Buenaflor(読了時間:4分) Sentry の SDK を導入すると、アプリ内でその分の処理が発生します。SDK は直近のアプリの動作をブレッドクラムとして記録し、ユーザー情報などの診断データも常に最新の状態に保っています。こうした情報を更新することを「スコープ更新」と呼びます。 Android では、スコープ更新をいったんワーカーアイソレートに送り、そこから Sentry Android SDK に渡しています。この流れを調べたところ、送る側のアイソレートと受け取る側のワーカーが、同じデータをそれぞれ正規化していることがわかりました。さらにエンコードの段階でも、本来は不要な JSON 文字列とバイトバッファを作っていました。 こうした重複をなくし、データを直接バイト列にエンコードするよう変更した結果、ベンチマークで使ったスコープデータでは処理時間が27〜30%短くなりました。 UI アイソレートから処理を移す Flutter のメインアイソレートは、アプリのロジック処理とフレームの構築を担っています。そのアイソレート上で SDK の同期処理を行うと、同じ実行時間を奪い合うことになります。 そこで、Sentry Android SDK の操作専用のワーカーアイソレートを導入しました。イベントエンベロープの受け渡しやブレッドクラム、ユーザー、コンテキストデータの同期などを担当します。スコープ更新の場合、役割分担は次のとおりです。 ワーカーが利用できる場合、エンコードとネイティブ呼び出しの処理は呼び出し元のアイソレートの外で行われます。ワーカーがまだ起動していない場合は、SDK が呼び出し元のアイソレート上でこれらの処理を行うようフォールバックします。 それでも、呼び出し元のアイソレートは更新のたびに準備と送信を行う必要があります。そこで、この準備処理とワーカー側の処理をあわせて見直し、同じ処理が繰り返されていないかを確認しました。 二重の正規化 Sentry Android SDK にデータを渡す前に、正規化を行います。値を順にたどって Sentry のデータ形式がサポートする型に変換し、サポート外のものを取り除く処理です。 変更前のコードでは、更新を行うアイソレート上で各オブジェクトを正規化してからワーカーに送っていました。ところが、ワーカー側の Java バイト配列ヘルパーも、エンコードの前にもう一度正規化していたのです。つまり、Sentry Android SDK に届くまでに、同じ値を2回処理していたことになります。 修正方法は、ワーカーに送る前に一度だけ正規化し、ヘルパー側の2回目の正規化を削除するというものでした。これにより、正規化だけにかかる時間はおよそ半分になりました。1.2 KB のブレッドクラムでは 7.57 µs から 3.78 […]
【Sentry Android SDK】20〜30%高速化しました!

Article by: Nelson Osacky(読了時間:4分) チームではこの四半期、Sentry Android SDKをより高速にするために取り組んできました。その結果、Android SDKの初期化時間を20〜30%短縮することができました。あわせてメモリ割り当ての削減とメモリリークの修正も行い、バックグラウンドのCPU時間も最大10%削減しています。 この20〜30%の改善は、バージョン8.43.0から8.54.0にかけてSentryAndroid.initの所要時間を計測した結果です。 これはアプリ起動のクリティカルパス上で行われる処理です。念のため補足すると、これはアプリ起動時間全体ではなく、合成デモアプリで計測した数値です。ただし、一部のお客様にも新バージョンを試してベンチマークを実行していただいたところ、20〜30%の起動時間改善とほぼ同様の結果が報告されています。(アプリはそれぞれ大きく異なり、使っているSentryの機能も違うため、実環境でのパフォーマンスは異なる場合があることは強調しておきます。) Sentry SDKは非常に多くのアプリで使われています。sentry-react-native、sentry-java、sentry-flutter(sentry-flutterとsentry-react-nativeにはsentry-javaが含まれます)の合計で、1日あたり約45億回のアプリ起動があり、そのうち約50%がコールドスタートです。 控えめに見積もっても、コールドスタート時間の25%短縮によって平均10msの削減になります。このデータをもとにすると、ユーザーとCPUの時間を1日あたり6,250時間節約でき、年間で約2.3MWhに相当します。これは米国の一般家庭1世帯の年間電力消費量の約5分の1、EUの読者向けに言えば、EUの一般家庭の電力消費量の約3分の2にあたります。 どのように実現したかというと、まず、Perfettoトレースを使ってSDKのボトルネックを計測し、バックログにあったお客様報告のパフォーマンス問題やメモリリークを掘り下げました。もちろん、お気に入りのLLM(なにしろ2026年ですから)とPerfetto agent skillを組み合わせて、起動パスの分析も行っています。Sentry Android SDKのパフォーマンス改善のために加えた変更は40以上にのぼります。変更のたびに新しいAndroid Macrobenchmarkの環境でベンチマークを取り、統計的に有意なパフォーマンス改善につながっているかを確認しました。 ヒント: パフォーマンスの問題(またはSDKのその他の問題)は、GitHubのsentry-javaリポジトリで新しいissueを作成してご報告ください。今後の改善に役立てます。可能であればPerfettoトレースも添付してください。 マクロベンチマーク中のSentryAndroid.initのPerfettoトレース 大量のコードがコードベースを重くしている今、アプリを高速化するいちばん簡単な方法は、Sentry Android SDKを最新バージョンに上げることです。これらの改善を活かすには、最新版のAndroid SDK(パフォーマンス改善は8.54.0以降)と、最新版のSentry Android Gradle Plugin(パフォーマンス改善は6.20.0以降)を組み合わせてご利用ください。そして、アプリの起動パフォーマンスにどのような影響があったか、ぜひフィードバックをお寄せください。お待ちしています。 内部で何が変わったのか気になる方のために、40の変更のうちいくつかをご紹介します。全一覧は、リリース8.43.2からリリース8.54.0までのchangelogのPerformanceセクションをご覧ください。 マニフェストデータをビルド時に解決する Sentry SDKでは、Android Manifestでオプションを設定できます。 マニフェストの解析は遅いことで知られており、バイトコードからオプションを読み取るよりもはるかに時間がかかります。そこで、ビルド時にSentry Android Gradle Pluginからアプリのバイトコードにオプションを書き込むようにしました。SDKはバイトコードにオプションが設定されていることを検出すると、マニフェストの読み込みを完全にスキップします。ベンチマークでは、これだけで6.5%の改善が見られました。詳しくはsentry-java #5976とsentry-android-gradle-plugin #1405をご覧ください。 クラスが利用可能かどうかの判定にも同じ手法を使いました。リフレクションは遅いため、リフレクションで判定する代わりにこの方法を採用しています。sentry-java #5875とsentry-android-gradle-plugin #1404をご参考ください。 DSN解析の高速化 java.net.URIは遅いことで知られており、Sentryには不要な多くのエッジケースまで処理しています。ベンチマークでは最大6msかかることがあり、SDKの初期化をブロックしていました。そこで、より軽量な独自のDSNパーサーに置き換えたところ、同じベンチマークでわずか1µs(約6000倍の高速化)になりました。詳しくはsentry-java #5448をご欄ください。 スレッドを共有のexecutorプールに移行する ART(Android […]
【Sentry Flutter SDK 10.0】ストリーミングトレースとより正確なクラッシュフリー率

Article by: Gino Buenaflor(読了時間:4分) Sentry Flutter SDK 10.0では、ストリーミングトレースがデフォルトになり、未処理のFlutterエラーがRelease Healthに与える影響が変わりました。アプリが動作し続けるエラーではセッションがクラッシュ扱いにならなくなったため、クラッシュフリー率が実際のアプリクラッシュをより正確に反映するようになります。 このリリースではほかにも、AndroidとiOSでのアプリ起動専用のトレース、ログとメトリクスのセットアップの簡素化、Dioのネットワークエラーのキャプチャ範囲の拡大、ReplayとスクリーンショットでのFlutterの機密コンテンツ指定への対応が含まれています。 ストリーミングトレースがデフォルトに これまでSDKは、トランザクションが終了するのを待ってからスパンを送信していました。v10では、スパンが完了するたびにバッチで送信します。自動インストルメンテーションでは、このストリーミングモデルがデフォルトで使われます。 たとえば、画面でカタログの読み込みは終わったものの、レコメンドのリクエストがまだ実行中という場合でも、完了したカタログのスパンはトランザクション全体の終了を待たずにSentryに届きます。 カスタムインストルメンテーションでは、計測したい処理を Sentry.startSpan でラップします。 スパンはコールバックの完了時に終了し、SDKが送信キューに追加します。 トレーシングには引き続き tracesSampleRate または tracesSampler の設定が必要です。アップグレードの際は、カスタムのトランザクションや子スパンの呼び出しをストリーミングスパンAPIに移行し、トランザクションフィルターとサンプリングのコールバックを見直してください。 移行に時間が必要な場合は、初期化時に options.traceLifecycle = SentryTraceLifecycle.static を設定すれば、トランザクションモードを維持できます。 より正確なクラッシュフリー率 未処理のFlutterエラーが、必ずしもアプリをクラッシュさせるわけではありません。Flutterはエラーを報告したうえで動作を続けられますが、以前のSDKではセッションがクラッシュ扱いになり、クラッシュフリー率が下がっていました。 v10でもこうしたエラーはSentryにキャプチャされますが、セッションはクラッシュ扱いにならず、実行中のままになります。アプリがクラッシュせずにセッションが終了した場合は unhandled、その後アプリがクラッシュした場合は crashed に分類されます。 アプリ起動に専用のトレース AndroidとiOSでは、v10から起動が独立した app.start ルートとして記録され、独自のサンプリング判定が行われます。以前は最初のナビゲーショントランザクションに含まれていました。 起動の内訳には、ルートウィジェットのアタッチ、Flutterのフレームビルド、最初のフレームのラスタライズが含まれるため、起動のどの部分に時間がかかっているかを把握しやすくなります。 また、最初の画面に必要なデータの読み込みなど、最初のフレーム以降の処理まで計測範囲を広げることもできます。最初のフレームが描画される前に SentryFlutter.extendAppStart() を呼び出し、その処理が終わったら SentryFlutter.finishExtendedAppStart() を呼び出してください。 アップグレード時には、起動関連のダッシュボードとカスタムサンプリングルールを見直してください。ui.load ルートだけを受け入れるサンプラーでは、新しいapp-startトレースが除外される可能性があります。 ログとメトリクスのセットアップを簡素化 v10では、Sentry.logger や Sentry.metrics […]
【Sentry JavaScript SDK v11】すべてのJSプラットフォームでトレーシングに対応

Article by: Isaac Z. Schlueter(読了時間:12分) 本記事では、Sentry JavaScript SDKの最近の変更について紹介します。JavaScriptでSentryを使っていない方にも、変更の経緯や背景を知るうえで参考になる内容です。 Sentry JavaScript SDK v11では、トレーシングインテグレーションの仕組みを作り直しました。OpenTelemetry標準には引き続き対応していますが(詳しくは後述)、以前のバージョンのようにOpenTelemetryのインストルメンテーションクラスを使うのではなく、コードトランスフォーマーで依存関係をインストルメントするようになりました。 この仕組みは、アプリケーションパフォーマンス監視(APM)ベンダー各社が共同で取り組んでいるapm-js-collabのパッケージ、@apm-js-collab/code-transformerと@apm-js-collab/tracing-hooksをベースにしています。 インジェクションとサブスクリプション 新しいトレーシングインストルメンテーションは、2つの部分で動作します。1つ目はモジュールの読み込み時にdiagnostics channelを注入し、2つ目はそのチャネルのイベントを受け取ってトレーシング情報を集め、Sentryに送信します。 パート1:インジェクション 対応するモジュールが読み込まれると、実行時でもバンドラーの処理の中でも、トランスフォームがソースを書き換え、対象となる関数をtracingChannel()の呼び出しでラップします。 各トランスフォームは、パッケージ名、semver範囲、パッケージ内のファイル、関数を指定した設定に基づいて動作します。 トランスフォーム後のmysqlモジュールは、query関数が呼ばれるたびにstart、end、error、asyncStart、asyncEndのdiagnosticsイベントを発行するようになります。 パート2:サブスクリプション 各Sentryインテグレーション(mysqlIntegration、redisIntegration、openAIIntegrationなど)は、それぞれのチャネルをサブスクライブし、イベントをSentryのスパンに変換します。 サブスクライバーは余分なチャネルを作らないよう、対象のモジュールが実際に読み込まれたことを確認するまで待機します。 実行時とビルド時のインジェクション 同じトランスフォームが2つの場所で実行され、両方を同時に有効にすることもできます。モジュールはバンドラー経由かnode_modulesからのどちらか一方で読み込まれるため、二重にラップされることはありません。 実行時 最近のバージョンのNodeやDeno 2.8.3以降では、Sentry.init()が自動的にregisterDiagnosticsChannelInjection()を呼び出し、Module.registerHooks APIを使って、それ以降に読み込まれる対応モジュールをインストルメントします。 DenoとNodeのSDKが提供するimportエンドポイントを使えば、アプリの読み込み前にフックを登録することもできます。 ビルド時 bun buildを使っている場合や、Viteやesbuildなどのバンドラーでプログラムをバンドルしている場合は、提供されているプラグインを使って、アプリケーションへのビルド時にモジュールをインストルメントできます。 @sentry/nodeはVite、Rollup、webpack、esbuild向けのプラグイン、@sentry/cloudflareはVite向けのプラグイン、@sentry/bunはbun build向けのプラグインを提供しています。Next.jsでは、webpackローダーがwebpackとTurbopackの両方に組み込まれます。 プラグインはインストルメント対象の依存関係をバンドル時にトランスフォームし、バンドルされたモジュールが最初に評価されたときに、そのモジュール(およびサブスクライバーファクトリー)をグローバルマーカーに登録するスニペットを差し込みます。 使い方は、ほかのSentryバンドラープラグインと同じです。 v11以前のアプローチ v11以前、Sentryのインテグレーションはほぼすべて、OpenTelemetryのインストルメンテーションAPIをベースにしていました。オープンソースコミュニティの成果を活用できましたが、JavaScriptプラットフォームの選択肢が広がるにつれて深刻になっていくという大きな欠点がありました。 OpenTelemetryインストルメンテーションの内部 @opentelemetry/instrumentation-expressのようなOpenTelemetryインストルメンテーションパッケージは、InstrumentationBaseを継承したクラスをエクスポートします。このクラスでは、パッケージ名、対応するsemver範囲、patch(moduleExports, version)関数を宣言します。また、InstrumentationNodeModuleFileエントリを宣言して、パッケージ内の個別のファイルだけにパッチを当てることもできます。 registerInstrumentations()は、2つのローダーフックをインストールします。 require-in-the-middle — […]
Unreal MCPがSentryに対応しました

Article by: Ivan Tustanivskyi(読了時間:7分) ゲームのリリース作業の中で、クラッシュレポートの設定が一番楽しい作業だということはまずありません。DSNを貼り付け、Project Settingsでいくつかのチェックボックスを切り替え、シンボルアップロードを有効にし、ビルドをパッケージ化して、わざとクラッシュさせ、イベントがSentryに届いているか確認する…。難しくはありませんし(重要な作業でもあります)、それでも、できれば誰かに任せたいと思うような作業です。 Unreal Engine 5.8では、その「誰か」をコーディングエージェントにできます。これまでエージェントにできたのはC++の読み書きだけで、エディタはエージェントにとってブラックボックスのままでした。 Unreal MCP は、エディタ内でファーストパーティのMCPサーバーを動かし、エージェントがエディタを直接操作できるようにする、新しい実験的なエンジン機能です。Epicは標準で、アクターのスポーン、マテリアルの作成、自動テストの実行など、数百ものツールを提供しています。 Sentryにとって重要なのは、このツール一覧が固定ではないという点です。プラグインはC++またはPythonで独自のツールをエディタに登録でき、エージェントからはEpicのツールと同じように見えます。Unrealプラグインが利用しているのはまさにこの仕組みです。Claude Code、Cursor、Codexなど、どのエージェントを使っていても、Sentryのセットアップ、プロジェクトのインストルメント、キャプチャしたクラッシュのデバッグ支援に必要なものがすべて揃いました。 Sentryプラグインでできること MCPを有効にした状態でエディタを起動すると、Sentryプラグインは、実行中のエディタ内からSDKを確認・変更できる小さなツールセットと、その使い方をエージェントに伝える複数のエージェントスキルを登録します。 ツールが「手」なら、スキルは「手順書」です。Claude CodeやCursor向けのSentry agent pluginを使ったことがあれば、見覚えがあるはずです。同じワークフローをUnreal向けに調整したものだからです。 Get Started — SentryアカウントからDSNを取得して適用し、テストイベントが届くことを確認します。 Fix Stack Traces — デバッグシンボルの自動アップロードを有効にし、必要な認証情報の設定を手伝います。 Instrument — クラッシュのキャプチャに加えて、トレーシング、構造化ログ、メトリクス、セッションリプレイ、ユーザーフィードバックを設定します。 Debug Issue — Sentryのイシューのコンテキストをすべて取得し、プロジェクトのソースと照らし合わせて根本原因を特定し、修正のリリースまでを支援します。 各スキルには、セットアップのときに隣に座っていたら伝えるようなアドバイスが組み込まれています。 Get Started は、エディタのDSNがプロジェクトのDSNより優先されることを把握しているので、何かを変更する前にDSNの出どころを確認します。 Fix Stack Traces は、シンボルアップロードがパッケージビルドでしか実行されないことを把握しているので、フルビルドを待ってから問題に気づく、ということがないよう、先に認証情報を検証します。 さらに、どのスキルも同じ基本ルールに従います。プロジェクトを変更する前に確認を取り、認証トークンなどのシークレットを読み取ったり表示したりすることは一切ありません。設定はその場で適用されるため、エディタを再起動する必要もありません。 セットアップ手順 必要なのはUnreal Engine 5.8とSentryプラグイン1.24.0以降だけです。それ以外はすべて同梱されています。 1. […]
【Sentry Laravel AI】インテグレーションができるまで

Article by: Martin Linzmayer(読了時間:4分) 先日のAgent Hackweek(好きなAIやエージェント関連のプロジェクトに1週間取り組めるSentryの社内イベント)で、同僚からLaravel AIインテグレーションを作らないかと誘われました。他のフレームワーク向けにすでに提供しているAgent TracingのサポートをLaravel AIで構築したエージェントにも広げることが目的です。 いいアイデアだと思いました。彼は以前、PythonベースのエージェントのためにSentryのAgent Tracingを構築しており、ドメイン知識をすでに持っていましたし、このイベントではAIを使うことになっていたので、言語の壁も大きな問題にはなりませんでした。 不要だった防御的なコード Claudeならコーディングはそれなりにこなしてくれるだろうと、かなり自信がありました。Laravelは型付きのデータを持つEventsを公開しているので、データの形はほぼ把握できるはずです。 ところが最初のレビューで、Claudeは実際にはデータの正しい形を把握できておらず、フィールドにできるかぎり汎用的な方法でアクセスするヘルパーを作っていたので、少し驚きました。 しばらくPHPから離れている方のために説明すると、このスニペットは構造に関係なく、配列やオブジェクトから値を取り出そうとする汎用ヘルパーです。$source->{$key} は $key を文字列の値に解決し、そのフィールドにアクセスします。言うまでもなく、これは良いPHPコードとは言えません。たいていの場合、データの形はもっと限定されているため、役に立つ場面はほとんどありません。 Laravel AIのライフサイクルにフックする PythonやJavaScriptでのインストルメンテーションは、比較的簡単なことが多く、関数をラップしたり、パッチを当てたりするだけで済みます。しかし、PHPではそうはいきません。フレームワークやライブラリのフックに頼るか、ユーザーにクラスを独自のものへ置き換えてもらう必要があります。後者をできるだけ避けているのは、ユーザーにコードの書き換えを求めるようでは、インテグレーションとは呼べないからです。幸い、Laravel AIは重要な部分のほとんどでイベントを発行します。ただし、すべてではありません。 Laravel AIにはライフサイクルにフックする手段が十分そろっているように見えました。PromptingAgent と AgentPrompted イベントはエージェントとのやり取り全体を、InvokingTool と ToolInvoked は個々のツール呼び出しをカバーしています。 Agent Tracingには、もう一段細かい粒度が必要です。LLMの呼び出しを1回ずつ、個別のChatスパンとして表示しなければなりません。Laravel AIはこうした呼び出しに対するイベントを公開していないため、ライフサイクルイベントだけに頼ると、トレースに大きな抜けが生じてしまいます。 LLM呼び出しとHTTPリクエストを照合する ほとんどのLLM呼び出しは、最終的にHTTPリクエストになります。Laravelにはそのためのイベントとして RequestSending と ResponseReceived があります。エージェントとのやり取り中に発生したすべてのHTTPリクエストにChatスパンを作成することもできますが、それではツールによるHTTP呼び出しなど、無関係なリクエストまでキャプチャしてしまいます。 LaravelのHTTPイベントにはAI呼び出しのIDが含まれていないため、リクエストを直接関連付けることはできません。そこで、アクティブな呼び出しごとに設定済みのプロバイダーURLのプレフィックスを保存し、送信されるすべてのリクエストのURLと比較することにしました。複数のアクティブな呼び出しが一致した場合は、最後に開始されたものにリクエストを関連付けます。一致したリクエストだけがChatスパンになるため、個々のLLM呼び出しを取りこぼすことなく、無関係なHTTPトラフィックを除外できます。 設定不要のトレーシング Laravel AIインテグレーションは、sentry-laravel 4.27でリリースされました。すでにSentryのトレーシングを有効にしているアプリケーションなら、SDKをアップデートするだけです。インテグレーションの登録も、Sentry固有のコードの追加も必要ありません。通常のLaravel AIエージェントは自動的にトレースされ、Conversational を実装すればConversationsにも対応します。 Sentryのコードはどこにもありません。このクラスからのエージェント呼び出し、LLMリクエスト、ツール呼び出しはAgent Tracingに表示され、会話のコンテキストはExploreのAgentsセクションに表示されます。 Sentryで確認する […]
【dataCollection のご紹介】スイッチ1つからコントロールパネルへ

Article by: Sigrid Huemer(読了時間:6分) 本記事とコード例はJavaScript SDKを対象としています。別のプラットフォームをお使いの場合でも、今回の変更の背景や今後の展開を理解するために、ぜひご一読ください。 Sentry では、真偽値(boolean)の sendDefaultPii を、dataCollection という新しいオプションに置き換えます。従来のスイッチはオンにすればすべて取得、オフにすればごく一部しか取得できない、オールオアナッシングの仕組みでした。cookie は除いて request header だけがほしい、あるいはユーザーのメールアドレスまで送らずに GenAI の入力だけがほしい。そんな場面に出くわしたことがあれば、この仕組みの物足りなさはおわかりでしょう。dataCollection はこの1つのスイッチをいわばコントロールパネルに近いものへと変えます。データのカテゴリごとに、上げる・下げる・絞り込むといった調整ができるダイヤルになるのです。 変わる内容とその時期 dataCollection はすべての Sentry SDK に導入されます。JavaScript SDK では 10.57.0 から利用できるため、すでにこのオプションを見かけた方もいるかもしれません。dataCollection が新しいデフォルトのオプションとなり、sendDefaultPii が完全に廃止されるのは、バージョン11のリリースです。考え方はどのプラットフォームでも共通ですが、具体的なデフォルト値や移行手順は異なる場合があり、SDK ごとの詳細はそれぞれのリリースノートで説明されます。 v11 の JavaScript SDK にとって、これは単なる名称変更ではなく、挙動の変更です。新しいデフォルトは、従来よりも多くのデータを収集します。sendDefaultPii はすでに非推奨となっており、v11 で削除されます。他の Sentry SDK もそれぞれのタイミングで廃止していく予定であり、最終的な行き先はいずれも dataCollection です。 PII とセンシティブデータ SDK は2種類のデータをそれぞれ異なる方法で扱います。PII(個人を特定できる情報、Personally Identifiable Information)とは、ユーザー ID、メールアドレス、ユーザー名、氏名など、個人に結びつくあらゆる情報を指します。センシティブデータとは、パスワード、トークン、API キーといった認証情報や秘密情報のことです。 […]
【Unreal Engine Session Replay】クラッシュ前のクラッシュ

Article by: Ivan Tustanivskyi(読了時間:6分) よくある話です。クラッシュレポートがキューに届きます。スタックトレースはきれいに取れているものの、指しているのはいかにも無害そうな関数だけ。プレイヤーがその直前に何をしていたのかを示す手がかりは、どこにもありません。ボス戦の真っ最中だったのか、ロード画面で Alt+Tab を押していたのか、チュートリアルで立ち止まっていただけなのか、QAでは再現できず、プレイヤーからのバグ報告は「ゲーム落ちたw」の一言。残されたコアダンプとコールスタックを前に、当てものクイズを始めるしかありません。 スタックトレースは、コードがどこでクラッシュしたかは教えてくれます。しかし、なぜクラッシュしたのかまでは教えてくれません。ゲームは、一般的なデスクトップアプリケーションやモバイルアプリケーションに比べて、実行環境による影響をはるかに受けやすいソフトウェアです。だからこそ、「なぜ」の答えは、たいていクラッシュ直前の数秒間にあります。 Session Replayが埋めてくれるのは、まさにそのギャップです。新たに Session Replay に対応したことで、Unreal Engine 向けの Sentry SDK は直近数秒のゲームプレイを継続的に録画し、そのクリップをクラッシュレポートに添付できるようになりました。クラッシュが Sentry に届くと、その映像も一緒に届きます。おかげで物事がおかしくなった瞬間まで、プレイヤーが見ていたものをそのまま見られるのです。 Session Replay で得られるもの リプレイ付きのクラッシュが届くと、クラッシュイベントにひも付いた形で Replays ページに表示されます。そこでは、ゲームの実際のレンダリング済みフレームを再生できるほか、その過程で発生した重要な出来事を時系列に並べた、スクラブ可能なタイムラインも確認できます。 ▶ インタラクティブデモ:https://demo.arcade.software/8AgdLvo1bz99viH3a842/?embed デバッグの主役は、プレイヤーの隣に並ぶパネルです。映像と AI によるリプレイ要約に加えて、各リプレイでは次の情報も確認できます。 タグとコンテキスト — OSとそのバージョン、リリース、クラッシュの種類、リージョンなど、本来ならプレイヤーに確認しなければ分からない情報です。 Breadcrumbs — エラーやゲームプレイ中のイベント、独自に記録したカスタム breadcrumbs が映像と同期したタイムライン上に表示されます。 ログ — ゲームのログ出力を映像に合わせてタイムスタンプ付きで確認できます。 トレース — クラッシュに至るまでのスパンが共通のトレースIDで結び付けられています。バックエンドが関係するクラッシュであれば、同じトレースに含まれるサーバー側のスパンもここからたどることができます。 上の例では、これだけで何が起きたのかが分かります。開始から3秒後、チェックアウトのHTTPリクエストが不正な値を返し、ensure が発火。プレイヤーはレベル2に到達し、「Wrath」の攻撃モディファイアを選択。そして00:22、ASentryTowerTurret::Shoot で致命的なクラッシュが発生します。 これは、クラッシュそのものが再現手順を教えてくれるようなものです。しかも、映像を確認するためにクラッシュの詳細画面を離れる必要はありません。リプレイはクラッシュイベントのページにそのまま埋め込まれているため、Issueのトリアージは直前数秒のゲームプレイを確認するところから始められます。さらに詳しく調べたくなったら、ワンクリックでリプレイの全画面表示へ切り替えられます。 ▶ インタラクティブデモ:https://demo.arcade.software/wbJ8cKhmNjSzcdAECCz1/?embed […]
【Godot .NET サポート】一般提供開始

Article by: Serhii Snitsaruk(読了時間:2分) 先日、Sentry の Godot Engine SDK のバージョン 2.0.0 をリリースし、C#/.NET サポートとアプリケーションメトリクスを一般提供(GA)しました。これにより、マネージド C# コードからエラーを捉え、開発ビルドと製品版ビルドの両方でカスタムメトリクスを追跡できるようになりました。 C#/.NET サポート Godot は非常に性格の異なる2つのスクリプティングの世界、GDScript と C# をサポートしています。1.x のリリースでは、GDScript、エンジン本体、ネイティブの C/C++ コードから Issue を捉えられるよう SDK をインストルメントし、公式にサポートされるすべてのプラットフォームへとサポートを広げてきました。2.0.0 のリリースでは、Godot Engine 上での .NET 向けの第一級のエラーレポートを導入します。 マネージドコードからのエラーは、GDScript やエンジンの Issue と同じトレース上に並んで表示されるようになり、タグ・breadcrumbs・ユーザーコンテキストといった scope の要素も、現時点で同期されている範囲で付与されます。 では、これが実際にどう動くのかを見てみましょう。以下は私たちの Godot ゲームで実行時に例外を投げる C# コードの短縮版です。 private List<UpgradePathBase>? TryFetchUpgradesFromServer(){var fetchTransaction = SentrySdk.StartTransaction(“fetch_upgrades”, […]