Vega StudioパフォーマンスCLI

パフォーマンスCLIは、Vega開発者ツール（VDT）の一部としてインストールされます。アプリのパフォーマンスを分析するには、Vega Studio拡張機能のコマンドパレットまたはパフォーマンスコマンドラインインターフェイス（CLI）を使用できます。

前提条件

1. Vega SDKをインストールします。

2. パフォーマンスCLIが開発環境にインストールされているかどうかを確認します。

   コードをコピー クリップボードにコピーしました。

   kepler exec perf --help
   

ヘルプオプション

すべてのパフォーマンスCLIコマンドのオプションを参照するには、次のコマンドを使用します。

kepler exec perf --help

特定のコマンドに関する情報を取得するには、次のコマンドを使用します。

kepler exec perf [コマンド] --help

recordコマンドのすべてのオプションを表示するには、次のコマンドを使用します。

kepler exec perf record --help

よく使用されるコマンド

kepler exec perf record

recordコマンドを使用して、Event Recordingツールを起動します。これにより、分析用にパフォーマンスイベントが取得されます。このコマンドは以下の引数を受け取ります。

• --app-name - manifest.tomlにあるアプリのメイン対話型コンポーネント名を指定します。
• --recording-timeout - 記録時間を秒単位で設定します（デフォルト： 120s）
• --device-serial-number - 複数のデバイスがある場合にデバイスのシリアル番号を設定します
• --output-dir - 出力ディレクトリパスを指定します。
• --trace-categories - トレース中に有効にするプラットフォームのトレースカテゴリーを指定します。デフォルトのカテゴリーは、app、graphics、ui、lifecycle、input、video、webviewです。
• --enable-cpu-sched - トレース中のCPUスケジューライベントの記録を有効にします（デフォルトでは無効）

アプリのパフォーマンスイベントを記録するには、次のコマンドを使用します。

kepler exec perf record --app-name com.<会社名>.<アプリ名>.main

特定のタイムアウトを指定して記録するには、次のコマンドを使用します。

kepler exec perf record --app-name com.<会社名>.<アプリ名>.main --recording-timeout 60

カスタムトレースカテゴリーを指定して記録するには、次のコマンドを使用します。

kepler exec perf record --app-name com.<会社名>.<アプリ名>.main --trace-categories app,graphics,ui,video

CPUスケジューライベントを有効にして記録するには、次のコマンドを使用します。

kepler exec perf record --app-name com.<会社名>.<アプリ名>.main --enable-cpu-sched

kepler exec perf activity-monitor

activity-monitorコマンドを使用して、Activity Monitorツールを起動します。このコマンドは以下の引数を受け取ります。

• --app-name - manifest.tomlにあるアプリのメイン対話型コンポーネント名を指定します。
• --record-cpu-profiling - 記録中にJavaScript CPUプロファイラーを有効にします
• --sdk-path - インストールされているVega SDKのパスを指定します（--record-cpu-profilingを使用する場合は必須）
• --sourcemap-file-path - JavaScriptソースマップパスを指定します（--record-cpu-profilingを使用する場合は必須）

アプリのアクティビティをモニタリングするには、次のコマンドを使用します。

kepler exec perf activity-monitor --app-name com.<会社名>.<アプリ名>.main

CPUプロファイリングを有効にして監視するには、次のコマンドを使用します。

kepler exec perf activity-monitor --app-name com.<会社名>.<アプリ名>.main --record-cpu-profiling --sdk-path /path/to/vega/sdk --sourcemap-file-path /path/to/sourcemap

kepler exec perf memory-monitor

memory-monitorコマンドを使用して、Memory Monitorツールを起動します。このコマンドは以下の引数を受け取ります。

• --app-name - manifest.tomlにあるアプリのメイン対話型コンポーネント名を指定します。
• --keplerscript-app - アプリがVega向けのReact Nativeベースのアプリであることを指定します。
• --relative-gc-count - ガベージコレクション（GC）カウントを現在のGCカウントと以前のGCカウントの差として示します（React Nativeベースのアプリについてのみ利用可能）

アプリメモリを監視するには、次のコマンドを使用します。

kepler exec perf memory-monitor --app-name com.<会社名>.<アプリ名>.main

React Nativeアプリの相対ガベージコレクション数で監視するには、次のコマンドを使用します。

kepler exec perf memory-monitor --app-name com.<会社名>.<アプリ名>.main --keplerscript-app --relative-gc-count

セッションの記録を開始および停止するには、次のコマンドを使用します。

Macの場合：

1. sを押して録音を開始します。
2. 録音を停止するには、もう一度sを押します。

sを押しても問題が解決しない場合は、SとReturnを押します。

Linuxの場合：

1. sを押して録音を開始します。
2. 録音を停止するには、もう一度sを押します。

sを押しても問題が解決しない場合は、SとEnterを押します。

録音を終了するには、qとReturnを押すか、qとEnterを押します。

kepler exec perf kpi-visualizer

kpi-visualizerコマンドを使用して、アプリのKPIを測定します。このコマンドは以下の引数を受け取ります。

• --app-name - manifest.tomlにあるアプリのメイン対話型コンポーネント名を指定します。
• --overridden-video-fps - 再生中のビデオの滑らかさを計算するための1秒あたりのフレーム数をオーバーライドします

アプリのKPIを測定するには、次のコマンドを使用します。

kepler exec perf kpi-visualizer --app-name com.<会社名>.<アプリ名>.main

ビデオの滑らかさの計算でビデオのFPSをオーバーライドするには、次のコマンドを使用します。

kepler exec perf kpi-visualizer --app-name com.<会社名>.<アプリ名>.main --overridden-video-fps 30

関連トピック

• Vega SDK CLIリファレンス
• Vega Studioのコマンド
• 💬 コミュニティ： Inspect JS traces from Vega Apps（英語のみ）
• 💬 コミュニティ： React DevToolsを使用してコンポーネントのレンダリングをプロファイリング

Last updated: 2025年10月8日