Phân tích dựa trên điều kiện kích hoạt

Trên Android 16 (cấp độ API 36) trở lên, ProfilingManager cho phép bạn tự động thu thập hồ sơ để phản hồi các điều kiện kích hoạt của hệ thống, chẳng hạn như lỗi Ứng dụng không phản hồi (ANR), sự cố Hết bộ nhớ (OutOfMemoryError) hoặc sự kiện khởi động ứng dụng. Vì bạn không thể dự đoán thời điểm nhiều sự kiện trong số này sẽ xảy ra trong thực tế, nên việc bắt đầu ghi theo cách thủ công trước là không thực tế. Với tính năng lập hồ sơ dựa trên điều kiện kích hoạt, hệ thống sẽ quản lý việc thu thập và cung cấp hồ sơ kết quả cho ứng dụng của bạn để bạn có thể:

  • Gỡ lỗi về độ ổn định: Chẩn đoán lỗi ANR không lường trước được và lỗi rò rỉ bộ nhớ.
  • Tối ưu hoá hành trình trọng yếu của người dùng (CUJ): Phân tích các luồng như khởi động ứng dụng (TRIGGER_TYPE_COLD_START và TRIGGER_TYPE_APP_FULLY_DRAWN).
  • Tìm hiểu hành vi của người dùng: Kiểm tra các sự kiện như người dùng thoát ứng dụng.

Để xem danh sách đầy đủ các điều kiện kích hoạt hiện có, hãy xem ProfilingTrigger.

Các loại điều kiện kích hoạt

Các điều kiện kích hoạt khác nhau về cách hệ thống thu thập hồ sơ khi sự kiện xảy ra.

Trình kích hoạt sử dụng dấu vết trong nền

Nhiều yếu tố kích hoạt (chẳng hạn như lỗi ANR) là hậu quả của một vấn đề trước đó. Nếu chỉ bắt đầu theo dõi sau khi hệ thống phát hiện lỗi ANR, thì bạn sẽ bỏ lỡ công việc chặn gây ra lỗi đó. Để ghi lại hoạt động dẫn đến sự kiện, các điều kiện kích hoạt sau đây sẽ lưu ảnh chụp nhanh của dấu vết nền đang hoạt động của hệ thống. Nếu không có dấu vết nền nào đang chạy khi sự kiện xảy ra, thì hệ thống sẽ không thu thập hồ sơ:

Trình kích hoạt bắt đầu một lần chụp mới

Các điều kiện kích hoạt sau đây không phụ thuộc vào dấu vết nền. Thay vào đó, hệ thống sẽ bắt đầu thu thập hồ sơ mới khi sự kiện xảy ra:

Điều kiện kích hoạt có hành vi chụp khác nhau tuỳ theo điểm bất thường

Đối với các điều kiện kích hoạt bất thường sau đây, loại hồ sơ được ghi lại (lưu ảnh chụp nhanh của dấu vết nền đang hoạt động hoặc bắt đầu một bản ghi mới) và hành vi giới hạn tốc độ phụ thuộc vào điểm bất thường cụ thể mà hệ thống phát hiện:

Thiết lập điều kiện kích hoạt

Đoạn mã sau đây minh hoạ cách đăng ký điều kiện kích hoạt TRIGGER_TYPE_APP_FULLY_DRAWN và đặt giai đoạn chờ xét duyệt lại cho điều kiện kích hoạt đó.

Kotlin

