ট্রেস অনুসন্ধান

Winscope Perfetto ট্রেসে নির্দিষ্ট স্টেট খুঁজে পেতে SQL ব্যবহার করুন। Winscope UI-এর গ্লোবাল সার্চ ভিউয়ার আপনাকে কোয়েরি চালাতে এবং সারণীবদ্ধ ফলাফল দেখতে দেয়:

চিত্র ১. অনুসন্ধান প্রদর্শক ট্যাব।

সার্চ ভিউয়ার আপনাকে পারফেটটো ট্রেসের উপর কাস্টম SQL কোয়েরি লিখতে ও চালাতে দেয়। আপনি সাম্প্রতিক এবং সংরক্ষিত কোয়েরিগুলোও অ্যাক্সেস করতে পারেন। উইনস্কোপ সারফেসফ্লিঙ্গার, ট্রানজ্যাকশন, ট্রানজিশন এবং ভিউক্যাপচার ট্রেস অনুসন্ধানে সাহায্য করার জন্য বিশেষায়িত SQL ভিউ প্রদান করে।

সকল ভিউয়ের জন্য নিম্নলিখিত নিয়মগুলো ব্যবহার করুন:

• property এবং flat_property কলামগুলির জন্য:

  • প্রপার্টির নামগুলো স্নেক কেসে (snake case) লেখা হয়, যেমন LayerProto এর visible_region ।

  • ডট নোটেশন নেস্টেড প্রোপার্টিগুলোকে বোঝায়, যেমন, visible_region.rect ।

  • property পুনরাবৃত্ত ফিল্ডগুলিকে বর্গাকার বন্ধনী দিয়ে চিহ্নিত করা হয়:

    উদাহরণস্বরূপ, visible_region.rect ফিল্ডের দুটি পুনরাবৃত্ত ক্ষেত্রে, top ফিল্ডটি visible_region.rect[0].top এবং visible_region.rect[1].top দ্বারা প্রতিনিধিত্ব করা হয়।

  • flat_property তে পুনরাবৃত্ত ক্ষেত্রগুলিকে আলাদা করা যায় না:

    উদাহরণস্বরূপ, visible_region.rect ফিল্ডটির দুটি পুনরাবৃত্ত উদাহরণের মধ্যে, top ফিল্ডটি উভয় ক্ষেত্রেই visible_region.rect.top দ্বারা উপস্থাপিত হয়।

• value এবং previous_value কলামের ক্ষেত্রে, বুলিয়ান মান 0 ( False ) বা 1 ( True ) দ্বারা প্রকাশ করা হয়।

উইনস্কোপ ট্রেস-নির্দিষ্ট টেবিলের ডেটার সাথে পারফেটটো args টেবিলের ডেটা যুক্ত করে এই ভিউগুলো তৈরি করে। আপনি সরাসরি এই টেবিলগুলো কোয়েরি করতে পারেন। args টেবিলে, key , flat_key , এবং display_value কলামগুলো যথাক্রমে property , flat_property , এবং value ভিউ কলামের অনুরূপ।

args টেবিল:

সারফেসফ্লিঙ্গার এসকিউএল ভিউ

সারফেসফ্লিঙ্গার প্রোটো ডেটা নিম্নলিখিত ফরম্যাটগুলো ব্যবহার করে:

• লেয়ার ডেটা LayerProto ফরম্যাটে রয়েছে।
• হায়ারার্কি রুট ডেটা LayersSnapshotProto ফরম্যাটে থাকে।

লেয়ার ডেটা অনুসন্ধান করতে sf_layer_search ভিউটি ব্যবহার করুন। এই ভিউটিতে নিম্নলিখিত কলামগুলো অন্তর্ভুক্ত রয়েছে:

হায়ারার্কি রুট ডেটা অনুসন্ধান করতে, sf_hierarchy_root_search ভিউটি ব্যবহার করুন। এই ভিউটিতে নিম্নলিখিত কলামগুলি অন্তর্ভুক্ত রয়েছে:

