نام (NAME)

sadf - نمایش داده‌های جمع‌آوری‌شده توسط sar در چندین قالب مختلف

خلاصه دستور (SYNOPSIS)

sadf [ -C ] [ -c | -d | -g | -j | -l | -p | -r | -x ] [ -H ] [ -h ] [ -T | -t | -U ] [ -V ] [ -O opts [,...] ] [ -P { cpu_list | ALL } ] [ -s [ start_time ] ] ] [ -e [ end_time ] ] ] [ --dev=dev_list ] [ --fs=fs_list ] [ --iface=iface_list] [ --int=int_list ] [ -- sar_options ] [ interval [ count ] ] [ datafile | -[0-9]+ ]

توضیحات (DESCRIPTION)

دستور sadf برای نمایش محتوای فایل‌های داده ایجادشده توسط دستور sar(1) به‌کار می‌رود. اما بر خلاف sar، دستور sadf می‌تواند داده‌های خود را در چندین قالب مختلف (مانند CSV، XML و غیره) بنویسد. قالب پیش‌فرض قالبی است که به‌سادگی توسط دستورهای پردازش الگو مانند awk پردازش می‌شود (گزینهٔ -p را ببینید). دستور sadf همچنین می‌تواند برای رسم نمودارهای فعالیت‌های گوناگونِ جمع‌آوری‌شده توسط sar و نمایش آن‌ها به‌صورت گرافیک‌های SVG (گرافیک برداری مقیاس‌پذیر) در مرورگر وب شما استفاده شود (گزینهٔ -g را ببینید).

دستور sadf رکوردهای ذخیره‌شده در فایل datafile را استخراج کرده و در خروجی استاندارد می‌نویسد. این فایل باید توسط نسخه‌ای از sar ایجاد شده باشد که با نسخهٔ sadf سازگار است. اگر datafile مشخص نشود، sadf از فایل دادهٔ روزانهٔ استاندارد فعالیت سیستم استفاده می‌کند. همچنین می‌توان -1، -2 و غیره را به‌عنوان آرگومان به sadf داد تا داده‌های چند روز پیش را نمایش دهد. برای نمونه، -1 به فایل استاندارد فعالیت سیستم در روز گذشته اشاره خواهد کرد.

نام فایل دادهٔ روزانهٔ استاندارد فعالیت سیستم saDD یا saYYYYMMDD است، که در آن YYYY نشان‌دهندهٔ سال جاری، MM ماه جاری و DD روز جاری است. sadf جدیدترین فایل را میان saDD و saYYYYMMDD جستجو کرده و از آن استفاده می‌کند. به‌طور پیش‌فرض این فایل در دایرکتوری /var/log/sa قرار دارد. با این حال می‌توان مکان دیگری را برای آن مشخص کرد: اگر datafile یک دایرکتوری باشد (به‌جای یک فایل معمولی)، به‌عنوان دایرکتوری‌ای در نظر گرفته می‌شود که فایل دادهٔ روزانهٔ استاندارد فعالیت سیستم در آن قرار دارد.

پارامترهای interval و count برای این استفاده می‌شوند که به sadf بگویند به تعداد count رکورد را با فواصل زمانی interval ثانیه انتخاب کند. اگر پارامتر count تنظیم نشود، تمام رکوردهای ذخیره‌شده در فایل داده نمایش داده خواهند شد.

تمام پرچم‌های فعالیت sar را می‌توان در خط فرمان وارد کرد تا مشخص شود کدام فعالیت‌ها باید گزارش شوند. پیش از تعیین آن‌ها، دو خط تیره (--) در خط فرمان قرار دهید تا این پرچم‌ها با پرچم‌های sadf اشتباه گرفته نشوند. مشخص نکردن هیچ پرچمی، فقط فعالیت پردازنده (CPU) را انتخاب می‌کند.

گزینه‌ها (OPTIONS)

-C

به sadf می‌گوید که توضیحات (کامنت‌های) موجود در فایل را نمایش دهد.

-c

یک فایل دادهٔ باینری قدیمی فعالیت سیستم (نسخهٔ 9.1.6 و پس از آن) را به قالب به‌روز فعلی تبدیل می‌کند. از ساختار دستوری زیر استفاده کنید:

sadf -c old_datafile > new_datafile

تبدیل را می‌توان با استفاده از گزینهٔ -O کنترل کرد (به زیر مراجعه کنید).

-d

محتوای فایل داده را در قالبی چاپ می‌کند که به‌سادگی توسط یک سیستم پایگاه داده رابطه‌ای قابل خواندن و دریافت باشد. خروجی شامل فیلدهایی است که با نقطه-ویرگول از هم جدا شده‌اند. هر رکورد شامل نام میزبان (hostname) میزبانی است که فایل در آن ایجاد شده، مقدار بازه زمانی (یا -1 در صورت عدم کاربرد)، برچسب زمانی در قالبی که به‌راحتی توسط بیشتر پایگاه‌های داده پذیرفته می‌شود، و فیلدهای دادهٔ اضافیِ جداشده با نقطه-ویرگول مطابق با گزینه‌های خط فرمان sar_options است. توجه داشته باشید که خروجی برچسب زمانی را می‌توان با گزینه‌های -T، -t و -U کنترل کرد.