@RequiresApi(Build.VERSION_CODES.BAKLAVA)
fun recordWithTrigger() {
    val profilingManager =
        applicationContext.getSystemService(ProfilingManager::class.java) ?: return

    val triggers = ArrayList<ProfilingTrigger>()

    val triggerBuilder = ProfilingTrigger.Builder(ProfilingTrigger.TRIGGER_TYPE_APP_FULLY_DRAWN)
        .setRateLimitingPeriodHours(1)

    triggers.add(triggerBuilder.build())

    val callbackExecutor: Executor = Executors.newSingleThreadExecutor()

    val resultCallback = Consumer<ProfilingResult> { profilingResult ->
        if (profilingResult.errorCode == ProfilingResult.ERROR_NONE) {
            Log.d(
                "ProfileTest",
                "Received profiling result file=" + profilingResult.resultFilePath
            )
            setupProfileUploadWorker(profilingResult.resultFilePath)
        } else {
            Log.e(
                "ProfileTest",
                "Profiling failed errorcode=" + profilingResult.errorCode + " errormsg=" + profilingResult.errorMessage
            )
        }
    }

    profilingManager.registerForAllProfilingResults(callbackExecutor, resultCallback)
    profilingManager.addProfilingTriggers(triggers)

    Choreographer.getInstance().postFrameCallback { frameTimeNanos ->
        // This will cause the TRIGGER_TYPE_APP_FULLY_DRAWN to be emitted.
        reportFullyDrawn()
    }
}

Java

public void recordWithTrigger() {
  ProfilingManager profilingManager = getApplicationContext().getSystemService(
      ProfilingManager.class);
  List<ProfilingTrigger> triggers = new ArrayList<>();
  ProfilingTrigger.Builder triggerBuilder = new ProfilingTrigger.Builder(
      ProfilingTrigger.TRIGGER_TYPE_APP_FULLY_DRAWN);
  triggerBuilder.setRateLimitingPeriodHours(1);
  triggers.add(triggerBuilder.build());

  Executor callbackExecutor = Executors.newSingleThreadExecutor();
  Consumer<ProfilingResult> resultCallback =
      new Consumer<ProfilingResult>() {
        @Override
        public void accept(ProfilingResult profilingResult) {
          if (profilingResult.getErrorCode() == ProfilingResult.ERROR_NONE) {
            Log.d(
                "ProfileTest",
                "Received profiling result file=" + profilingResult.getResultFilePath());
            setupProfileUploadWorker(profilingResult.getResultFilePath());
          } else {
            Log.e(
                "ProfileTest",
                "Profiling failed errorcode="
                    + profilingResult.getErrorCode()
                    + " errormsg="
                    + profilingResult.getErrorMessage());
          }
        }
      };
  profilingManager.registerForAllProfilingResults(callbackExecutor, resultCallback);
  profilingManager.addProfilingTriggers(triggers);

  Choreographer.getInstance().postFrameCallback((f) -> {
    // This will cause the TRIGGER_TYPE_APP_FULLY_DRAWN to be emitted.
    reportFullyDrawn();
  });
}

Mã này thực hiện các bước sau:

  1. Lấy trình quản lý: Truy xuất dịch vụ ProfilingManager.
  2. Xác định điều kiện kích hoạt: Tạo ProfilingTrigger cho TRIGGER_TYPE_APP_FULLY_DRAWN. Sự kiện này xảy ra khi ứng dụng gọi reportFullyDrawn() trong quá trình khởi động nguội do hoạt động bắt đầu để báo cáo rằng ứng dụng đã khởi động xong và có thể tương tác.
  3. Đặt thời gian chờ của điều kiện kích hoạt: Áp dụng thời gian chờ 1 giờ cho điều kiện kích hoạt cụ thể này bằng cách sử dụng setRateLimitingPeriodHours ngoài bộ giới hạn tốc độ của hệ thống. Thời gian hồi chiêu này ngăn ứng dụng ghi lại nhiều hồ sơ khởi động mỗi giờ.
  4. Đăng ký trình nghe: Gọi registerForAllProfilingResults để xác định lệnh gọi lại xử lý kết quả. Lệnh gọi lại này nhận được đường dẫn của hồ sơ đã lưu thông qua getResultFilePath().
  5. Thêm điều kiện kích hoạt: Đăng ký danh sách điều kiện kích hoạt với ProfilingManager bằng addProfilingTriggers.
  6. Sự kiện kích hoạt: Đăng lệnh gọi lại khung Choreographer để gọi reportFullyDrawn() sau khi khung tiếp theo được vẽ, từ đó phát sự kiện TRIGGER_TYPE_APP_FULLY_DRAWN đến hệ thống, kích hoạt quá trình thu thập hồ sơ giả định rằng dấu vết nền hệ thống đang chạy và hạn mức của bộ giới hạn tốc độ vẫn còn. Để điều kiện kích hoạt này xảy ra, hãy đảm bảo ứng dụng của bạn gọi reportFullyDrawn().

