Bài viết này đề cập đến quá trình ghi nhật ký, bao gồm tiêu chuẩn nhật ký, hướng dẫn cấp độ, lớp, mục đích và xấp xỉ nhiều ngăn xếp.

Đăng nhập tiêu chuẩn

Đăng nhập Android rất phức tạp do sử dụng hỗn hợp các tiêu chuẩn được kết hợp trong logcat . Các tiêu chuẩn chính được sử dụng được trình bày chi tiết dưới đây:

Hình 1: Tiêu chuẩn cấp nhật ký.

Mặc dù mỗi tiêu chuẩn này có cấu trúc mức độ tương tự nhau, nhưng chúng khác nhau về mức độ chi tiết. Tương đương gần đúng giữa các tiêu chuẩn như sau:

Hình 2: Các mức ghi syslog , Android và Java.

Hướng dẫn cấp nhật ký

Hiện có các hướng dẫn được đưa ra cho từng tiêu chuẩn nhật ký. Cấp nhật ký đã chọn tuân theo tiêu chuẩn phù hợp đang được sử dụng, như sử dụng tiêu chuẩn syslog để phát triển nhân.

Thứ tự cấp nhật ký, từ thấp nhất đến cao nhất, được hiển thị trong ba hình bên dưới:

Hình 3: android.util.Log

Hình 4: java.util.Logging.Level .

Hình 5: RFC 5424 - Mục 6.2.1 .

Ghi nhật ký ứng dụng

Ghi nhật ký chọn lọc được thực hiện với TAG bởi lớp android.util.Log sử dụng Log#isLoggable , như minh họa bên dưới:

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

Nhật ký có thể được điều chỉnh trong thời gian chạy để cung cấp mức ghi nhật ký được chọn như hình bên dưới:

adb shell setprop log.tag.FOO_TAG VERBOSE

thuộc tính log.tag.* được đặt lại khi khởi động lại. Có những biến thể liên tục vẫn tồn tại trong quá trình khởi động lại. Xem bên dưới:

adb shell setprop persist.log.tag.FOO_TAG VERBOSE

Kiểm tra Log#isLoggable để lại dấu vết nhật ký trong mã ứng dụng. Các cờ DEBUG Boolean bỏ qua các dấu vết nhật ký bằng cách sử dụng tối ưu hóa trình biên dịch được đặt thành false , như minh họa bên dưới:

private final static boolean DEBUG = false;


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

Việc ghi nhật ký có thể được xóa trên cơ sở mỗi APK thông qua bộ quy tắc ProGuard của R8 tại thời điểm biên dịch. Ví dụ sau xóa mọi thứ bên dưới ghi nhật ký mức INFO cho 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

Điều này hữu ích để xử lý nhiều loại bản dựng ứng dụng (ví dụ: bản dựng phát triển so với bản phát hành) trong đó mã cơ sở dự kiến ​​sẽ giống nhau nhưng mức nhật ký được phép thì khác nhau. Một chính sách rõ ràng phải được thiết lập và tuân theo đối với các ứng dụng (đặc biệt là các ứng dụng hệ thống) để quyết định cách các loại bản dựng và kỳ vọng phát hành tác động đến đầu ra nhật ký.

Ghi nhật ký hệ thống trong Thời gian chạy Android (ART)

Có một số lớp khả dụng dành cho các ứng dụng và dịch vụ hệ thống:

Hình 6: Các lớp và mục đích của nhật ký hệ thống khả dụng.

Mặc dù android.util.Log và android.util.Slog sử dụng cùng tiêu chuẩn mức nhật ký, nhưng Slog là một lớp @hide chỉ nền tảng mới có thể sử dụng được. Các mức Nhật ký sự kiện được ánh xạ tới các mục trong event.logtags EventLog /system/etc/event-log-tags .

Ghi nhật ký gốc

Đăng nhập C/C++ tuân theo tiêu chuẩn syslog hệ thống với syslog (2) tương ứng với syslog của nhân Linux điều khiển bộ đệm printk và syslog (3) tương ứng với nhật ký hệ thống chung. Android sử dụng thư viện liblog để ghi nhật ký hệ thống chung.

liblog cung cấp trình bao bọc cho các nhóm nhật ký con bằng cách sử dụng biểu mẫu macro sau:

RLOGD , ví dụ, tương ứng với [Radio log buffer ID] LOG [Debug Level] . Các trình bao bọc liblog chính như sau:

Hình 7: trình bao bọc liblog .

Android có các giao diện cấp cao hơn để ghi nhật ký được ưa chuộng hơn so với việc sử dụng liblog trực tiếp, như được thấy bên dưới:

Hình 8: Thư viện nhật ký cấp cao hơn.

Xấp xỉ nhiều ngăn xếp

Do sự khác biệt về mức độ chi tiết và ý định cấp độ, không có kết hợp rõ ràng hoặc chính xác của các tiêu chuẩn ghi nhật ký khác nhau. Ví dụ: các mức java.util.logging.Level và android.util.Log cho nhật ký lỗi không khớp 1:1:

Hình 9: Mức độ lỗi trong ghi nhật ký Java tiêu chuẩn so với ghi nhật ký Android.

Trong những trường hợp như thế này, hãy sử dụng tiêu chuẩn cá nhân để xác định cấp độ nào sẽ áp dụng.

Trong quá trình phát triển hệ thống với nhiều thành phần cấp độ ngăn xếp, hãy làm theo Hình 1 để xác định tiêu chuẩn nào sẽ sử dụng cho mỗi thành phần. Để có hướng dẫn gần đúng về thông báo cấp, hãy làm theo Hình 2.

An ninh và sự riêng tư

Không đăng nhập Thông tin nhận dạng cá nhân (PII). Điều này bao gồm các chi tiết như:

• địa chỉ email
• Số điện thoại
• tên

Tương tự, một số chi tiết được coi là nhạy cảm ngay cả khi không thể nhận dạng cá nhân một cách rõ ràng.

Ví dụ: mặc dù thông tin múi giờ không được coi là có thể nhận dạng cá nhân, nhưng thông tin này cung cấp dấu hiệu về vị trí gần đúng của người dùng.

Chính sách nhật ký và các chi tiết có thể chấp nhận phải được xử lý như một phần của quá trình xem xét bảo mật và quyền riêng tư trước khi phát hành.

Nhật ký thiết bị

Quyền truy cập vào tất cả nhật ký thiết bị, kể cả việc sử dụng android.permission.READ_LOGS bị hạn chế:

• Nếu một ứng dụng trong nền yêu cầu quyền truy cập vào tất cả nhật ký thiết bị, thì yêu cầu đó sẽ tự động bị từ chối trừ khi ứng dụng:
• chia sẻ UID hệ thống.
• sử dụng quy trình hệ thống riêng ( UID < APP_UID ).
• sử dụng DropBoxManager .
• chỉ truy cập bộ đệm nhật ký sự kiện.
• sử dụng EventLog ký sự kiện.
• sử dụng các bài kiểm tra thiết bị.
• Nếu một ứng dụng ở nền trước có READ_LOGS yêu cầu quyền truy cập vào nhật ký thiết bị, hệ thống sẽ nhắc người dùng phê duyệt hoặc từ chối yêu cầu truy cập.