- [On-device] - 実行中のアプリとシステムアクティビティを監視して、リアルタイムのパフォーマンスデータを収集します。
- [On-host] - デバイス上でこれまでに収集されたデータを処理して表示します。
Simpleperfを使用するケース
前提条件
開始する前に、以下の準備が整っていることを確認してください。- Vega SDKのインストールが完了していること
- Fire TV StickデバイスがVDA経由で接続されていること
- アプリをデバイス上でビルドして実行していること
Simpleperfのセットアップ
Simpleperfはデフォルトではデバイスイメージに含まれていません。Vega SDKに含まれるバイナリをデバイスにサイドロードする必要があります。手順1: ビルドバリアントを確認する
デバイスが、user-external``userまたはビルドバリアントを使用していることを確認します。どちらのビルドも Simpleperf で動作しますが、user-externalより一般的です。
手順2: 開発者モードを有効にする
デバイスで開発者モードを有効にします。手順3: デバイスに接続してアプリを起動する
デバイスへのシェル接続を開きます。vmsgrvmsgrを使用してアプリを起動します。以下に例を示します。
手順4: Simpleperfバイナリをデバイスにプッシュする
SimpleperfバイナリはSDKの次の場所にあります。tmp/scratchtmp/scratchフォルダで使用可能になります。
手順5: コンポーネントシェルにアクセスする
ホストマシンで新しいターミナルを開きます。最初のターミナルは手順3のvda shellvda shellセッションを実行しているため、別のターミナルが必要です。
コンポーネントシェルに接続します。
アプリのプロセスIDを確認する
プロファイリングを行う前に、アプリのプロセスID(PID)を確認します。pidofpidofでアプリを参照できます。
利用可能なイベントの一覧を表示する
デバイスがサポートしているイベントを確認する場合に使用しますsimpleperf list。
cachecache - ハードウェアキャッシュイベントrawraw - 未処理のCPU PMUイベントtracepoint— トレースポイントイベントcs-etmcs-etm - CoreSight ETMの命令トレースイベントpmupmu - システム固有のPMUイベント
-e``simpleperf stat``simpleperf recordおよびコマンドの実行時にオプションで使用できます。
statによるパフォーマンス統計の収集
simpleperf statsimpleperf statを使用して、CPUイベントの集計パフォーマンス統計を収集します。このモードでは、詳細なサンプリングデータによるオーバーヘッドなしに、ハードウェアとソフトウェアのイベントの簡潔な概要を提供します。これは、迅速なパフォーマンス評価や最適化のA/Bテストに役立ちます。
stat結果の解釈
出力を解釈するには、次のガイドラインを使用してください。
使用可能なすべてのオプションについて、
simpleperf help statを実行してください。
詳細なパフォーマンスデータの記録
事前定義された間隔でCPUイベントをサンプリングして詳細なCPUパフォーマンス指標を収集するには、simpleperf recordsimpleperf recordを使用します。記録されたすべてのデータは、後で分析できるようにperf.dataperf.dataファイルに保存されます。
イベントには、ユーザースペースのみ(:u:u)またはカーネルスペースのみ(:k:k)をモニタリングするようにスコープを指定できます。ほとんどの場合、Vegaアプリのプロファイリングでは、ユーザースペースの監視を使用してください。
simpleperf help recordを実行してください。
パフォーマンスデータをホストマシンに転送する方法
パフォーマンスデータは、コンポーネントシェルの/scratch/scratchディレクトリに保存されます。これらのファイルを取得するには、ホストマシン(コンポーネントシェルの外部)でターミナルを開き、次のコマンドを実行します。
レポートによるパフォーマンスデータの分析
simpleperf reportホストマシンで使用して、perf.data収集したファイルを分析します。次の場所にあるSDKに含まれるホスト版のSimpleperfを使用します。
0.23.6323)に置き換えます。
simpleperf help reportを実行してください。
その他のコマンド
simpleperfには、プロファイリング用途に特化した追加のコマンドが含まれています。
サブコマンドとそのオプションを一覧表示するには、次のようにします。
既知の制限事項
Simpleperfはperf_event_paranoidperf_event_paranoidカーネルパラメーターに基づいて操作権限を決定します。Vega OSでは、この値はデフォルトで22に設定され、セキュリティ上の理由から特定のプロファイリング機能が制限されます。
user-externaluser-externalビルドバリアントを搭載したデバイスで開発者モードが有効になっている場合は、この値が自動的に11に調整され、より包括的なプロファイリングが可能になります。ただし、権限のないユーザーでは引き続き次の操作が制限されます。
- カーネルスペースイベントのプロファイリング
- ハードウェアPMUイベントへのアクセス
- 他のユーザーのプロセスのプロファイリング
- 未処理のトレースポイントイベントの収集
- カーネルコールグラフへのアクセス
- カーネルモードのスタックトレースの収集
ベストプラクティス
データの収集
- 必ず期間を指定するか、制御された方法で終了させます。
- 適切なサンプリング頻度を使用します。
- プロファイリング中にシステム負荷を監視します。
イベントの選択
- 基本イベント (
cpu-cycles,instructions) から始めましょう。 - 同時に発生するハードウェアイベントの数が多くなりすぎないようにします。
- ターゲットデバイスのハードウェア制限を考慮します。
レポート分析
- 複数の実行を比較すると、一貫した結果が得られます。
- 適切なフィルターを使用して結果を絞り込みます。
- 必ずサンプルの欠落がないか確認します。
リソースの管理
perf.data古いファイルをクリーンアップしてデバイスストレージを解放します。- サンプリングの頻度を制限してCPUオーバーヘッドを制御します。
例: スクロール中のフレーム落ちの診断方法
このチュートリアルでは、Simpleperfを使用して、コンテンツ一覧のスクロール中にフレーム落ちするアプリを調査する方法を説明します。 1.statで問題を確認するcontext-switches(500/秒を超える)か、cache-missesそれよりも高い場合はcpu-cycles、調査する価値のあるパフォーマンスの問題がある可能性があります。
2.問題のあるインタラクション中にコールグラフを記録する
Overheadパーセンテージが高い関数を探してください。以下に例を示します。

