ট্রিগার-ভিত্তিক প্রোফাইলিং

Android 16 (API লেভেল 36) এবং তার পরবর্তী ভার্সনে, ProfilingManager আপনাকে সিস্টেম ট্রিগারের উত্তরে অটোমেটিক প্রোফাইল ক্যাপচার করতে দেয়, যেমন অ্যাপ্লিকেশন সাড়া দিচ্ছে না (ANR) সংক্রান্ত সমস্যা, মেমরি শেষ হয়ে যাওয়ার (OutOfMemoryError) কারণে ক্র্যাশ হওয়া বা অ্যাপ স্টার্টআপ ইভেন্ট। কারণ, ফিল্ডে এইসব ইভেন্টের মধ্যে অনেকগুলি কখন ঘটবে তা আপনি আগে থেকে অনুমান করতে পারবেন না, তাই আগে থেকে ম্যানুয়ালি রেকর্ডিং শুরু করা অবাস্তব। ট্রিগার-ভিত্তিক প্রোফাইলিংয়ের মাধ্যমে, সিস্টেম ক্যাপচার ম্যানেজ করে এবং আপনার অ্যাপে ফলাফল প্রোফাইল ডেলিভার করে যাতে আপনি এগুলি করতে পারেন:

  • স্টেবিলিটি সংক্রান্ত সমস্যার ডিবাগ করা: অপ্রত্যাশিত ANR এবং মেমরি লিক ডায়াগনসিস করা।
  • ক্রিটিক্যাল ইউজার জার্নি (CUJ) অপ্টিমাইজ করা: অ্যাপ স্টার্টআপের (TRIGGER_TYPE_COLD_START এবং TRIGGER_TYPE_APP_FULLY_DRAWN) মতো ফ্লো বিশ্লেষণ করা।
  • ব্যবহারকারীর আচরণ বোঝা: ব্যবহারকারীর শুরু করা অ্যাপ থেকে বেরিয়ে আসার মতো ইভেন্ট পরীক্ষা করুন।

উপলভ্য ট্রিগারের সম্পূর্ণ তালিকা দেখতে, ProfilingTrigger দেখুন।

ট্রিগারের ধরন

ইভেন্ট ঘটার সময় সিস্টেম কীভাবে প্রোফাইল ক্যাপচার করে তার উপর ভিত্তি করে ট্রিগার আলাদা হয়।

ব্যাকগ্রাউন্ড ট্রেস ব্যবহার করে এমন ট্রিগার

অনেক ট্রিগার—যেমন ANR—আগের কোনও সমস্যার ফলাফল। সিস্টেম ANR শনাক্ত করার পরেই ট্রেস শুরু করলে, যে ব্লকিং কাজের জন্য এটি হয়েছে তা মিস হয়ে যায়। ইভেন্ট পর্যন্ত অ্যাক্টিভিটি ক্যাপচার করতে, নিম্নলিখিত ট্রিগার সিস্টেমের অ্যাক্টিভ ব্যাকগ্রাউন্ড ট্রেসের একটি স্ন্যাপশট সেভ করে। ইভেন্ট ঘটার সময় কোনও ব্যাকগ্রাউন্ড ট্রেস না চললে, কোনও প্রোফাইল সংগ্রহ করা হয় না:

ট্রিগার যা নতুন ক্যাপচার শুরু করে

নিম্নলিখিত ট্রিগার ব্যাকগ্রাউন্ড ট্রেসের উপর নির্ভর করে না। পরিবর্তে, ইভেন্টটি ঘটলে সিস্টেম একটি নতুন প্রোফাইল ক্যাপচার শুরু করে:

ট্রিগার যেখানে ক্যাপচার আচরণ অসঙ্গতি অনুসারে পরিবর্তিত হয়

নিম্নলিখিত অ্যানোমালি ট্রিগারের জন্য, ক্যাপচার করা প্রোফাইলের ধরন (অ্যাক্টিভ ব্যাকগ্রাউন্ড ট্রেসের স্ন্যাপশট সেভ করা বা নতুন ক্যাপচার শুরু করা) এবং রেট সীমিত করার আচরণ সিস্টেমের মাধ্যমে শনাক্ত করা নির্দিষ্ট অ্যানোম্যালির উপর নির্ভর করে:

