Google berkomitmen untuk mendorong terwujudnya keadilan rasial bagi komunitas Kulit Hitam. Lihat caranya.

Merekam pelacakan sistem di command line

Perintah systrace memanggil alat Systrace, yang memungkinkan Anda mengumpulkan dan memeriksa informasi pengaturan waktu dalam semua proses yang berjalan di perangkat Anda pada tingkat sistem.

Dokumen ini menjelaskan cara membuat laporan Systrace dari command line. Di perangkat yang menjalankan Android 9 (API level 28) atau yang lebih tinggi, Anda juga dapat menghasilkan laporan Systrace menggunakan aplikasi sistem Pelacakan Sistem.

Untuk menjalankan systrace, selesaikan langkah-langkah berikut:

  1. Dari Android Studio, download dan instal Android SDK Tools terbaru.
  2. Instal Python dan sertakan pada variabel lingkungan PATH workstation Anda.
  3. Tambahkan android-sdk/platform-tools/ ke variabel lingkungan PATH Anda. Direktori ini berisi biner Android Debug Bridge (adb), yang dipanggil oleh program systrace.
  4. Sambungkan perangkat yang menjalankan Android 4.3 (API level 18) atau yang lebih tinggi ke sistem pengembangan menggunakan koneksi proses debug USB.

Perintah systrace disediakan dalam paket Android SDK Tools dan berada di android-sdk/platform-tools/systrace/.

Sintaksis

Guna menghasilkan laporan HTML untuk aplikasi, Anda perlu menjalankan systrace dari command line menggunakan sintaksis berikut:

    python systrace.py [options] [categories]
    

Misalnya, perintah berikut memanggil systrace untuk merekam aktivitas perangkat dan menghasilkan laporan HTML bernama mynewtrace.html. Daftar kategori ini merupakan daftar default yang wajar untuk sebagian besar perangkat.

$ python systrace.py -o mynewtrace.html sched freq idle am wm gfx view \
        binder_driver hal dalvik camera input res
    

Tips: Jika ingin melihat nama tugas dalam output pelacakan, Anda harus menyertakan kategori sched pada parameter perintah.

Untuk melihat daftar kategori yang didukung perangkat tersambung, jalankan perintah berikut:

$ python systrace.py --list-categories
    

Jika Anda tidak menentukan kategori atau opsi apa pun, systrace akan menghasilkan laporan yang menyertakan semua kategori yang tersedia dan menggunakan setelan default. Kategori yang tersedia bergantung pada perangkat tersambung yang Anda gunakan.

Opsi global

Opsi global Deskripsi
-h | --help Menampilkan pesan bantuan.
-l | --list-categories Mencantumkan kategori pelacakan yang tersedia untuk perangkat yang terhubung.

Perintah dan opsi perintah

Perintah dan opsi Deskripsi
-o file Menulis laporan pelacakan HTML ke file yang ditentukan. Jika Anda tidak menentukan opsi ini, systrace akan menyimpan laporan Anda ke direktori yang sama dengan systrace.py dan memberinya nama trace.html.
-t N | --time=N Melacak aktivitas perangkat selama N detik. Jika Anda tidak menentukan opsi ini, systrace akan memerintahkan Anda untuk mengakhiri pelacakan tersebut dengan menekan tombol Enter dari command line.
-b N | --buf-size=N Menggunakan ukuran buffer pelacakan N kilobyte. Opsi ini memungkinkan Anda membatasi ukuran total data yang dikumpulkan selama pelacakan.
-k functions
| --ktrace=functions
Melacak aktivitas fungsi kernel tertentu, yang ditetapkan dalam daftar yang dipisahkan koma.
-a app-name
| --app=app-name
Mengaktifkan pelacakan untuk aplikasi, yang ditetapkan sebagai daftar nama proses yang dipisahkan koma. Aplikasi tersebut harus berisi panggilan instrumentasi pelacakan dari class Trace. Opsi ini harus Anda tetapkan setiap kali membuat profil aplikasi—banyak library, seperti RecyclerView, menyertakan panggilan instrumentasi pelacakan yang memberikan informasi berguna saat mengaktifkan pelacakan tingkat aplikasi. Untuk informasi selengkapnya, lihat Menentukan peristiwa kustom.

Untuk melacak semua aplikasi di perangkat yang menjalankan Android 9 (API level 28) atau yang lebih tinggi, teruskan karakter pengganti "*", termasuk tanda kutip.

--from-file=file-path Membuat laporan HTML interaktif dari file, seperti file TXT yang menyertakan data pelacakan raw, bukan menjalankan pelacakan langsung.
-e device-serial
| --serial=device-serial
Melakukan pelacakan pada perangkat tersambung tertentu, yang diidentifikasi melalui nomor seri perangkat tersebut.
categories Menyertakan informasi pelacakan untuk proses sistem yang Anda tentukan, seperti gfx untuk proses sistem yang merender grafis. Anda dapat menjalankan systrace dengan perintah -l untuk melihat daftar layanan yang tersedia bagi perangkat tersambung.