উদাহরণ কোয়েরি

• সেই সমস্ত ফ্রেম খুঁজুন যেখানে IME লেয়ারটি দৃশ্যমান:

  SELECT DISTINCT ts, layer_id, layer_name FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND is_visible=1
  

• সেই সমস্ত ফ্রেম খুঁজুন যেখানে IME লেয়ারের বৈধ স্ক্রিন বাউন্ড রয়েছে:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND property='screen_bounds.bottom'
    AND value<='24000'
  

• সেই সমস্ত ফ্রেম খুঁজুন যেখানে Taskbar লেয়ারের color.a (আলফা) পরিবর্তিত হয়:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'Taskbar%'
    AND property='color.a'
    AND value!=previous_value
  

• সেই সমস্ত ফ্রেম খুঁজুন যেখানে Wallpaper নিম্নসীমা ২৪০০-এর কম বা সমান:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name LIKE 'Wallpaper%'
    AND property='bounds.bottom'
    AND cast_int!(value) <= 2400
  

• বৈধ লেয়ার স্ট্যাক সহ ডিসপ্লেগুলির সমস্ত বৈশিষ্ট্য তালিকাভুক্ত করুন:

  SELECT STATE.* FROM sf_hierarchy_root_search STATE_WITH_DISPLAY_ON
  INNER JOIN sf_hierarchy_root_search STATE
    ON STATE.state_id = STATE_WITH_DISPLAY_ON.state_id
    AND STATE_WITH_DISPLAY_ON.flat_property='displays.layer_stack'
    AND STATE_WITH_DISPLAY_ON.value!='4294967295'
    AND STATE.property LIKE CONCAT(
      SUBSTRING(
          STATE_WITH_DISPLAY_ON.property,
          0,
          instr(STATE_WITH_DISPLAY_ON.property, ']')
      ),
      '%'
    )
  

• সেই সমস্ত ফ্রেম খুঁজুন যেখানে সোয়াইপ ব্যাক জেসচারটি দৃশ্যমান।

  SELECT DISTINCT STATE.ts FROM sf_layer_search STATE
    WHERE STATE.layer_name LIKE 'EdgeBackGestureHandler%'
  

ডেটা টেবিল

সারফেসফ্লিঙ্গার ভিউগুলো নিম্নলিখিত অন্তর্নিহিত টেবিলগুলো ব্যবহার করে তৈরি করা হয়।

surfaceflinger_layers_snapshot :

surfaceflinger_layer :

লেনদেন SQL ভিউ

ট্রানজ্যাকশন প্রোটো ডেটা TransactionTraceEntry ফরম্যাট ব্যবহার করে।

ট্রানজ্যাকশন ট্রেস ডেটা অনুসন্ধান করতে, transactions_search ভিউটি ব্যবহার করুন। এই ভিউটিতে নিম্নলিখিত কলামগুলো অন্তর্ভুক্ত রয়েছে:

উদাহরণ কোয়েরি

• সেই ফ্রেমটি খুঁজুন যেখানে লেয়ার x-এর অবস্থান -54.0-এ পরিবর্তন করার জন্য একটি ট্রানজ্যাকশন প্রয়োগ করা হয়েছিল:

  SELECT ts, transaction_id, value FROM transactions_search
    WHERE flat_property='transactions.layer_changes.x'
    AND value='-54.0'
  

• সেই ফ্রেমটি খুঁজুন যেখানে ImeContainer লেয়ারটি যোগ করা হয়েছিল:

  SELECT ts FROM transactions_search
    WHERE flat_property='added_layers.name'
    AND value='ImeContainer'
  

ডেটা টেবিল

ট্রানজ্যাকশনস এসকিউএল ভিউটি নিম্নলিখিত অন্তর্নিহিত টেবিলগুলো ব্যবহার করে তৈরি করা হয়।

surfaceflinger_transactions :