--dev=dev_list

دستگاه‌های بلوکی را که آمار آن‌ها باید توسط sadf نمایش داده شود، مشخص می‌کند. dev_list فهرستی از نام دستگاه‌های جداشده با کاما است. همراه با گزینهٔ -d از دستور sar مفید است.

-e [ hh:mm[:ss] ]
-e [ seconds_since_the_epoch ]

--fs=fs_list

سیستم‌فایل‌هایی را که آمار آن‌ها باید توسط sadf نمایش داده شود، مشخص می‌کند. fs_list فهرستی از نام سیستم‌فایل‌ها یا نقاط اتصال (mountpoints) جداشده با کاما است. همراه با گزینهٔ -F از دستور sar مفید است.

-g

محتوای فایل داده را در قالب SVG (گرافیک برداری مقیاس‌پذیر) چاپ می‌کند. این گزینه شما را قادر می‌سازد تا نمودارهای زیبایی را در مرورگر وب خود نمایش دهید. از ساختار زیر استفاده کنید:

sadf -g your_datafile [ -- sar_options ] > output.svg

و فایل SVG حاصل را در مرورگر وب دلخواه خود باز کنید. خروجی را می‌توان با استفاده از گزینهٔ -O کنترل کرد (به زیر مراجعه کنید).

-H

تنها سربرگ گزارش را نمایش می‌دهد (در صورت کاربرد). اگر قالبی مشخص نشده باشد، داده‌های سربرگ (متاداده) فایل داده نمایش داده می‌شوند.

-h

هنگامی که همراه با گزینهٔ -d استفاده شود، تمام فعالیت‌ها به‌صورت افقی روی یک خط منفرد نمایش داده خواهند شد.

--iface=iface_list

رابط‌های شبکه‌ای را که آمار آن‌ها باید توسط sadf نمایش داده شود، مشخص می‌کند. iface_list فهرستی از نام رابط‌های جداشده با کاما است. همراه با گزینه‌های -n DEV و -n EDEV از دستور sar مفید است.

--int=int_list

نام وقفه‌هایی را که آمار آن‌ها باید توسط sadf نمایش داده شود، مشخص می‌کند. int_list فهرستی از مقادیر یا بازه‌ای از مقادیرِ جداشده با کاما است (برای نمونه، 0-16,35,40-). همراه با گزینهٔ -I از دستور sar مفید است.

-j

محتوای فایل داده را در قالب JSON (نشانه‌گذاری شیء جاوااسکریپت) چاپ می‌کند. برچسب‌های زمانی را می‌توان با گزینه‌های -T و -t کنترل کرد.

-l

محتوای فایل داده را به یک بایگانی PCP (Performance Co-Pilot) صادر می‌کند. نام بایگانی را می‌توان با استفاده از کلیدواژهٔ pcparchive= همراه با گزینهٔ -O تعیین کرد.

-O opts[,...]

از گزینه‌های مشخص‌شده برای کنترل خروجی sadf استفاده می‌کند. گزینه‌های زیر برای کنترل خروجی SVG نمایش داده‌شده توسط sadf -g به‌کار می‌روند:

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

گزینهٔ زیر ممکن است هنگام صدور داده‌ها به یک آرشیو PCP استفاده شود:

گزینهٔ زیر برای کنترل خروجی خام نمایش داده شده توسط sadf -r: به کار می‌رود:

-P { cpu_list | ALL }

به sadf اعلام می‌کند که آمار وابسته به پردازنده تنها برای پردازنده یا پردازنده‌های مشخص‌شده گزارش شوند. cpu_list فهرستی از مقادیر یا بازه‌ای از مقادیر است که با کاما از هم جدا شده‌اند (مانند 0,2,4-7,12-). توجه داشته باشید که پردازندهٔ 0 نخستین پردازنده است و پردازندهٔ all میانگین سراسری میان تمام پردازنده‌ها است. مشخص کردن کلیدواژهٔ ALL آمار را به تفکیک برای هر پردازنده و به‌طور کلی برای تمام پردازنده‌ها گزارش می‌کند.

-p

چاپ محتوای فایل داده در قالبی که بتواند به‌راحتی توسط دستورهای پردازش الگو مانند awk مدیریت شود. خروجی شامل فیلدهایی است که با تب (tab) جدا شده‌اند. هر رکورد شامل نام میزبانِ میزبانی که فایل در آن ایجاد شده، مقدار بازه زمانی (یا -1 در صورت عدم کاربرد)، برچسب زمان، نام دستگاه (یا - در صورت عدم کاربرد)، نام فیلد و مقدار آن است. توجه داشته باشید که خروجی برچسب زمان می‌تواند توسط گزینه‌های -T، -t و -U. کنترل شود.

