perfetto

perfetto হল এমন একটি টুল যা আপনাকে Android ডিবাগ ব্রিজ (ADB)-এর মাধ্যমে Android ডিভাইস থেকে পারফর্ম্যান্স সংক্রান্ত তথ্য সংগ্রহ করতে দেয়। adb shell perfetto ... কমান্ড ব্যবহার করে perfetto টুল চালু করুন। perfetto আপনার ডিভাইস থেকে পারফর্ম্যান্স ট্রেস সংগ্রহ করতে বিভিন্ন সোর্স ব্যবহার করে, যেমন:

  • কার্নেল থেকে তথ্য পেতে ftrace
  • পরিষেবা ও অ্যাপে ইউজার-স্পেস অ্যানোটেশনের জন্য atrace
  • পরিষেবা ও অ্যাপের নেটিভ মেমরি ব্যবহার সংক্রান্ত তথ্যের জন্য heapprofd

এই পৃষ্ঠায় perfetto কল করা এবং কাঙ্ক্ষিত আউটপুট জেনারেট করার জন্য এটি কনফিগার করার পদ্ধতি বর্ণনা করা হয়েছে। আরও তথ্যের জন্য, perfetto ডকুমেন্টেশন দেখুন।

সিনট্যাক্স

এই বিভাগে, বিভিন্ন মোডের জন্য perfetto কল করতে এবং ট্রেস জেনারেট করতে কীভাবে ADB ব্যবহার করবেন তা বর্ণনা করা হয়েছে।

ডেটা সোর্স বেছে নেওয়া

perfetto-এ নিম্নলিখিত দুটি মোড অন্তর্ভুক্ত থাকে যা ডেটা সোর্স নির্ধারণ করে এটি আপনার ট্রেস রেকর্ড করতে ব্যবহার করে:

  • লাইট মোড: ডেটা সোর্সের শুধু একটি সাবসেট বেছে নিতে পারবেন, বিশেষ করে atrace এবং ftrace। তবে, এই মোড systrace-এর মতো ইন্টারফেস অফার করে।
  • নরমাল মোড: প্রোটোকল বাফারে এর কনফিগারেশন পায় এবং atrace ও ftrace থেকে আলাদা ডেটা সোর্স ব্যবহার করে আপনাকে perfetto-এর আরও কার্যকারিতা ব্যবহার করতে দেয়।

সাধারণ বিকল্প

perfetto-এর যেকোনও মোড ব্যবহার করার সময় উপলভ্য বিকল্পগুলি নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে:

টেবিল ১. উপলভ্য সাধারণ perfetto টুল বিকল্পের তালিকা।

Option বর্ণনা
--background |
-d
perfetto সঙ্গে সঙ্গে কমান্ড-লাইন ইন্টারফেস থেকে বেরিয়ে আসে এবং ব্যাকগ্রাউন্ডে আপনার ট্রেস রেকর্ড করা চালিয়ে যায়।
--background-wait | -D --background-এর মতো, তবে বন্ধ হওয়ার আগে সব ডেটা সোর্স শুরু হওয়ার জন্য অপেক্ষা করে (৩০ সেকেন্ড পর্যন্ত)। সফলভাবে স্বীকৃতি পাওয়া গেলে এক্সিট কোড শূন্য হয় এবং অন্যথায় (সমস্যা বা টাইমআউট) শূন্য ছাড়া অন্য কিছু হয়।
--alert-id এই ট্রেস ট্রিগার করা সতর্কতার আইডি।
--config-id ট্রিগার করা কনফিগারেশনের আইডি।
--config-uid কনফিগারেশন রেজিস্টার করা অ্যাপের UID।
--subscription-id এই ট্রেস ট্রিগার করেছে এমন সাবস্ক্রিপশনের আইডি।
--out OUT_FILE |
-o OUT_FILE

আউটপুট ট্রেস ফাইলের জন্য পছন্দসই পাথ বা stdout-এর জন্য - নির্দিষ্ট করে। perfetto আগের ফ্ল্যাগে বর্ণনা করা ফাইলে আউটপুট লেখে। আউটপুট ফর্ম্যাটটি AOSP trace.proto-এ সংজ্ঞায়িত ফর্ম্যাটের সাথে কম্পাইল করে।

