Artikel ini membahas proses logging, termasuk standar log, pedoman level, kelas, tujuan, dan perkiraan multistack.

Standar Log

Logging di Android rumit karena campuran standar yang digunakan digabungkan dalam logcat . Standar utama yang digunakan dirinci di bawah ini:

Gambar 1: Standar tingkat log.

Meskipun masing-masing standar ini memiliki tingkat konstruksi yang serupa, namun rinciannya berbeda-beda. Perkiraan persamaan di seluruh standar adalah sebagai berikut:

Gambar 2: tingkat logging syslog , Android, dan Java.

Pedoman Tingkat Log

Terdapat pedoman yang diberikan untuk setiap standar log. Level log yang dipilih mengikuti standar yang sesuai yang digunakan, seperti menggunakan standar syslog untuk pengembangan kernel.

Urutan tingkat log, dari yang paling kecil hingga yang paling banyak, ditunjukkan pada tiga gambar di bawah ini:

Gambar 3: android.util.Log

Gambar 4: java.util.Logging.Level .

Gambar 5: RFC 5424 - Bagian 6.2.1 .

Pencatatan Aplikasi

Pencatatan log selektif dilakukan dengan TAG oleh kelas android.util.Log menggunakan Log#isLoggable , seperti yang ditunjukkan di bawah ini:

if (Log.isLoggable("FOO_TAG", Log.VERBOSE)) {
 Log.v("FOO_TAG", "Message for logging.");
}

Log dapat disetel saat runtime untuk memberikan tingkat logging tertentu seperti yang ditunjukkan di bawah ini:

adb shell setprop log.tag.FOO_TAG VERBOSE

properti log.tag.* disetel ulang saat reboot. Ada varian tetap yang tetap ada saat reboot juga. Lihat di bawah:

adb shell setprop persist.log.tag.FOO_TAG VERBOSE

Pemeriksaan Log#isLoggable meninggalkan jejak log dalam kode aplikasi. Tanda DEBUG Boolean mengabaikan jejak log menggunakan pengoptimalan kompiler yang disetel ke false , seperti yang ditunjukkan di bawah ini:

private final static boolean DEBUG = false;


…
If (DEBUG) {
 Log.v("FOO_TAG", "Extra debug logging.");
}

Logging dapat dihapus per APK melalui aturan ProGuard oleh R8 pada waktu kompilasi. Contoh berikut menghapus semua logging di bawah level INFO untuk android.util.Log :

# This allows proguard to strip isLoggable() blocks containing only <=INFO log
# code from release builds.
-assumenosideeffects class android.util.Log {
  static *** i(...);
  static *** d(...);
  static *** v(...);
  static *** isLoggable(...);
}
-maximumremovedandroidloglevel 4

Hal ini berguna untuk menangani beberapa tipe build aplikasi (misalnya, build pengembangan vs. build rilis) yang kode dasarnya diharapkan sama, namun tingkat log yang diizinkan berbeda. Kebijakan eksplisit harus ditetapkan dan diikuti untuk aplikasi (khususnya aplikasi sistem) untuk memutuskan bagaimana tipe build dan ekspektasi rilis memengaruhi keluaran log.

Pencatatan Sistem di Android Runtime (ART)

Ada beberapa kelas yang tersedia untuk aplikasi dan layanan sistem:

Gambar 6: Kelas dan tujuan log sistem yang tersedia.

Meskipun android.util.Log dan android.util.Slog menggunakan standar tingkat log yang sama, Slog adalah kelas @hide yang hanya dapat digunakan oleh platform. Level EventLog dipetakan ke entri dalam file event.logtags di /system/etc/event-log-tags .

Pencatatan Asli

Masuk ke C/C++ mengikuti standar syslog dengan syslog (2) yang berhubungan dengan syslog kernel Linux yang mengontrol buffer printk , dan syslog (3) yang berhubungan dengan logger sistem umum. Android menggunakan perpustakaan liblog untuk pencatatan sistem umum.

liblog menyediakan wrapper untuk grup sublog menggunakan formulir makro berikut:

RLOGD , misalnya, berhubungan dengan [Radio log buffer ID] LOG [Debug Level] . Pembungkus liblog utama adalah sebagai berikut:

Gambar 7: pembungkus liblog .

Android memiliki antarmuka tingkat tinggi untuk logging yang lebih disukai daripada penggunaan liblog langsung, seperti terlihat di bawah:

Gambar 8: Perpustakaan log tingkat yang lebih tinggi.

Perkiraan Multistack

Karena perbedaan dalam perincian dan tingkat maksud, tidak ada pencocokan yang jelas atau tepat untuk berbagai standar logging. Misalnya, level java.util.logging.Level dan android.util.Log untuk log kesalahan tidak cocok dengan perbandingan 1:1:

Gambar 9: Tingkat kesalahan dalam logging Java standar vs. logging Android.

Dalam kasus seperti ini, gunakan standar individual untuk menentukan level mana yang akan diterapkan.

Selama pengembangan sistem dengan beberapa komponen tingkat tumpukan, ikuti Gambar 1 untuk menentukan standar mana yang akan digunakan per komponen. Untuk panduan perkiraan mengenai pesan tingkat, ikuti Gambar 2.

Keamanan dan Privasi

Jangan mencatat Informasi Identifikasi Pribadi (PII). Ini termasuk rincian seperti:

• Alamat email
• Nomor telepon
• Nama

Demikian pula, detail tertentu dianggap sensitif meskipun tidak secara eksplisit dapat diidentifikasi secara pribadi.

Misalnya, meskipun informasi zona waktu tidak dianggap dapat diidentifikasi secara pribadi, informasi tersebut memberikan indikasi perkiraan lokasi pengguna.

Kebijakan log dan detail yang dapat diterima harus ditangani sebagai bagian dari tinjauan keamanan dan privasi sebelum dirilis.

Log Perangkat

Akses ke semua log perangkat, termasuk penggunaan android.permission.READ_LOGS dibatasi:

• Jika aplikasi di latar belakang meminta akses ke semua log perangkat, permintaan tersebut secara otomatis ditolak kecuali aplikasi:
• berbagi UID sistem.
• menggunakan proses sistem asli ( UID < APP_UID ).
• menggunakan DropBoxManager .
• hanya mengakses buffer log peristiwa.
• menggunakan API EventLog .
• menggunakan tes berinstrumen.
• Jika aplikasi di latar depan dengan READ_LOGS meminta akses ke log perangkat, sistem akan meminta pengguna untuk menyetujui atau menolak permintaan akses.