ট্রিগার সেট-আপ করা

নিম্নলিখিত কোড থেকে জানা যায় যে কীভাবে TRIGGER_TYPE_APP_FULLY_DRAWN ট্রিগারের জন্য রেজিস্টার করতে হয় এবং সেটির উপর কুলডাউন পিরিয়ড সেট করতে হয়।

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()
    }
}

জাভা

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();
  });
}

কোডটি এইসব ধাপ অনুসরণ করে:

  1. ম্যানেজার পান: ProfilingManager পরিষেবা ফিরিয়ে আনে।
  2. ট্রিগার নির্দিষ্ট করুন: TRIGGER_TYPE_APP_FULLY_DRAWN-এর জন্য ProfilingTrigger তৈরি করে। এই ইভেন্টটি ঘটে যখন অ্যাপটি অ্যাক্টিভিটি-ইনিশিয়েটেড কোল্ড স্টার্টের সময় reportFullyDrawn() কল করে রিপোর্ট করে যে এটি স্টার্টআপ শেষ করেছে এবং ইন্টারঅ্যাক্টিভ।
  3. ট্রিগার কুলডাউন সেট করুন: সিস্টেম রেট লিমিট ছাড়াও setRateLimitingPeriodHours ব্যবহার করে এই নির্দিষ্ট ট্রিগারে ১ ঘণ্টার কুলডাউন পিরিয়ড প্রয়োগ করে। এই কুলডাউন অ্যাপটিকে প্রতি ঘন্টায় একাধিক স্টার্টআপ প্রোফাইল রেকর্ড করতে বাধা দেয়।
  4. লিসনার রেজিস্টার করুন: ফলাফল ম্যানেজ করে এমন কলব্যাক সংজ্ঞায়িত করতে registerForAllProfilingResults কল করে। এই কলব্যাক getResultFilePath()-এর মাধ্যমে সেভ করা প্রোফাইলের পাথ রিসিভ করে।
  5. ট্রিগার যোগ করুন: addProfilingTriggers ব্যবহার করে ProfilingManager-এর সাথে ট্রিগার তালিকা রেজিস্টার করে।
  6. ফায়ার ইভেন্ট: একটি Choreographer ফ্রেম কলব্যাক পোস্ট করে যা পরবর্তী ফ্রেম আঁকা হলে reportFullyDrawn()-কে কল করে, যা সিস্টেমে TRIGGER_TYPE_APP_FULLY_DRAWN ইভেন্ট এমিট করে, সিস্টেম ব্যাকগ্রাউন্ড ট্রেস চলছে এবং রেট লিমিট কোটা উপলভ্য আছে ধরে নিয়ে প্রোফাইল কালেকশন ট্রিগার করে। এই ট্রিগার যাতে কাজ করে, তার জন্য আপনার অ্যাপ যেন reportFullyDrawn() কল করে তা নিশ্চিত করুন।

ট্রিগার লাইফসাইকেল

অ্যাপ রিস্টার্ট ও সিস্টেম রিবুট করার পরেও রেজিস্টার করা ট্রিগার থেকে যায়। আপনার অ্যাপ চালু হওয়ার সময় বা সিস্টেম রিবুট হওয়ার পরে আপনাকে প্রতিবার ট্রিগার আবার রেজিস্টার করতে হবে না—আপনি একবার addProfilingTriggers ব্যবহার করে ট্রিগার রেজিস্টার করলে, আপনি সেগুলি সরিয়ে না দেওয়া বা অ্যাপ আনইনস্টল না করা পর্যন্ত সিস্টেম আপনার অ্যাপের জন্য সেগুলি অটোমেটিক বজায় রাখে।

ট্রিগার কখন আনরেজিস্টার করতে হবে

যেহেতু রেজিস্টার করা ট্রিগার অ্যাপ রিস্টার্ট এবং সিস্টেম রিবুট জুড়ে থাকে, তাই পরবর্তী লঞ্চে addProfilingTriggers এড়িয়ে গেলে আগের সেশনে রেজিস্টার করা ট্রিগার বন্ধ হয় না। নির্দিষ্ট ইভেন্ট বা সব ইভেন্টের জন্য প্রোফাইল ক্যাপচার করা বন্ধ করতে, স্পষ্টভাবে removeProfilingTriggersByType বা clearProfilingTriggers কল করুন।

