یک ردیابی سیستم را در خط فرمان ضبط کنید

دستور systrace ابزار Systrace را فراخوانی می‌کند که به شما امکان می‌دهد اطلاعات زمان‌بندی را در تمام فرآیندهای در حال اجرا در دستگاه شما در سطح سیستم جمع‌آوری و بررسی کنید.

این سند نحوه تولید گزارش های Systrace را از خط فرمان توضیح می دهد. در دستگاه‌های دارای Android 9 (سطح API 28) یا بالاتر، می‌توانید گزارش‌های Systrace را نیز با استفاده از برنامه System Tracing ایجاد کنید.

برای اجرای systrace مراحل زیر را انجام دهید:

  1. از Android Studio، آخرین ابزار Android SDK Tools را دانلود و نصب کنید .
  2. پایتون را نصب کنید و آن را در متغیر محیطی PATH ایستگاه کاری خود قرار دهید.
  3. android-sdk /platform-tools/ را به متغیر محیطی PATH خود اضافه کنید. این فهرست شامل Android Debug Bridge باینری (adb) است که توسط برنامه systrace فراخوانی می شود.
  4. دستگاهی را که دارای Android نسخه 4.3 (سطح API 18) یا بالاتر است، با استفاده از اتصال اشکال‌زدایی USB به سیستم توسعه خود متصل کنید.

دستور systrace در بسته Android SDK Tools ارائه شده است و در android-sdk /platform-tools/systrace/ قرار دارد.

نحو

برای ایجاد گزارش HTML برای برنامه، باید systrace از خط فرمان با استفاده از نحو زیر اجرا کنید:

python systrace.py [options] [categories]

به عنوان مثال، دستور زیر systrace برای ضبط فعالیت دستگاه و ایجاد یک گزارش HTML با نام mynewtrace.html فراخوانی می کند. این لیست از دسته ها یک لیست پیش فرض معقول برای اکثر دستگاه ها است.

$ python systrace.py -o mynewtrace.html sched freq idle am wm gfx view \
    binder_driver hal dalvik camera input res memory

نکته: اگر می خواهید نام وظایف را در خروجی ردیابی ببینید، باید دسته بندی sched را در پارامترهای دستوری خود وارد کنید.

برای مشاهده لیست دسته هایی که دستگاه متصل شما پشتیبانی می کند، دستور زیر را اجرا کنید:

$ python systrace.py --list-categories

اگر هیچ دسته یا گزینه ای را مشخص نکنید، systrace گزارشی تولید می کند که شامل تمام دسته های موجود است و از تنظیمات پیش فرض استفاده می کند. دسته بندی های موجود به دستگاه متصلی که استفاده می کنید بستگی دارد.

گزینه های جهانی

گزینه های جهانی توضیحات
-h | --help پیام راهنما را نشان دهید.
-l | --list-categories دسته‌های ردیابی موجود برای دستگاه متصل شما را فهرست می‌کند.

دستورات و گزینه های فرمان

دستورات و گزینه ها توضیحات
-o file گزارش ردیابی HTML را در file مشخص شده بنویسید. اگر این گزینه را مشخص نکنید، systrace گزارش شما را در همان دایرکتوری systrace.py ذخیره می کند و نام آن را trace.html می گذارد.
-t N | --time= N ردیابی فعالیت دستگاه برای N ثانیه. اگر این گزینه را مشخص نکنید، systrace از شما می خواهد که با فشار دادن کلید Enter از خط فرمان، ردیابی را پایان دهید.
-b N | --buf-size= N از اندازه بافر ردیابی N کیلوبایت استفاده کنید. این گزینه به شما امکان می دهد حجم کل داده های جمع آوری شده در طول ردیابی را محدود کنید.
-k functions
| --ktrace= functions		 ردیابی فعالیت توابع هسته خاص، مشخص شده در یک لیست جدا شده با کاما.
-a app-name
| --app= app-name		 ردیابی را برای برنامه‌ها فعال کنید، که به‌عنوان فهرستی از نام‌های فرآیند با کاما از هم جدا شده‌اند. برنامه ها باید حاوی تماس های ابزار دقیق ردیابی از کلاس Trace باشند. هر زمان که برنامه خود را نمایه می‌کنید، باید این گزینه را مشخص کنید—بسیاری از کتابخانه‌ها، مانند RecyclerView ، شامل تماس‌های ابزار دقیق ردیابی هستند که هنگام فعال کردن ردیابی در سطح برنامه، اطلاعات مفیدی را ارائه می‌دهند. برای اطلاعات بیشتر، به تعریف رویدادهای سفارشی مراجعه کنید.

برای ردیابی همه برنامه‌ها در دستگاهی که دارای Android 9 (سطح API 28) یا بالاتر است، کاراکتر عام "*" را ارسال کنید، از جمله علامت‌های نقل قول.

--from-file= file-path یک گزارش HTML تعاملی از یک فایل، مانند فایل‌های TXT که شامل داده‌های ردیابی خام است، به جای اجرای یک ردیابی زنده ایجاد کنید.
-e device-serial
| --serial= device-serial		 ردیابی را روی یک دستگاه متصل خاص انجام دهید که با شماره سریال دستگاه آن مشخص شده است.
categories شامل اطلاعات ردیابی برای فرآیندهای سیستمی که مشخص می‌کنید، مانند gfx برای فرآیندهای سیستمی که گرافیک را ارائه می‌کنند. می‌توانید systrace با دستور -l اجرا کنید تا لیستی از سرویس‌های موجود برای دستگاه متصل خود را ببینید.
{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}