Vòng đời của điều kiện kích hoạt

Trình kích hoạt đã đăng ký sẽ được duy trì trong các lần khởi động lại ứng dụng và khởi động lại hệ thống. Bạn không cần đăng ký lại điều kiện kích hoạt mỗi khi ứng dụng khởi động hoặc sau khi hệ thống khởi động lại. Sau khi bạn đăng ký điều kiện kích hoạt bằng addProfilingTriggers, hệ thống sẽ tự động duy trì các điều kiện kích hoạt đó cho ứng dụng của bạn cho đến khi bạn xoá chúng hoặc ứng dụng bị gỡ cài đặt.

Trường hợp nên huỷ đăng ký điều kiện kích hoạt

Vì các trình kích hoạt đã đăng ký vẫn tồn tại trong các lần khởi động lại ứng dụng và khởi động lại hệ thống, nên việc bỏ qua addProfilingTriggers trong các lần khởi chạy tiếp theo sẽ không dừng các trình kích hoạt đã đăng ký trong phiên trước đó. Để dừng thu thập hồ sơ cho các sự kiện cụ thể hoặc cho tất cả sự kiện, hãy gọi rõ ràng removeProfilingTriggersByType hoặc clearProfilingTriggers.

Hủy đăng ký điều kiện kích hoạt trong các trường hợp sau:

  • Nhắm mục tiêu theo nhóm thuần tập hoặc khôi phục cờ từ xa: Bạn có thể phân đoạn hồ sơ trên các nhóm thuần tập bằng cách sử dụng cấu hình từ xa hoặc cờ thử nghiệm A/B. Bất cứ khi nào một thiết bị rời khỏi nhóm thuần tập được lấy mẫu hoặc một cờ tắt, hãy huỷ đăng ký các điều kiện kích hoạt.
  • Kết thúc chiến dịch gỡ lỗi: Sau khi bạn thu thập đủ hồ sơ để chẩn đoán vấn đề hoặc gửi bản sửa lỗi, hãy xoá điều kiện kích hoạt. Việc huỷ đăng ký các điều kiện kích hoạt không cần thiết sẽ giúp duy trì bộ nhớ trên thiết bị và hạn mức của bộ giới hạn tốc độ của ứng dụng cho các yêu cầu lập hồ sơ khác.

Vòng đời của lệnh gọi lại

Không giống như các yêu cầu lập hồ sơ trực tiếp, hồ sơ dựa trên điều kiện kích hoạt chỉ cung cấp kết quả cho trình nghe chung đã đăng ký với registerForAllProfilingResults. Trong lệnh gọi lại, hãy gọi ProfilingResult.getTriggerType để xác định điều kiện kích hoạt nào đã bắt đầu quá trình thu thập và gọi ProfilingResult.getResultFilePath để tìm tệp hồ sơ đã lưu. Để biết thông tin chi tiết về tên tệp hồ sơ kích hoạt, lấy tệp bằng adb và tải kết quả lên trong nền, hãy xem phần Truy xuất và tải hồ sơ lên.

