perfetto ابزاری است که به شما امکان میدهد اطلاعات عملکرد را از دستگاههای Android ازطریق پل اشکالزدایی Android (ADB) جمعآوری کنید. ابزار
perfetto را بااستفاده از فرمان adb shell perfetto ... فراخوانی کنید.
perfetto از منابع مختلفی
برای جمعآوری ردگیریهای عملکرد از دستگاهتان استفاده میکند، ازجمله:
ftraceبرای اطلاعات از هستهatraceبرای حاشیهنویسی فضای کاربر در سرویسها و برنامههاheapprofdبرای اطلاعات استفاده از حافظه بومی سرویسها و برنامهها
این صفحه نحوه فراخوانی perfetto و پیکربندی آن را برای تولید خروجی مطلوب شرح میدهد. برای اطلاعات بیشتر، به
اسناد perfetto مراجعه کنید.
مهارتهای Android
مشاهده در GitHubتحلیلگر Android
android skills add android-profilerنحو
این بخش نحوه استفاده از ADB را برای فراخوانی perfetto برای حالتهای مختلف
و تولید ردیابی شرح میدهد.
انتخاب منبع داده
perfetto شامل دو حالت زیر است که منابع دادهای را که برای ضبط ردگیری شما استفاده میکند تعیین میکند:
- حالت سبک: فقط میتواند زیرمجموعهای از منابع داده را انتخاب کند، بهویژه
atraceوftrace. بااینحال، این حالت واسطی مشابهsystraceارائه میدهد. - حالت عادی: پیکربندی خود را در میانگیر پروتکل دریافت میکند و به شما امکان میدهد
بااستفاده از منابع داده متفاوت از
atraceوftrace، از قابلیتهای بیشتری ازperfettoبهره ببرید.
گزینههای عمومی
جدول زیر گزینههای دردسترس را هنگام استفاده از perfetto در هریک از حالتها فهرست میکند:
جدول ۱. فهرست گزینههای عمومی دردسترس ابزار perfetto.
| گزینه | شرح |
|---|---|
--background |
|
perfetto بلافاصله از میانای خط فرمان خارج میشود و
به ضبط ردگیری در پسزمینه ادامه میدهد. |
--background-wait | -D
|
مانند --background، اما قبلاز خروج (تا ۳۰ ثانیه) منتظر میماند تا همه
منابع داده شروع شوند. اگر تأییدیه موفقیتآمیز دریافت شود، کد خروج صفر است و درغیراینصورت (خطا یا اتمام مهلت) غیرصفر است.
|
--alert-id
|
شناسه هشداری که این ردیابی را راهاندازی کرده است. |
--config-id
|
شناسه پیکربندی راهانداز. |
--config-uid
|
شناسه کاربر برنامهای که پیکربندی را ثبت کرده است. |
--subscription-id
|
شناسه اشتراکی که این ردیابی را راهاندازی کرده است. |
--out OUT_FILE |
|
مسیر موردنظر را برای فایل ردیابی خروجی یا توجه: باید نام مسیر کامل فایل خروجی را مشخص کنید. معمولاً فایلها باید در پوشه |
--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] |
|
مدت ردیابی را برحسب ثانیه، دقیقه، یا ساعت مشخص میکند.
برای مثال، --time 1m مدتزمان ردیابی را ۱ دقیقه تعیین میکند.
مدت پیشفرض ۱۰ ثانیه است.
|
--buffer SIZE[mb|gb] |
|
اندازه میانگیر حلقهای را برحسب مگابایت (mb) یا گیگابایت (gb) مشخص میکند.
پارامتر پیشفرض --buffer 32mb است.
|
--size SIZE[mb|gb] |
|
حداکثر اندازه فایل را به مگابایت (mb) یا گیگابایت (gb) مشخص میکند. بهطور
پیشفرض، perfetto فقط از میانگیر حلقهای درون حافظه استفاده میکند.
|
--app | -a
|
نام برنامه Android (atrace) |
این گزینهها با فهرستی از مشخصکنندههای رویداد دنبال میشوند:
جدول ۳. فهرست مشخصکنندههای رویداد برای حالت روشن.
| رویداد | شرح |
|---|---|
| ATRACE_CAT |
دستههای atrace را که میخواهید ردیابی برای آنها ضبط شود مشخص میکند.
برای مثال، فرمان زیر Window Manager را بااستفاده از atrace ردیابی میکند:
adb shell perfetto --out FILE wm
برای ثبت دستههای دیگر، این
فهرست
|
| 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 مطابقت داشته باشد.
منابع داده را بااستفاده از عضو |
--txt
|
به perfetto دستور میدهد فایل پیکربندی را بهعنوان pbtxt تجزیه کند. این
پرچم فقط برای آزمایش محلی درنظر گرفته شده است و توصیه نمیشود آن را
برای تولید فعال کنید. |
منابع داده پشتیبانیشده
این بخش منابع مختلفی را که perfetto برای تولید ردپای شما استفاده میکند شرح میدهد.
ftrace
منبع داده ftrace به perfetto اجازه میدهد رویدادها را از هسته دریافت کند.
این منبع را با تنظیم
ftrace_config
در DataSourceConfig فعال کنید.
رویدادهایی که میتوانند فعال شوند عبارتاند از:
-
sched/sched_switchsched/sched_wakeupsched/sched_wakeup_newsched/sched_process_execsched/sched_process_exitsched/sched_process_forksched/sched_process_freesched/sched_process_hangsched/sched_process_wait
رویدادهای سیستم فایل:
بسته به دستگاه، نسخه سیستمعامل، یا هسته، ممکن است رویدادهای بیشتری دردسترس باشد. برای اطلاعات بیشتر، به پروتکلهای پیکربندی مراجعه کنید.
آمار پردازش
منبع دادههای آمار فرایند به شما امکان میدهد شمارندههای نظرسنجیشده درباره سیستم و فرایندهای تکی را دریافت کنید.
این منبع را با تنظیم process_stats_config
و sys_stats_config
در DataSourceConfig فعال کنید.
دادههایی که perfetto تولید میکند شامل موارد زیر است:
-
/proc/meminfo/proc/vmstat/proc/stat
-
/proc/\<pid\>/status/proc/\<pid\>/oom_score_adj
بسته به دستگاه، نسخه سیستمعامل، و هسته، ممکن است رویدادهای بیشتری دردسترس باشد. برای کسب اطلاعات بیشتر، به پروتکلهای پیکربندی برای sys_stats
و process_stats مراجعه کنید.
heapprofd
heapprofd به شما امکان میدهد دلایل استفاده از حافظه بومی را نمونهبرداری کنید.
با تنظیم heapprofd_config
در DataSourceConfig، این منبع را فعال کنید. این تنظیم ProfilePackets را تولید میکند،
ازجمله قابهای Java پشته فراخوانی.
اطلاعات بیشتر درباره نحوه استفاده از heapprofd را میتوانید در
perfetto.dev پیدا کنید.
سایر منابع
بسته به دستگاه، نسخه سیستمعامل، و هسته شما، ممکن است منابع داده بیشتری دردسترس باشد. برای کسب اطلاعات بیشتر، به پروتکلهای پیکربندی منبع داده مراجعه کنید.
اطلاعات بیشتر درباره perfetto را میتوانید در
perfetto.dev پیدا کنید.