perfetto

perfetto ابزاری است که به شما امکان می‌دهد اطلاعات عملکرد را از دستگاه‌های Android ازطریق پل اشکال‌زدایی Android (ADB) جمع‌آوری کنید. ابزار perfetto را بااستفاده از فرمان adb shell perfetto ... فراخوانی کنید. perfetto از منابع مختلفی برای جمع‌آوری ردگیری‌های عملکرد از دستگاهتان استفاده می‌کند، ازجمله:

  • ftrace برای اطلاعات از هسته
  • atrace برای حاشیه‌نویسی فضای کاربر در سرویس‌ها و برنامه‌ها
  • heapprofd برای اطلاعات استفاده از حافظه بومی سرویس‌ها و برنامه‌ها

این صفحه نحوه فراخوانی perfetto و پیکربندی آن را برای تولید خروجی مطلوب شرح می‌دهد. برای اطلاعات بیشتر، به اسناد perfetto مراجعه کنید.

نحو

این بخش نحوه استفاده از ADB را برای فراخوانی perfetto برای حالت‌های مختلف و تولید ردیابی شرح می‌دهد.

انتخاب منبع داده

perfetto شامل دو حالت زیر است که منابع داده‌ای را که برای ضبط ردگیری شما استفاده می‌کند تعیین می‌کند:

  • حالت سبک: فقط می‌تواند زیرمجموعه‌ای از منابع داده را انتخاب کند، به‌ویژه atrace و ftrace. بااین‌حال، این حالت واسطی مشابه systrace ارائه می‌دهد.
  • حالت عادی: پیکربندی خود را در میان‌گیر پروتکل دریافت می‌کند و به شما امکان می‌دهد بااستفاده از منابع داده متفاوت از atrace و ftrace، از قابلیت‌های بیشتری از perfetto بهره ببرید.

گزینه‌های عمومی

جدول زیر گزینه‌های دردسترس را هنگام استفاده از perfetto در هریک از حالت‌ها فهرست می‌کند:

جدول ۱. فهرست گزینه‌های عمومی دردسترس ابزار perfetto.

گزینه شرح
--background |
-d
perfetto بلافاصله از میانای خط فرمان خارج می‌شود و به ضبط ردگیری در پس‌زمینه ادامه می‌دهد.
--background-wait | -D مانند --background، اما قبل‌از خروج (تا ۳۰ ثانیه) منتظر می‌ماند تا همه منابع داده شروع شوند. اگر تأییدیه موفقیت‌آمیز دریافت شود، کد خروج صفر است و درغیراین‌صورت (خطا یا اتمام مهلت) غیرصفر است.
--alert-id شناسه هشداری که این ردیابی را راه‌اندازی کرده است.
--config-id شناسه پیکربندی راه‌انداز.
--config-uid شناسه کاربر برنامه‌ای که پیکربندی را ثبت کرده است.
--subscription-id شناسه اشتراکی که این ردیابی را راه‌اندازی کرده است.
--out OUT_FILE |
-o OUT_FILE

مسیر موردنظر را برای فایل ردیابی خروجی یا - برای stdout مشخص می‌کند. perfetto خروجی را در فایل شرح‌داده‌شده در پرچم‌های قبلی می‌نویسد. قالب خروجی با قالب تعریف‌شده در AOSP trace.proto مطابقت دارد.

توجه: باید نام مسیر کامل فایل خروجی را مشخص کنید. معمولاً فایل‌ها باید در پوشه /data/misc/perfetto-traces نوشته شوند.

--upload پس‌از تکمیل، ردیابی را به بسته‌ای که با پیام IncidentReportConfig در پیکربندی ردیابی proto مشخص شده است ارسال می‌کند.
--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 دردسترس هنگام استفاده از حالت روشن.

گزینه شرح
--time TIME[s|m|h] |
-t TIME[s|m|h]
مدت ردیابی را برحسب ثانیه، دقیقه، یا ساعت مشخص می‌کند. برای مثال، --time 1m مدت‌زمان ردیابی را ۱ دقیقه تعیین می‌کند. مدت پیش‌فرض ۱۰ ثانیه است.
--buffer SIZE[mb|gb] |
-b SIZE[mb|gb]
اندازه میان‌گیر حلقه‌ای را برحسب مگابایت (mb) یا گیگابایت (gb) مشخص می‌کند. پارامتر پیش‌فرض --buffer 32mb است.
--size SIZE[mb|gb] |
-s SIZE[mb|gb]
حداکثر اندازه فایل را به مگابایت (mb) یا گیگابایت (gb) مشخص می‌کند. به‌طور پیش‌فرض، perfetto فقط از میان‌گیر حلقه‌ای درون حافظه استفاده می‌کند.
--app | -a نام برنامه Android (atrace)