Mặc dù điều kiện kích hoạt vẫn tồn tại trong các lần khởi động lại ứng dụng và khởi động lại hệ thống, nhưng lệnh gọi lại kết quả thì không. Đăng ký lệnh gọi lại trên Executor nền sau khi quá trình khởi động ứng dụng hoàn tất (để không làm chậm quá trình khởi động nguội) để nhận hồ sơ trong cả hai trường hợp sau:

  • Trong khi ứng dụng đang chạy: Đối với các điều kiện kích hoạt không dừng hoặc không làm ứng dụng gặp sự cố, hệ thống sẽ gọi lệnh gọi lại trên Executor được cung cấp khi điều kiện kích hoạt xảy ra và hồ sơ được lưu.
  • Sau khi chấm dứt ứng dụng: Đối với các điều kiện kích hoạt thường liên quan hoặc xảy ra trước khi chấm dứt ứng dụng (chẳng hạn như TRIGGER_TYPE_ANR, TRIGGER_TYPE_OOM hoặc TRIGGER_TYPE_KILL_RECENTS) hoặc nếu ứng dụng của bạn dừng trước khi quá trình thu thập hoàn tất, hệ thống sẽ lưu hồ sơ trong nền và đưa kết quả vào hàng đợi trong các lần khởi động lại ứng dụng và khởi động lại hệ thống. Hệ thống sẽ giữ lại các kết quả chưa được phân phối trong hàng đợi trong tối đa 7 ngày và phân phối các kết quả đó vào lần tiếp theo ứng dụng của bạn chạy và gọi registerForAllProfilingResults.

Cách hoạt động của tính năng theo dõi trong nền

Để cân bằng mức hao tổn của hoạt động phân tích tài nguyên với việc thu thập các cấu phần phần mềm hữu ích, hệ thống không chạy dấu vết nền liên tục. Thay vào đó, công cụ này lấy mẫu định kỳ bằng cách bắt đầu theo dõi trong nền theo các khoảng thời gian ngẫu nhiên.

Dữ liệu theo dõi trong nền do hệ thống kích hoạt sử dụng bộ đệm vòng có kích thước tối đa do hệ thống xác định. Khi bộ đệm đầy, dữ liệu theo dõi mới sẽ ghi đè lên dữ liệu cũ nhất. Như minh hoạ trong Hình 1, khi một điều kiện kích hoạt đã đăng ký kích hoạt trong khi dấu vết nền đang hoạt động và hạn mức của bộ giới hạn tốc độ vẫn còn, hệ thống sẽ lưu ảnh chụp nhanh vùng đệm vòng chứa hoạt động gần đây nhất dẫn đến điều kiện kích hoạt.

Sơ đồ cho thấy cách hoạt động của ảnh chụp nhanh dấu vết trong nền, với vùng đệm vòng thu thập dữ liệu trước một sự kiện kích hoạt.
Hình 1. Cách hoạt động của ảnh chụp nhanh dấu vết trong nền.

Đặt thời gian đợi cụ thể cho điều kiện kích hoạt

Trình kích hoạt tần suất cao có thể nhanh chóng tiêu thụ hạn mức của bộ giới hạn tốc độ của ứng dụng. Để ngăn một loại điều kiện kích hoạt duy nhất làm cạn kiệt hạn mức, hãy sử dụng setRateLimitingPeriodHours để thêm khoảng thời gian đợi tối thiểu cho mỗi điều kiện kích hoạt ngoài bộ giới hạn tốc độ của hệ thống.

Gỡ lỗi trình kích hoạt trên máy

Vì dấu vết nền chạy theo khoảng thời gian ngẫu nhiên trong môi trường thực tế, nên việc kiểm thử trình kích hoạt cục bộ đòi hỏi phải buộc dấu vết nền liên tục và bỏ qua bộ giới hạn tốc độ ở cấp hệ thống cho gói của bạn (mọi thời gian đợi cho mỗi trình kích hoạt được đặt bằng setRateLimitingPeriodHours vẫn áp dụng và rate_limiter.disabled chỉ áp dụng cho các lệnh gọi requestProfiling do ứng dụng điều khiển).

Để biết các lệnh adb buộc theo dõi trong nền, mô phỏng điều kiện kích hoạt từ dòng lệnh và kiểm tra trạng thái dịch vụ, hãy xem phần Buộc bật tính năng theo dõi trong nền để kiểm thử điều kiện kích hoạt trong bài viết Lệnh gỡ lỗi để lập hồ sơ cục bộ.