perfetto

perfetto は、Android Debug Bridge（ADB）を介して Android デバイスからパフォーマンス情報を収集するためのツールです。perfetto ツールを呼び出すには、adb shell perfetto ... コマンドを使用します。perfetto は、さまざまなソースを使用してデバイスから次のようなパフォーマンス トレースを収集します。

• ftrace: カーネルからの情報
• atrace: サービスとアプリでのユーザー空間アノテーション
• heapprofd: サービスとアプリのネイティブ メモリ使用情報

このページでは、perfetto を呼び出して、必要な出力を生成するための設定方法について説明します。詳しくは、perfetto のドキュメントをご覧ください。

構文

このセクションでは、ADB を使用して各種のモードで perfetto を呼び出し、トレースを生成する方法について説明します。

データソースの選択

perfetto には、トレースの記録に使用するデータソースを決定するモードが 2 つあります。

• ライトモード: データソースのサブセット（具体的には atrace と ftrace）のみを選択できます。ただし、このモードでは systrace に似たインターフェースが提供されます。
• 通常モード: プロトコル バッファで構成を取得します。atrace および ftrace とは異なるデータソースを使用して、perfetto の機能をさらに活用できます。

全般オプション

perfetto のどちらのモードでも利用できるオプションを次の表に示します。

表 1. 一般的に利用できる perfetto ツール オプションのリスト。

ライトモード

ライトモードで perfetto を使用する場合の一般的な構文は次のとおりです。

 adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
             [ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
             --out FILE

ライトモードで perfetto を使用する際に利用できるオプションを次の表に示します。

表 2. ライトモードを使用する際に利用できる perfetto ツール オプションのリスト。

これらのオプションの後に、イベント指定子のリストが続きます。

表 3: ライトモードにおけるイベント指定子のリスト。

    adb shell perfetto --out FILE wm
    

      adb shell perfetto --out FILE sched/sched_switch
      

通常モード

通常モードで perfetto を使用する場合の一般的な構文は次のとおりです。

 adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE

通常モードで perfetto を使用する際に利用できるオプションを次の表に示します。

表 4. 通常モードを使用する際に利用できる perfetto ツール オプションのリスト。

サポートされるデータソース

このセクションでは、perfetto がトレースの生成に使用するさまざまなソースについて説明します。

ftrace

ftrace データソースを使用すると、perfetto はカーネルからイベントを取得できます。

このソースを有効にするには、DataSourceConfig で ftrace_config を設定します。

有効にできるイベントは次のとおりです。

• アクティビティのスケジュール設定:

  • sched/sched_switch
  • sched/sched_wakeup
  • sched/sched_wakeup_new
  • sched/sched_process_exec
  • sched/sched_process_exit
  • sched/sched_process_fork
  • sched/sched_process_free
  • sched/sched_process_hang
  • sched/sched_process_wait

• ファイルシステム イベント:

  • ext4
  • f2fs
  • block

• atrace イベント

使用しているデバイス、OS バージョン、カーネルによっては、さらに多くのイベントを利用できます。詳しくは、構成 proto をご覧ください。

プロセスの統計情報

プロセス統計データソースを使用すると、システムと個々のプロセスについて収集されたカウンタを取得できます。

このソースを有効にするには、DataSourceConfig で process_stats_config と sys_stats_config を設定します。

perfetto が生成するデータには次のものがあります。

• システム全体

  • /proc/meminfo
  • /proc/vmstat
  • /proc/stat

• プロセスごと

  • /proc/\<pid\>/status
  • /proc/\<pid\>/oom_score_adj

使用しているデバイス、OS バージョン、カーネルによっては、さらに多くのイベントを利用できます。詳しくは、sys_stats と process_stats の構成 proto をご覧ください。

heapprofd

heapprofd を使用すると、ネイティブ メモリ使用の原因をサンプリングできます。

このソースを有効にするには、DataSourceConfig で heapprofd_config を設定します。この設定により、ProfilePackets（コールスタックの Java フレームを含む）が生成されます。

heapprofd の使用方法に関する追加情報は、perfetto.dev にあります。

その他のソース

使用しているデバイス、OS バージョン、カーネルによっては、より多くのデータソースを利用できます。詳しくは、データソース構成 proto をご覧ください。

perfetto に関する追加情報は、perfetto.dev にあります。