মনে রাখবেন: আপনাকে অবশ্যই আউটপুট ফাইলের সম্পূর্ণ পাথনেম উল্লেখ করতে হবে। সাধারণত ফাইলগুলি /data/misc/perfetto-traces ফোল্ডারে রাইট করা উচিত।

--upload সম্পূর্ণ হওয়ার পরে, প্রোটো ট্রেস কনফিগারেশনে IncidentReportConfig মেসেজ দ্বারা নির্দিষ্ট করা প্যাকেজে ট্রেস পাস করে।
--no-guardrails টেস্টিংয়ের সময় --upload ফ্ল্যাগ চালু করার সময় অত্যধিক রিসোর্স ব্যবহার সংক্রান্ত সুরক্ষা বন্ধ করে দেয়।
--reset-guardrails গার্ডরেলের থেকে যাওয়া স্ট্যাটাস রিসেট করে এবং পরীক্ষার জন্য বেরিয়ে আসে।
--rsave-for-bugreport bugreport_score > 0 সহ ট্রেস চলছে, ট্রেসটি একটি ফাইলে সেভ করে। হয়ে গেলে পাথ আউটপুট করে।
--query পরিষেবার স্ট্যাটাস কোয়েরি করে এবং মানুষের-পঠনযোগ্য টেক্সট হিসেবে এটি প্রিন্ট করে।
--query-raw --query-এর মতো, তবে tracing_service_state.proto.-এর র' প্রোটো-এনকোডেড বাইট প্রিন্ট করে
--help | -h perfetto টুলের জন্য সহায়ক টেক্সট প্রিন্ট করে।

লাইট মোড