নিম্নলিখিত পরিস্থিতিতে ট্রিগার আনরেজিস্টার করুন:

  • টার্গেট করা কোহর্ট বা রিমোট ফ্ল্যাগ রোল ব্যাক করা: আপনি রিমোট কনফিগারেশন বা A/B টেস্টিং ফ্ল্যাগ ব্যবহার করে কোহর্ট জুড়ে সেগমেন্ট প্রোফাইলিং করতে পারেন। যখনই কোনও ডিভাইস স্যাম্পেল করা কোহর্ট থেকে বেরিয়ে যায় বা কোনও ফ্ল্যাগ বন্ধ হয়ে যায়, ট্রিগার আনরেজিস্টার করুন।
  • ডিবাগিং ক্যাম্পেন শেষ করা: কোনও সমস্যা ডায়াগনসিস করতে বা সমাধান করতে পর্যাপ্ত প্রোফাইল সংগ্রহ করার পরে, ট্রিগার সরিয়ে দিন। অপ্রয়োজনীয় ট্রিগার আনরেজিস্টার করলে ডিভাইস স্টোরেজ এবং অন্যান্য প্রোফাইলিং অনুরোধের জন্য আপনার অ্যাপের রেট লিমিটার কোটা সুরক্ষিত থাকে।

কলব্যাক লাইফসাইকেল

সরাসরি প্রোফাইলিং অনুরোধের মতো নয়, ট্রিগার-ভিত্তিক প্রোফাইল শুধুমাত্র registerForAllProfilingResults-এর সাথে রেজিস্টার করা গ্লোবাল লিসেনারকে ফলাফল প্রদান করে। আপনার কলব্যাকে, কোন ট্রিগার ক্যাপচার শুরু করেছে তা শনাক্ত করতে ProfilingResult.getTriggerType কল করুন এবং সেভ করা প্রোফাইল ফাইলটি খুঁজে পেতে ProfilingResult.getResultFilePath কল করুন। ট্রিগার প্রোফাইল ফাইলের নাম, adb-এর মাধ্যমে ফাইল পুল করা এবং ব্যাকগ্রাউন্ডে ফলাফল আপলোড করার বিষয়ে বিস্তারিত জানতে, প্রোফাইল ফিরিয়ে আনা এবং আপলোড করা দেখুন।

অ্যাপ রিস্টার্ট এবং সিস্টেম রিবুট করার পরেও ট্রিগার থেকে গেলেও, আপনার ফলাফল কলব্যাক থেকে যায় না। অ্যাপ স্টার্টআপ সম্পূর্ণ হওয়ার পরে ব্যাকগ্রাউন্ড Executor-এ আপনার কলব্যাক রেজিস্টার করুন (যাতে কোল্ড স্টার্ট স্লো না হয়ে যায়) যাতে নিম্নলিখিত দুটি পরিস্থিতিতেই প্রোফাইল পাওয়া যায়:

  • আপনার অ্যাপ চলাকালীন: যেসব ট্রিগার আপনার অ্যাপ বন্ধ বা ক্র্যাশ করে না, সেগুলির জন্য ট্রিগার ঘটলে এবং প্রোফাইল সেভ করা হলে, সিস্টেম প্রদত্ত Executor-এ আপনার কলব্যাক ইনভোক করে।
  • অ্যাপ বন্ধ হয়ে যাওয়ার পরে: যেসব ট্রিগার প্রায়শই অ্যাপ বন্ধ হয়ে যাওয়ার সাথে সম্পর্কিত বা তার আগে ঘটে (যেমন TRIGGER_TYPE_ANR, TRIGGER_TYPE_OOM, বা TRIGGER_TYPE_KILL_RECENTS), অথবা ক্যাপচার শেষ হওয়ার আগে আপনার অ্যাপ বন্ধ হয়ে গেলে, সিস্টেম ব্যাকগ্রাউন্ডে প্রোফাইল সেভ করে এবং অ্যাপ রিস্টার্ট ও সিস্টেম রিবুট হওয়া জুড়ে ফলাফল সারিবদ্ধ করে। সিস্টেম ডেলিভার না করা সারিবদ্ধ ফলাফল ৭ দিন পর্যন্ত রেখে দেয় এবং পরের বার আপনার অ্যাপ রান করলে এবং registerForAllProfilingResults কল করলে সেগুলি ডেলিভার করে।