این گزینه‌ها با فهرستی از مشخص‌کننده‌های رویداد دنبال می‌شوند:

جدول ۳. فهرست مشخص‌کننده‌های رویداد برای حالت روشن.

رویداد شرح
ATRACE_CAT دسته‌های atrace را که می‌خواهید ردیابی برای آن‌ها ضبط شود مشخص می‌کند. برای مثال، فرمان زیر Window Manager را بااستفاده از atrace ردیابی می‌کند:
    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 دردسترس هنگام استفاده از حالت عادی.

گزینه شرح
--config CONFIG_FILE | -c CONFIG_FILE مسیر فایل پیکربندی را مشخص می‌کند. در حالت عادی، برخی‌از پیکربندی‌ها ممکن است در میان‌گیر پروتکل پیکربندی کدگذاری شوند. این فایل باید با طرح میان‌گیر پروتکل تعریف‌شده در AOSP trace_config.proto مطابقت داشته باشد.

منابع داده را بااستفاده از عضو DataSourceConfig از TraceConfig، همان‌طور که در AOSP data_source_config.proto تعریف شده است، انتخاب و پیکربندی کنید.

--txt به perfetto دستور می‌دهد فایل پیکربندی را به‌عنوان pbtxt تجزیه کند. این پرچم فقط برای آزمایش محلی درنظر گرفته شده است و توصیه نمی‌شود آن را برای تولید فعال کنید.

منابع داده پشتیبانی‌شده

این بخش منابع مختلفی را که perfetto برای تولید ردپای شما استفاده می‌کند شرح می‌دهد.

ftrace

منبع داده ftrace به perfetto اجازه می‌دهد رویدادها را از هسته دریافت کند.

این منبع را با تنظیم ftrace_config در DataSourceConfig فعال کنید.

رویدادهایی که می‌توانند فعال شوند عبارت‌اند از:

  • فعالیت زمان‌بندی:

    • sched/sched_switch
    • sched/sched_wakeup
    • sched/sched_wakeup_new
    • sched/sched_process_exec
    • sched/sched_process_exit
    • sched/sched_process_fork
    • sched/sched_process_free
    • sched/sched_process_hang
    • sched/sched_process_wait
  • رویدادهای سیستم فایل:

  • atrace رویداد

بسته به دستگاه، نسخه سیستم‌عامل، یا هسته، ممکن است رویدادهای بیشتری دردسترس باشد. برای اطلاعات بیشتر، به پروتکل‌های پیکربندی مراجعه کنید.

آمار پردازش

منبع داده‌های آمار فرایند به شما امکان می‌دهد شمارنده‌های نظرسنجی‌شده درباره سیستم و فرایندهای تکی را دریافت کنید.

این منبع را با تنظیم process_stats_config و sys_stats_config در DataSourceConfig فعال کنید.

داده‌هایی که perfetto تولید می‌کند شامل موارد زیر است:

بسته به دستگاه، نسخه سیستم‌عامل، و هسته، ممکن است رویدادهای بیشتری دردسترس باشد. برای کسب اطلاعات بیشتر، به پروتکل‌های پیکربندی برای sys_stats و process_stats مراجعه کنید.

heapprofd

heapprofd به شما امکان می‌دهد دلایل استفاده از حافظه بومی را نمونه‌برداری کنید.

با تنظیم heapprofd_config در DataSourceConfig، این منبع را فعال کنید. این تنظیم ProfilePackets را تولید می‌کند، ازجمله قاب‌های Java پشته فراخوانی.

اطلاعات بیشتر درباره نحوه استفاده از heapprofd را می‌توانید در perfetto.dev پیدا کنید.

سایر منابع

بسته به دستگاه، نسخه سیستم‌عامل، و هسته شما، ممکن است منابع داده بیشتری دردسترس باشد. برای کسب اطلاعات بیشتر، به پروتکل‌های پیکربندی منبع داده مراجعه کنید.

اطلاعات بیشتر درباره perfetto را می‌توانید در perfetto.dev پیدا کنید.