.\" sadf manual page - (C) 1999-2025 Sebastien Godard (sysstat <at> orange.fr)
.TH SADF 1 "NOVEMBER 2025" Linux "راهنمای کاربر لینوکس" -*- nroff -*-
.SH "نام (NAME)"
sadf \- نمایش داده‌های جمع‌آوری‌شده توسط sar در چندین قالب مختلف

.SH "خلاصه دستور (SYNOPSIS)"
.B sadf [ \-C ] [ \-c | \-d | \-g | \-j | \-l | \-p | \-r | \-x ] [ \-H ] [ \-h ] [ \-T | \-t | \-U ] [ \-V ] [ \-O
.IB "opts " "[,...] ] [ \-P { " "cpu_list " "| ALL } ] [ \-s [ "
.IB "start_time " "] ] ] [ \-e [ " "end_time " "] ] ]"
.BI "[ \-\-dev=" "dev_list " "] [ \-\-fs=" "fs_list " "] [ \-\-iface=" "iface_list" "] [ \-\-int=" "int_list " "] [ \-\-"
.IB "sar_options " "] [ " "interval " "[ " "count " "] ] [ " "datafile " "| " "\-[0\-9]+ " "]"

.SH "توضیحات (DESCRIPTION)"
دستور
.B sadf
برای نمایش محتوای فایل‌های داده ایجادشده توسط دستور
.BR sar (1)
به‌کار می‌رود. اما بر خلاف
.BR sar "، دستور " sadf
می‌تواند داده‌های خود را در چندین قالب مختلف (مانند CSV، XML و غیره) بنویسد.
قالب پیش‌فرض قالبی است که به‌سادگی توسط دستورهای پردازش الگو مانند
.B awk
پردازش می‌شود (گزینهٔ
.B \-p
را ببینید). دستور
.B sadf
همچنین می‌تواند برای رسم نمودارهای فعالیت‌های گوناگونِ جمع‌آوری‌شده توسط
.B sar
و نمایش آن‌ها به‌صورت گرافیک‌های SVG (گرافیک برداری مقیاس‌پذیر) در مرورگر وب شما استفاده شود (گزینهٔ
.BR \-g
را ببینید).
.PP
دستور
.B sadf
رکوردهای ذخیره‌شده در فایل
.I datafile
را استخراج کرده و در خروجی استاندارد می‌نویسد. این فایل باید توسط نسخه‌ای از
.B sar
ایجاد شده باشد که با نسخهٔ
.B sadf
سازگار است. اگر
.I datafile
مشخص نشود،
.B sadf
از فایل دادهٔ روزانهٔ استاندارد فعالیت سیستم استفاده می‌کند.
همچنین می‌توان
.BR \-1 "، " \-2
و غیره را به‌عنوان آرگومان به
.B sadf
داد تا داده‌های چند روز پیش را نمایش دهد. برای نمونه،
.B \-1
به فایل استاندارد فعالیت سیستم در روز گذشته اشاره خواهد کرد.
.PP
نام فایل دادهٔ روزانهٔ استاندارد فعالیت سیستم
.IR saDD " یا " saYYYYMMDD
است، که در آن
.IR YYYY " نشان‌دهندهٔ سال جاری، " MM " ماه جاری و " DD
روز جاری است.
.B sadf
جدیدترین فایل را میان
.IR saDD " و " saYYYYMMDD
جستجو کرده و از آن استفاده می‌کند. به‌طور پیش‌فرض این فایل در دایرکتوری
.I /var/log/sa
قرار دارد. با این حال می‌توان مکان دیگری را برای آن مشخص کرد: اگر
.I datafile
یک دایرکتوری باشد (به‌جای یک فایل معمولی)، به‌عنوان دایرکتوری‌ای در نظر گرفته می‌شود که فایل دادهٔ روزانهٔ استاندارد فعالیت سیستم در آن قرار دارد.
.PP
پارامترهای
.I interval
و
.I count
برای این استفاده می‌شوند که به
.B sadf
بگویند به تعداد
.I count
رکورد را با فواصل زمانی
.I interval
ثانیه انتخاب کند. اگر پارامتر
.I count
تنظیم نشود، تمام رکوردهای ذخیره‌شده در فایل داده نمایش داده خواهند شد.
.PP
تمام پرچم‌های فعالیت
.B sar
را می‌توان در خط فرمان وارد کرد تا مشخص شود کدام فعالیت‌ها باید گزارش شوند. پیش از تعیین آن‌ها، دو خط تیره
.RB ( \-\- )
در خط فرمان قرار دهید تا این پرچم‌ها با پرچم‌های
.B sadf
اشتباه گرفته نشوند.
مشخص نکردن هیچ پرچمی، فقط فعالیت پردازنده (CPU) را انتخاب می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-C
به
.B sadf
می‌گوید که توضیحات (کامنت‌های) موجود در فایل را نمایش دهد.
.TP
.B \-c
یک فایل دادهٔ باینری قدیمی فعالیت سیستم (نسخهٔ 9.1.6 و پس از آن) را به قالب به‌روز فعلی تبدیل می‌کند. از ساختار دستوری زیر استفاده کنید:

.BI "sadf \-c " "old_datafile " "> " "new_datafile"

تبدیل را می‌توان با استفاده از گزینهٔ
.B \-O
کنترل کرد (به زیر مراجعه کنید).
.TP
.B \-d
محتوای فایل داده را در قالبی چاپ می‌کند که به‌سادگی توسط یک سیستم پایگاه داده رابطه‌ای قابل خواندن و دریافت باشد. خروجی شامل فیلدهایی است که با نقطه-ویرگول از هم جدا شده‌اند. هر رکورد شامل نام میزبان (hostname) میزبانی است که فایل در آن ایجاد شده، مقدار بازه زمانی (یا \-1 در صورت عدم کاربرد)، برچسب زمانی در قالبی که به‌راحتی توسط بیشتر پایگاه‌های داده پذیرفته می‌شود، و فیلدهای دادهٔ اضافیِ جداشده با نقطه-ویرگول مطابق با گزینه‌های خط فرمان
.IR sar_options
است.
توجه داشته باشید که خروجی برچسب زمانی را می‌توان با گزینه‌های
.BR \-T "، " \-t
و
.B \-U
کنترل کرد.
.TP
.BI "\-\-dev=" "dev_list"
دستگاه‌های بلوکی را که آمار آن‌ها باید توسط
.B sadf
نمایش داده شود، مشخص می‌کند.
.I dev_list
فهرستی از نام دستگاه‌های جداشده با کاما است. همراه با گزینهٔ
.B \-d
از دستور
.B sar
مفید است.
.RE
.PP
.BI "\-e [ " "hh" ":" "mm" "[:" "ss" "] ]"
.br
.BI "\-e [ " "seconds_since_the_epoch " "]"
.RS
زمان پایان گزارش را تعیین می‌کند. زمان پایان پیش‌فرض 18:00:00 است. ساعت‌ها باید در قالب ۲۴ ساعته، یا به‌صورت تعداد ثانیه‌های گذشته از مبدأ زمان (epoch) به‌شکل یک عدد ۱۰ رقمی داده شوند.
.RE
.TP
.BI "\-\-fs=" "fs_list"
سیستم‌فایل‌هایی را که آمار آن‌ها باید توسط
.B sadf
نمایش داده شود، مشخص می‌کند.
.I fs_list
فهرستی از نام سیستم‌فایل‌ها یا نقاط اتصال (mountpoints) جداشده با کاما است. همراه با گزینهٔ
.B \-F
از دستور
.B sar
مفید است.
.TP
.B \-g
محتوای فایل داده را در قالب SVG (گرافیک برداری مقیاس‌پذیر) چاپ می‌کند.
این گزینه شما را قادر می‌سازد تا نمودارهای زیبایی را در مرورگر وب خود نمایش دهید.
از ساختار زیر استفاده کنید:

.BI "sadf \-g " "your_datafile " "[ \-\- " "sar_options " "] > " "output.svg"

و فایل SVG حاصل را در مرورگر وب دلخواه خود باز کنید.
خروجی را می‌توان با استفاده از گزینهٔ
.B \-O
کنترل کرد (به زیر مراجعه کنید).
.TP
.B \-H
تنها سربرگ گزارش را نمایش می‌دهد (در صورت کاربرد). اگر قالبی مشخص نشده باشد، داده‌های سربرگ (متاداده) فایل داده نمایش داده می‌شوند.
.TP
.B \-h
هنگامی که همراه با گزینهٔ
.B \-d
استفاده شود، تمام فعالیت‌ها به‌صورت افقی روی یک خط منفرد نمایش داده خواهند شد.
.TP
.BI "\-\-iface=" "iface_list"
رابط‌های شبکه‌ای را که آمار آن‌ها باید توسط
.B sadf
نمایش داده شود، مشخص می‌کند.
.I iface_list
فهرستی از نام رابط‌های جداشده با کاما است. همراه با گزینه‌های
.B \-n DEV
و
.B \-n EDEV
از دستور
.B sar
مفید است.
.TP
.BI "\-\-int=" "int_list"
نام وقفه‌هایی را که آمار آن‌ها باید توسط
.B sadf
نمایش داده شود، مشخص می‌کند.
.I int_list
فهرستی از مقادیر یا بازه‌ای از مقادیرِ جداشده با کاما است (برای نمونه،
.BR 0\-16,35,40\- ).
همراه با گزینهٔ
.B \-I
از دستور
.B sar
مفید است.
.TP
.B \-j
محتوای فایل داده را در قالب JSON (نشانه‌گذاری شیء جاوااسکریپت) چاپ می‌کند. برچسب‌های زمانی را می‌توان با گزینه‌های
.B \-T
و
.B \-t
کنترل کرد.
.TP
.B \-l
محتوای فایل داده را به یک بایگانی PCP (Performance Co-Pilot) صادر می‌کند.
نام بایگانی را می‌توان با استفاده از کلیدواژهٔ
.B pcparchive=
همراه با گزینهٔ
.B \-O
تعیین کرد.
.TP
.BI "\-O " "opts" "[,...]"
از گزینه‌های مشخص‌شده برای کنترل خروجی
.B sadf
استفاده می‌کند.
گزینه‌های زیر برای کنترل خروجی SVG نمایش داده‌شده توسط
.B sadf \-g
به‌کار می‌روند:
.RS
.IP autoscale
تمام نمودارهای یک نمای معین را بر اساس مقیاس نمای فعلی تا حد امکان بزرگ رسم می‌کند. برای انجام این کار، از یک ضریب (۱۰، ۱۰۰، ۱۰۰۰ و غیره) برای بزرگ‌تر کردن ترسیم نمودار استفاده می‌شود.
این گزینه ممکن است زمانی کاربردی باشد که چندین نمودار در یک نما رسم شوند؛ برخی تنها با مقادیر بسیار کوچک و برخی دیگر با مقادیر بالا، که دومی مشاهدهٔ اولی را دشوار می‌سازد.
.IP bwcol
از یک پالت سیاه‌وسفید برای رسم نمودارها استفاده می‌کند.
.IP customcol
به‌جای پالت پیش‌فرض، از یک پالت رنگی سفارشی برای رسم نمودارها استفاده می‌کند. متغیر محیطی
.B S_COLORS_PALETTE
را در ادامه ببینید تا با نحوهٔ سفارشی‌سازی آن پالت آشنا شوید..IP debug
افزودن کامنت‌های مفید در فایل خروجی SVG.
.TP
.RI "height=" "value"
تنظیم ارتفاع بوم SVG بر روی
.IR "value" "."
.IP oneday
نمایش داده‌های نمودارها در یک دورهٔ ۲۴ ساعته. توجه داشته باشید که ساعت‌ها به‌طور پیش‌فرض همچنان بر حسب UTC چاپ می‌شوند: باید از گزینهٔ
.BR "\-T " "برای چاپ آن‌ها در زمان محلی"
و به‌دست آوردن یک بازهٔ زمانی که از نیمه‌شب آغاز می‌شود، استفاده کنید.
.IP packed
گروه‌بندی تمام نماها از یک فعالیت یکسان (و برای یک دستگاه یکسان) در یک سطر.
.IP showidle
همچنین نمایش وضعیت %idle در نمودارهای مربوط به آمار CPU.
.IP showinfo
نمایش اطلاعات اضافی (مانند تاریخ و نام میزبان) روی هر نما.
.IP showtoc
افزودن فهرست مطالب در ابتدای خروجی SVG، متشکل از پیوندهایی که به نخستین نمودار هر فعالیت اشاره دارند.
.IP skipempty
نماهایی که تمامی نمودارهای آن‌ها تنها دارای مقادیر صفر هستند نمایش داده نشوند.
.RE
.IP
گزینهٔ زیر ممکن است هنگام تبدیل یک فایل داده باینری قدیمی فعالیت سیستم به قالب به‌روز فعلی استفاده شود:
.RS
.TP
.RI "hz=" "value"
مشخص کردن تعداد تیک‌ها در هر ثانیه برای ماشینی که فایل داده قدیمی روی آن ایجاد شده است.
.RE
.IP
گزینهٔ زیر ممکن است هنگام صدور داده‌ها به یک آرشیو PCP استفاده شود:
.RS
.TP
.RI "pcparchive=" "name"
مشخص کردن نام آرشیو PCP برای ایجاد.
.RE
.IP
گزینهٔ زیر برای کنترل خروجی خام نمایش داده شده توسط
.BR "sadf \-r" ":"
به کار می‌رود:
.RS
.IP debug
نمایش اطلاعات اضافی که عمدتاً برای مقاصد اشکال‌زدایی مفید است.
.RE
.TP
.BI "\-P { " "cpu_list " "| ALL }"
به
.B sadf
اعلام می‌کند که آمار وابسته به پردازنده تنها برای پردازنده یا پردازنده‌های مشخص‌شده گزارش شوند.
.I cpu_list
فهرستی از مقادیر یا بازه‌ای از مقادیر است که با کاما از هم جدا شده‌اند (مانند
.BR "0,2,4\-7,12\-" ")."
توجه داشته باشید که پردازندهٔ 0 نخستین پردازنده است و پردازندهٔ
.BR "all " "میانگین سراسری میان تمام پردازنده‌ها است. مشخص کردن کلیدواژهٔ " "ALL"
آمار را به تفکیک برای هر پردازنده و به‌طور کلی برای تمام پردازنده‌ها گزارش می‌کند.
.TP
.B \-p
چاپ محتوای فایل داده در قالبی که بتواند به‌راحتی توسط دستورهای پردازش الگو مانند
.BR "awk"
مدیریت شود.
خروجی شامل فیلدهایی است که با تب (tab) جدا شده‌اند. هر رکورد شامل نام میزبانِ میزبانی که فایل در آن ایجاد شده، مقدار بازه زمانی
(یا \-1 در صورت عدم کاربرد)، برچسب زمان، نام دستگاه (یا \- در صورت عدم کاربرد)، نام فیلد و مقدار آن است.
توجه داشته باشید که خروجی برچسب زمان می‌تواند توسط گزینه‌های
.BR "\-T" "، " "\-t " "و " "\-U" "."
کنترل شود.
.TP
.B \-r
چاپ محتوای خام فایل داده. در این قالب، مقادیر تمام شمارنده‌ها همان‌طور که از هسته خوانده شده‌اند نمایش داده می‌شوند؛ به این معنی که برای مثال، هیچ مقدار میانگینی در طول بازهٔ زمانی سپری‌شده محاسبه نمی‌شود.
خروجی می‌تواند با استفاده از گزینهٔ
.BR "\-O " "(به بالا مراجعه کنید)"
کنترل شود.
.PP
.BI "\-s [ " "hh" ":" "mm" "[:" "ss" "] ]"
.br
.BI "\-s [ " "seconds_since_the_epoch " "]"
.RS
تنظیم زمان آغاز گزارش. زمان آغاز پیش‌فرض 08:00:00 است. ساعت باید در قالب ۲۴ ساعته یا به‌صورت تعداد ثانیه‌های سپری‌شده از مبدأ epoch (به‌صورت یک عدد ۱۰ رقمی) مشخص شود.
.RE
.TP
.B \-T
نمایش برچسب زمان بر حسب زمان محلی به جای UTC (زمان هماهنگ جهانی).
.TP
.B \-t
نمایش برچسب زمان بر حسب زمان محلی اصلی ایجادکنندهٔ فایل داده به جای UTC (زمان هماهنگ جهانی).
.TP
.B \-U
نمایش برچسب زمان (UTC - زمان هماهنگ جهانی) بر حسب ثانیه از مبدأ epoch.
.TP
.B \-V
چاپ شمارهٔ نسخه و سپس خروج.
.TP
.B \-x
چاپ محتوای فایل داده در قالب XML.
برچسب‌های زمان می‌توانند با گزینه‌های
.BR "\-T " "و " "\-t" "."
کنترل شوند.
تعریف نوع سند (DTD) متناظر و XML Schema در بستهٔ منبع sysstat گنجانده شده‌اند. آن‌ها همچنین در
.IR "https://sysstat.github.io"
در دسترس هستند..SH "محیط (ENVIRONMENT)"
دستور
.B sadf
متغیرهای محیطی زیر را مد نظر قرار می‌دهد:
.TP
.B S_COLORS_PALETTE
رنگ‌های مورد استفاده توسط
.B sadf \-g
را برای ترسیم خروجی SVG مشخص می‌کند. این متغیر محیطی تنها زمانی در نظر گرفته می‌شود که پالت رنگی سفارشی با گزینهٔ
.B customcol
(گزینهٔ
.B \-O
را ببینید) انتخاب شده باشد. مقدار آن فهرستی جداشده با دونقطه (:) از قابلیت‌های مرتبط با اعداد هگزادسیمال شش‌رقمی و سه‌بایتی (سه‌تایی‌های هگز) است که رنگ‌ها را نشان می‌دهند و پیش‌فرض آن به صورت زیر است:

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

قابلیت‌های متشکل از یک رقم هگزادسیمال
(از
.B 0
تا
.BR F )
برای مشخص کردن شانزده رنگ اول در پالت به کار می‌روند (این رنگ‌ها برای رسم نمودارها استفاده می‌شوند)، به عنوان مثال،
.B 3=ffffff
مشخص می‌کند که سومین رنگ در پالت سفید (0xffffff) است.
.br
سایر قابلیت‌ها عبارتند از:
.RS
.TP
.B G=
رنگ مورد استفاده برای رسم خطوط شبکه (grid) را مشخص می‌کند.
.TP
.B H=
رنگ مورد استفاده برای نمایش سرآیند گزارش را مشخص می‌کند.
.TP
.B I=
رنگ مورد استفاده برای نمایش اطلاعات تکمیلی (مانند تاریخ، نام میزبان و...) را مشخص می‌کند.
.TP
.B K=
رنگ مورد استفاده برای پس‌زمینهٔ نمودارها را مشخص می‌کند.
.TP
.B L=
رنگ پیش‌فرض (که برای مثال برای نمایش فهرست مطالب استفاده می‌شود) را مشخص می‌کند.
.TP
.B T=
رنگ مورد استفاده برای نمایش عنوان نمودارها را مشخص می‌کند.
.TP
.B W=
رنگ مورد استفاده برای نمایش پیام‌های هشدار و خطا را مشخص می‌کند.
.TP
.B X=
رنگ مورد استفاده برای رسم محورها و نمایش درجه‌بندی‌ها را مشخص می‌کند.
.RE
.TP
.B S_TIME_DEF_TIME
اگر این متغیر وجود داشته باشد و مقدار آن
.B UTC
باشد، آنگاه
.B sadf
به جای زمان محلی، از زمان UTC برای تعیین فایل داده‌های روزانهٔ جاری واقع در دایرکتوری
.IR /var/log/sa
استفاده خواهد کرد.

.SH "مثال‌ها (EXAMPLES)"
.TP
.B sadf \-d /var/log/sa/sa21 \-\- \-r \-n DEV
استخراج آمارهای حافظه و شبکه از فایل فعالیت سیستم
.IR sa21
و نمایش آن‌ها در قالبی که بتواند توسط یک پایگاه داده دریافت شود.
.TP
.B sadf \-p \-P 1
استخراج آمارهای CPU برای پردازندهٔ ۱ (دومین پردازنده) از فایل داده‌های روزانهٔ جاری، و نمایش آن‌ها در قالبی که به‌راحتی توسط یک دستور پردازش الگو قابل مدیریت باشد.

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

.SH "نویسندگان (AUTHORS)"
Sebastien Godard (sysstat <at> orange.fr)

.SH "همچنین ببینید (SEE ALSO)"
.BR "sar" "(1), " "sadc" "(8), " "sa1" "(8), " "sa2" "(8), " "sysstat" "(5)"
.PP
.I https://github.com/sysstat/sysstat
.br
.I https://sysstat.github.io