লাইট মোডে perfetto ব্যবহার করার সাধারণ সিনট্যাক্স নিচে দেওয়া হল:

 adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
             [ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
             --out FILE

লাইট মোডে perfetto ব্যবহার করার সময় উপলভ্য বিকল্পগুলি নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে:

সারণী ২. লাইট মোড ব্যবহার করার সময় উপলভ্য perfetto টুল বিকল্পের তালিকা।

Option বর্ণনা
--time TIME[s|m|h] |
-t TIME[s|m|h]
সেকেন্ড, মিনিট বা ঘণ্টায় ট্রেসের সময়সীমা নির্দিষ্ট করে। যেমন, --time 1m ১ মিনিটের ট্রেস সময়সীমা নির্দিষ্ট করে। ডিফল্ট সময়সীমা হল ১০ সেকেন্ড।
--buffer SIZE[mb|gb] |
-b SIZE[mb|gb]
মেগাবাইট (এমবি) বা গিগাবাইটে (জিবি) রিং বাফার সাইজ নির্দিষ্ট করে। ডিফল্ট প্যারামিটার হল --buffer 32mb।
--size SIZE[mb|gb] |
-s SIZE[mb|gb]
মেগাবাইট (এমবি) বা গিগাবাইটে (জিবি) ফাইলের সর্বাধিক সাইজ উল্লেখ করে। সাধারণত, perfetto শুধুমাত্র ইন-মেমরি রিং-বাফার ব্যবহার করে।
--app | -a Android (atrace) অ্যাপের নাম

এইসব বিকল্পের পরে ইভেন্ট স্পেসিফায়ারের একটি তালিকা থাকে:

সারণী ৩. লাইট মোডের জন্য ইভেন্ট স্পেসিফায়ারের তালিকা।

ইভেন্ট বর্ণনা
ATRACE_CAT আপনি যে atrace বিভাগের জন্য ট্রেস রেকর্ড করতে চান তা নির্দিষ্ট করে। যেমন, নিম্নলিখিত কমান্ড atrace ব্যবহার করে Window Manager ট্রেস করে:
    adb shell perfetto --out FILE wm
    

অন্যান্য বিভাগ রেকর্ড করতে, এই atraceটি বিভাগের তালিকা দেখুন।

FTRACE_GROUP/FTRACE_NAME আপনি যে ftrace ইভেন্টের জন্য ট্রেস রেকর্ড করতে চান তা নির্দিষ্ট করে। যেমন, নিম্নলিখিত কমান্ড sched/sched_switch ইভেন্ট ট্রেস করে:
      adb shell perfetto --out FILE sched/sched_switch
      

সাধারণ মোড

সাধারণ মোডে perfetto ব্যবহার করার জন্য সাধারণ সিনট্যাক্স নিচে দেওয়া হল:

 adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE

সাধারণ মোডে perfetto ব্যবহার করার সময় উপলভ্য বিকল্পগুলি নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে:

সারণী ৪. সাধারণ মোড ব্যবহার করার সময় উপলভ্য perfetto টুল বিকল্পের তালিকা।

Option বর্ণনা
--config CONFIG_FILE | -c CONFIG_FILE কনফিগারেশন ফাইলের পাথ নির্দিষ্ট করে। সাধারণ মোডে, কিছু কনফিগারেশন, কনফিগারেশন প্রোটোকল বাফারে এনকোড করা হতে পারে। এই ফাইলটি অবশ্যই AOSP trace_config.proto-এ সংজ্ঞায়িত প্রোটোকল বাফার স্কিমা মেনে চলতে হবে।

TraceConfig-এর DataSourceConfig মেম্বার ব্যবহার করে ডেটা সোর্স বেছে নিন ও কনফিগার করুন, যেমনটি AOSP data_source_config.proto-এ বলা আছে।

--txt perfetto-কে pbtxt হিসেবে কনফিগারেশন ফাইল পার্স করার নির্দেশ দেয়। এই ফ্ল্যাগটি শুধুমাত্র লোকাল টেস্টিংয়ের জন্য তৈরি করা হয়েছে এবং প্রোডাকশনের জন্য এটি চালু করার সুপারিশ করা হয় না।

কাজ করে এমন ডেটা সোর্স

এই বিভাগে বিভিন্ন সোর্স সম্পর্কে বর্ণনা করা হয়েছে যেগুলি perfetto আপনার ট্রেস জেনারেট করতে ব্যবহার করে।

ftrace

ftrace ডেটা সোর্স perfetto-কে কার্নেল থেকে ইভেন্ট পেতে দেয়।

DataSourceConfig-এ ftrace_config সেট করে এই সোর্স চালু করুন।

যেসব ইভেন্ট চালু করা যেতে পারে তার মধ্যে এগুলি অন্তর্ভুক্ত:

আপনার ডিভাইস, OS ভার্সন বা কার্নেলের উপর নির্ভর করে, আরও ইভেন্ট উপলভ্য হতে পারে। আরও তথ্যের জন্য, config protos দেখুন।

প্রসেস সম্পর্কিত পরিসংখ্যান

প্রসেস স্ট্যাটাস ডেটা সোর্স আপনাকে সিস্টেম এবং স্বতন্ত্র প্রসেস সম্পর্কে পোল করা কাউন্টার পেতে দেয়।

DataSourceConfig-এ process_stats_config এবং sys_stats_config সেট করে এই সোর্স চালু করুন।

perfetto যে ডেটা জেনারেট করে তার মধ্যে এগুলি অন্তর্ভুক্ত:

আপনার ডিভাইস, OS ভার্সন ও কার্নেলের উপর নির্ভর করে, আরও ইভেন্ট উপলভ্য হতে পারে। আরও জানতে, sys_stats এবং process_stats-এর জন্য কনফিগারেশন প্রোটো দেখুন।

heapprofd

heapprofd আপনাকে নেটিভ মেমরি ব্যবহারের কারণের স্যাম্পেল দেয়।

DataSourceConfig-এ heapprofd_config সেট করে এই সোর্স চালু করুন। এই সেটিং ProfilePackets তৈরি করে, যার মধ্যে কলস্ট্যাকের জাভা ফ্রেম অন্তর্ভুক্ত।

heapprofd কীভাবে ব্যবহার করবেন সেই সম্পর্কে অতিরিক্ত তথ্য perfetto.dev-এ পাওয়া যাবে।

অন্যান্য সোর্স

আপনার ডিভাইস, OS ভার্সন ও কার্নেলের উপর নির্ভর করে, আরও ডেটা সোর্স উপলভ্য হতে পারে। আরও জানতে, ডেটা সোর্স কনফিগারেশন প্রোটো দেখুন।

perfetto সম্পর্কে অতিরিক্ত তথ্য perfetto.dev-এ পাওয়া যাবে।