android_surfaceflinger_transaction :

android_surfaceflinger_transaction_flag :

স্বতন্ত্র লেনদেনগুলো তাদের লেনদেনের ধরনের ওপর ভিত্তি করে বিভিন্ন প্রোটো মেসেজ ফরম্যাট থেকে args টেবিলে যুক্ত করা হয়:

• LAYER_ADDED : LayerCreationArgs ফরম্যাট
• LAYER_CHANGED : LayerState বিন্যাস
• DISPLAY_ADDED : DisplayState ফরম্যাট
• DISPLAY_CHANGED : DisplayState ফরম্যাট
• LAYER_DESTROYED : কোনো আর্গুমেন্ট নেই
• LAYER_HANDLE_DESTROYED : কোনো আর্গুমেন্ট নেই
• DISPLAY_REMOVED : কোনো আর্গুমেন্ট নেই
• NOOP : কোনো আর্গুমেন্ট নেই

ট্রানজিশন SQL ভিউ

ট্রানজিশন প্রোটো ডেটা ShellTransition ফরম্যাট ব্যবহার করে।

ট্রানজিশন ডেটা অনুসন্ধান করতে, transitions_search ভিউটি ব্যবহার করুন। এই ভিউটিতে নিম্নলিখিত কলামগুলো অন্তর্ভুক্ত রয়েছে:

উদাহরণ কোয়েরি

DefaultMixedHandler দ্বারা পরিচালিত ট্রানজিশনগুলির বৈশিষ্ট্যগুলি খুঁজুন:

  SELECT
    PROPS.ts,
    PROPS.transition_id,
    PROPS.property,
    PROPS.value
  FROM transitions_search HANDLER_MATCH
  INNER JOIN transitions_search PROPS
    ON HANDLER_MATCH.transition_id = PROPS.transition_id
  WHERE HANDLER_MATCH.property = 'handler'
    AND HANDLER_MATCH.value LIKE "%DefaultMixedHandler"
  ORDER BY PROPS.transition_id, PROPS.property

ডেটা টেবিল

ট্রানজিশনস ভিউটি নিম্নলিখিত অন্তর্নিহিত টেবিলগুলো ব্যবহার করে তৈরি করা হয়।

window_manager_shell_transitions :

window_manager_shell_transition_handlers :

android_window_manager_shell_transition_participants :

ভিউক্যাপচার এসকিউএল ভিউ

ViewCapture প্রোটো ডেটা View ফরম্যাট ব্যবহার করে।

ViewCapture ডেটা অনুসন্ধান করতে, viewcapture_search ভিউটি ব্যবহার করুন। এই ভিউটিতে নিম্নলিখিত কলামগুলি অন্তর্ভুক্ত রয়েছে:

উদাহরণ কোয়েরি

যখন SearchContainerView y-অক্ষ বরাবর সরানো হয়, তখন তার সমস্ত অবস্থা খুঁজুন:

  SELECT * FROM viewcapture_search
  WHERE class_name LIKE '%SearchContainerView'
    AND flat_property='translation_y'
    AND value!=previous_value

ডেটা টেবিল

ViewCapture ভিউটি নিম্নলিখিত অন্তর্নিহিত টেবিলগুলো ব্যবহার করে তৈরি করা হয়।

android_viewcapture :

android_viewcapture_view :

প্রোটোলগ এসকিউএল টেবিল

ProtoLog প্রোটো ডেটা ProtoLogMessage ফরম্যাট ব্যবহার করে। এই ভিউতে নিম্নলিখিত কলামগুলো অন্তর্ভুক্ত রয়েছে:

উদাহরণ কোয়েরি

• transition ধারণকারী মেসেজ সহ সমস্ত লগ খুঁজুন:

  SELECT ts, message, location FROM protolog
    WHERE message LIKE '%transition%'
  