-r

چاپ محتوای خام فایل داده. در این قالب، مقادیر تمام شمارنده‌ها همان‌طور که از هسته خوانده شده‌اند نمایش داده می‌شوند؛ به این معنی که برای مثال، هیچ مقدار میانگینی در طول بازهٔ زمانی سپری‌شده محاسبه نمی‌شود. خروجی می‌تواند با استفاده از گزینهٔ -O (به بالا مراجعه کنید) کنترل شود.

-s [ hh:mm[:ss] ]
-s [ seconds_since_the_epoch ]

-T

نمایش برچسب زمان بر حسب زمان محلی به جای UTC (زمان هماهنگ جهانی).

-t

نمایش برچسب زمان بر حسب زمان محلی اصلی ایجادکنندهٔ فایل داده به جای UTC (زمان هماهنگ جهانی).

-U

نمایش برچسب زمان (UTC - زمان هماهنگ جهانی) بر حسب ثانیه از مبدأ epoch.

-V

چاپ شمارهٔ نسخه و سپس خروج.

-x

چاپ محتوای فایل داده در قالب XML. برچسب‌های زمان می‌توانند با گزینه‌های -T و -t. کنترل شوند. تعریف نوع سند (DTD) متناظر و XML Schema در بستهٔ منبع sysstat گنجانده شده‌اند. آن‌ها همچنین در https://sysstat.github.io در دسترس هستند..SH "محیط (ENVIRONMENT)" دستور sadf متغیرهای محیطی زیر را مد نظر قرار می‌دهد:

S_COLORS_PALETTE

رنگ‌های مورد استفاده توسط sadf -g را برای ترسیم خروجی SVG مشخص می‌کند. این متغیر محیطی تنها زمانی در نظر گرفته می‌شود که پالت رنگی سفارشی با گزینهٔ customcol (گزینهٔ -O را ببینید) انتخاب شده باشد. مقدار آن فهرستی جداشده با دونقطه (:) از قابلیت‌های مرتبط با اعداد هگزادسیمال شش‌رقمی و سه‌بایتی (سه‌تایی‌های هگز) است که رنگ‌ها را نشان می‌دهند و پیش‌فرض آن به صورت زیر است:

0=000000:1=1a1aff:2=1affb2:3=b21aff:
4=1ab2ff:5=ff1a1a:6=ffb31a:7=b2ff1a:
8=efefef:9=000000:A=1a1aff:B=1affb2:
C=b21aff:D=1ab2ff:E=ff1a1a:F=ffb31a:
G=bebebe:H=000000:I=000000:K=ffffff:
L=000000:T=000000:W=000000:X=000000

قابلیت‌های متشکل از یک رقم هگزادسیمال (از 0 تا F) برای مشخص کردن شانزده رنگ اول در پالت به کار می‌روند (این رنگ‌ها برای رسم نمودارها استفاده می‌شوند)، به عنوان مثال، 3=ffffff مشخص می‌کند که سومین رنگ در پالت سفید (0xffffff) است.
سایر قابلیت‌ها عبارتند از:

S_TIME_DEF_TIME

اگر این متغیر وجود داشته باشد و مقدار آن UTC باشد، آنگاه sadf به جای زمان محلی، از زمان UTC برای تعیین فایل داده‌های روزانهٔ جاری واقع در دایرکتوری /var/log/sa استفاده خواهد کرد.

مثال‌ها (EXAMPLES)

sadf -d /var/log/sa/sa21 -- -r -n DEV

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

sadf -p -P 1

استخراج آمارهای CPU برای پردازندهٔ ۱ (دومین پردازنده) از فایل داده‌های روزانهٔ جاری، و نمایش آن‌ها در قالبی که به‌راحتی توسط یک دستور پردازش الگو قابل مدیریت باشد.

گزارش باگ‌ها (BUGS)

خروجی SVG (همان‌طور که توسط گزینهٔ -g ایجاد می‌شود) کاملاً با استاندارد SVG 1.1 سازگار است. گرافیک‌ها با موفقیت در مرورگرهای وب مختلف از جمله Firefox، Chrome و Opera نمایش داده شده‌اند. با این وجود، رندر SVG در مرورگرهای مایکروسافت معیوب است (بر روی Internet Explorer 11 و Edge 13.1 آزمایش شده است): بنابراین لطفاً از آن‌ها استفاده نکنید..SH "فایل‌ها (FILES)" /var/log/sa/saDD
/var/log/sa/saYYYYMMDD

نویسندگان (AUTHORS)

Sebastien Godard (sysstat <at> orange.fr)

همچنین ببینید (SEE ALSO)

sar(1), sadc(8), sa1(8), sa2(8), sysstat(5)

https://github.com/sysstat/sysstat
https://sysstat.github.io