ব্যাকগ্রাউন্ড ট্রেসিং কীভাবে কাজ করে

প্রয়োজনীয় আর্টিফ্যাক্ট ক্যাপচার করার সাথে প্রোফাইলিং ওভারহেডের ভারসাম্য বজায় রাখতে, সিস্টেম ব্যাকগ্রাউন্ড ট্রেস একটানা রান করে না। পরিবর্তে, এটি র‍্যান্ডম বিরতিতে ব্যাকগ্রাউন্ড ট্রেস শুরু করে পর্যায়ক্রমে স্যাম্পেল করে।

সিস্টেম-ট্রিগার করা ব্যাকগ্রাউন্ড ট্রেস, সিস্টেম-নির্ধারিত সর্বাধিক সাইজ সহ রিং বাফার ব্যবহার করে। বাফার ভর্তি হয়ে গেলে, নতুন ট্রেস ডেটা সবচেয়ে পুরনো ডেটার উপর ওভাররাইট করে। ছবি ১-এ যেমন দেখানো হয়েছে, ব্যাকগ্রাউন্ড ট্রেস অ্যাক্টিভ থাকাকালীন এবং রেট-লিমিটার কোটা উপলভ্য থাকাকালীন কোনও রেজিস্টার করা ট্রিগার ফায়ার হলে, সিস্টেম রিং বাফার স্ন্যাপশট সেভ করে, যাতে ট্রিগার পর্যন্ত সবচেয়ে সাম্প্রতিক অ্যাক্টিভিটি থাকে।

ব্যাকগ্রাউন্ড ট্রেস স্ন্যাপশট কীভাবে কাজ করে তা ডায়াগ্রামের মাধ্যমে দেখানো হচ্ছে, যেখানে ট্রিগার ইভেন্টের আগে রিং বাফার ডেটা ক্যাপচার করছে।
ছবি ১. ব্যাকগ্রাউন্ড ট্রেস স্ন্যাপশট কীভাবে কাজ করে।

ট্রিগার-নির্দিষ্ট কুলডাউন সেট করুন

হাই-ফ্রিকোয়েন্সি ট্রিগার আপনার অ্যাপের রেট লিমিট কোটা দ্রুত ব্যবহার করে ফেলতে পারে। একটি ট্রিগার টাইপ যাতে আপনার কোটা শেষ না করে দেয়, তার জন্য setRateLimitingPeriodHours ব্যবহার করে সিস্টেম রেট লিমিটারের উপরে প্রতি ট্রিগার ন্যূনতম কুলডাউন পিরিয়ড যোগ করুন।

ডিবাগ স্থানীয়ভাবে ট্রিগার করে

যেহেতু প্রোডাকশনে ব্যাকগ্রাউন্ড ট্রেস র‍্যান্ডম বিরতিতে রান করে, তাই লোকালি ট্রিগার পরীক্ষা করার জন্য একটি অবিচ্ছিন্ন ব্যাকগ্রাউন্ড ট্রেস জোর করে এবং আপনার প্যাকেজের জন্য সিস্টেম-লেভেল রেট লিমিটার বাইপাস করতে হয় (setRateLimitingPeriodHours-এর সাথে সেট করা যেকোনও প্রতি-ট্রিগার কুলডাউন এখনও প্রযোজ্য এবং rate_limiter.disabled শুধুমাত্র অ্যাপ-চালিত requestProfiling কলের ক্ষেত্রে প্রযোজ্য)।

ব্যাকগ্রাউন্ড ট্রেস জোর করে চালু করার adb কমান্ড, কমান্ড লাইন থেকে ট্রিগার সিমুলেট করা এবং পরিষেবার অবস্থা পরীক্ষা করার জন্য, লোকাল প্রোফাইলিংয়ের জন্য ডিবাগ কমান্ড-এ ট্রিগার পরীক্ষার জন্য ব্যাকগ্রাউন্ড ট্রেস জোর করে চালু করুন দেখুন।