• বৈধ লেনদেন আইডি ধারণকারী সমস্ত লগ খুঁজুন:

  CREATE PERFETTO VIEW valid_tx_ids AS
    SELECT DISTINCT transaction_id FROM transactions_search
    WHERE transaction_id IS NOT NULL AND transaction_id != '0';
  
  SELECT TRANS.transaction_id, message FROM valid_tx_ids TRANS
  INNER JOIN protolog LOGS
    ON LOGS.message LIKE CONCAT('%', TRANS.transaction_id, '%');
  

উইন্ডোম্যানেজার এসকিউএল ভিউ

WindowManager প্রোটো ডেটা শ্রেণিবদ্ধ WindowManagerServiceDumpProto ফরম্যাট ব্যবহার করে। আপনি যেকোনো WindowManager কন্টেইনারের প্রোপার্টিগুলো অনুসন্ধান করতে পারেন, যার মধ্যে অন্তর্ভুক্ত রয়েছে:

• DisplayContentProto
• DisplayAreaProto
• TaskProto
• ActivityRecordProto
• WindowTokenProto
• WindowStateProto
• TaskFragmentProto
• WindowContainerProto

WindowManager ডেটা অনুসন্ধান করতে, wm_search ভিউটি ব্যবহার করুন। এই ভিউটিতে নিম্নলিখিত কলামগুলো অন্তর্ভুক্ত রয়েছে:

উদাহরণ কোয়েরি

• সেই সমস্ত স্টেটগুলি খুঁজুন যেখানে LauncherActivity দৃশ্যমান:

  SELECT DISTINCT ts, title, token FROM wm_search
    WHERE title like '%LauncherActivity%'
    AND is_visible=1
  

• সেই সমস্ত অবস্থা খুঁজুন যেখানে Wallpaper পৃষ্ঠটি নড়াচড়া করছে:

  SELECT ts, value, previous_value FROM wm_search
    WHERE title like '%Wallpaper%'
    AND property like '%surface_position%'
    AND value != previous_value
  

ডেটা টেবিল

WindowManager ভিউটি নিম্নলিখিত অন্তর্নিহিত টেবিলগুলো ব্যবহার করে তৈরি করা হয়।

android_windowmanager :

android_windowmanager_windowcontainer :

কোয়েরি চালান

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

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

কোয়েরি শুরু করতে, সার্চ বক্সে কোয়েরিটি লিখুন এবং 'Run Search Query'-তে ক্লিক করুন অথবা এটি চালানোর জন্য আপনার কিবোর্ডের এন্টার চাপুন।

কাজ শেষ হলে, ফলাফলের সারণিটি মাঝের প্যানেলে প্রদর্শিত হয়। আপনার কোয়েরিটি সার্চ বক্সের নিচে দেখা যায় এবং সেশনগুলোর মধ্যে কোয়েরিটি সংরক্ষণ করার জন্য একটি ফিল্ড থাকে।

আপনি বাম প্যানেলে থাকা 'Saved ' ট্যাবে ক্লিক করে সংরক্ষিত কোয়েরিগুলো দেখতে পারেন, এবং 'Recent' ট্যাবে ক্লিক করে সম্প্রতি চালানো কোয়েরিগুলো দেখতে পারেন:

চিত্র ২। অনুসন্ধান প্রদর্শকের বাম প্যানেল।

ফলাফল

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

চিত্র ৩. অনুসন্ধান দর্শকের ফলাফল।

ফলাফল টেবিলে যদি একটি ts কলাম থাকে, তাহলে সেই কলামের মানগুলিকে টাইমস্ট্যাম্প হিসাবে গণ্য করা হয় এবং টাইমলাইন ওভারলেতে এন্ট্রির একটি নতুন সারি হিসাবে যুক্ত করা হয়। এই সারিতে ক্লিক করুন এবং এন্ট্রিগুলির মধ্যে যাতায়াত করতে আপনার বাম এবং ডান অ্যারো কী ব্যবহার করুন:

চিত্র ৪. অনুসন্ধানের সময়রেখা।