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. Hubungkan 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 memory

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

Untuk melihat daftar kategori yang didukung perangkat terhubung, 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 terhubung 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 rekaman aktivitas 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 Merekam aktivitas perangkat selama N detik. Jika Anda tidak menentukan opsi ini, systrace akan memerintahkan Anda untuk mengakhiri perekaman tersebut dengan menekan tombol Enter dari command line.
-b N | --buf-size=N Menggunakan ukuran buffer rekaman aktivitas N kilobyte. Dengan opsi ini, Anda dapat membatasi ukuran total data yang dikumpulkan selama perekaman.
-k functions
| --ktrace=functions
Melacak aktivitas fungsi kernel tertentu, yang ditetapkan dalam daftar yang dipisahkan koma.
-a app-name
| --app=app-name
Mengaktifkan perekaman aktivitas untuk aplikasi, yang ditetapkan sebagai daftar nama proses yang dipisahkan koma. Aplikasi tersebut harus berisi panggilan instrumentasi rekaman aktivitas dari class Trace. Opsi ini harus Anda tetapkan setiap kali membuat profil aplikasi—banyak library, seperti RecyclerView, menyertakan panggilan instrumentasi rekaman aktivitas yang memberikan informasi berguna saat mengaktifkan perekaman tingkat aplikasi. Untuk informasi selengkapnya, lihat Menentukan peristiwa kustom.

Untuk merekam aktivitas 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 terhubung 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 terhubung.