systemd-report - تولید
گزارش از
معیارهای
سیستم
systemd-report [OPTIONS...]
توجه: این
دستور در
حال حاضر
آزمایشی
است. اگرچه
احتمالاً
به یک مؤلفه
دائمی از systemd
تبدیل
خواهد شد،
اما همچنان
ممکن است
رفتار و
رابط آن
تغییر کند.
systemd-report
معیارها را
از سیستم
درخواست
کرده و
آنها را در
خروجی
استاندارد
مینویسد.
فرمانهای
زیر
پشتیبانی
میشوند:
metrics [MATCH...]
فهرستی
از مقادیر
معیارها را
از تمام
سرویسهای
محلی
ارائهدهنده
آنها
دریافت
کرده و در
خروجی
استاندارد
مینویسد.
به صورت
اختیاری یک
یا چند
عبارت
تطبیق را
برای فیلتر
کردن
معیارهای
نمایشی
میپذیرد.
این عبارت
میتواند
نام دقیق یک
خانواده
معیار برای
جستجو یا
پیشوندی از
آن باشد (که
فقط در
مرزهای
نقطه تطبیق
داده
میشود). اگر
چندین
تطبیق به
عنوان چند
پارامتر
مشخص شوند،
هر معیاری
که با
هر یک
از
تطبیقهای
مشخصشده
مطابقت
داشته باشد
نمایش داده
میشود.
در نسخه 260
اضافه شد.
describe [MATCH...]
فهرستی
از
خانوادههای
معیار را از
تمام
سرویسهای
محلی
ارائهدهنده
آنها
دریافت
کرده و در
خروجی
استاندارد
مینویسد.
این فرمان
عمدتاً
اطلاعات
ایستای
مربوط به
معیارها،
انواع داده
آنها و
توضیحات
خوانا برای
انسان را
بدون
مقادیر
برمیگرداند.
عبارتهای
تطبیق
پشتیبانیشده
توسط metrics
توسط describe نیز
پشتیبانی
میشوند.
در نسخه 260
اضافه شد.
generate [MATCH...]
فهرستی
از معیارها
را دریافت
کرده و یک
گزارش JSON
ایجاد
میکند.
عبارتهای
تطبیق
پشتیبانیشده
توسط metrics در
اینجا نیز
پشتیبانی
میشوند.
در نسخه 261
اضافه شد.
upload [MATCH...]
این
فرمان
میتواند
برای ارسال
گزارش
ایجادشده
توسط
generate به
یک کارساز
خارجی
استفاده
شود. دو
سازوکار
بارگذاری
پشتیبانی
میشود. اگر
یک نشانی وب
"http://" یا "https://" با
--url= مشخص
شود، یک
بارگذاری HTTP
به مکان
مشخصشده
انجام
خواهد شد. در
غیر این
صورت، از هر
سوکتی در
/run/systemd/report.upload/ برای
فراخوانی
io.systemd.Report.Uploader.Upload()
استفاده
خواهد شد.
عبارتهای
تطبیق
پشتیبانیشده
توسط metrics در
اینجا نیز
پشتیبانی
میشوند.
در نسخه 261
اضافه شد.
list-sources
فهرست
منابع
معیار
شناختهشده
را نمایش
میدهد.
در نسخه 260
اضافه شد.
گزینههای
زیر
پشتیبانی
میشوند:
--system, --user
پرسوجو
از منابع
معیارهای
سراسر
سیستم
(پیشفرض)،
یا منابع
معیارهای
به ازای هر
کاربر.
در نسخه 260
اضافه شد.
--no-pager
خروجی را
به یک
صفحهبند (pager)
هدایت
نمیکند.
--json=MODE
خروجی را
در قالب JSON
نمایش
میدهد. یکی
از مقادیر
زیر را
میپذیرد:
"short" (برای
کوتاهترین
خروجی ممکن
بدون
هیچگونه
فضای خالی
اضافی یا
شکست خط)، "pretty"
(برای نسخه
زیباسازیشده
همان
خروجی،
همراه با
تورفتگی و
شکست خط) یا
"off" (برای
خاموش کردن
خروجی JSON، که
حالت
پیشفرض
است).
-j
در صورت
اجرا در
ترمینال
معادل --json=pretty و
در غیر این
صورت معادل
--json=short است.
--no-legend
راهنما
(legend)، یعنی
سرستونها
و پاورقی
حاوی نکات
را چاپ
نمیکند.
-h, --help
یک متن
راهنمای
کوتاه را
چاپ کرده و
خارج
میشود.
--version
یک رشته
کوتاه نسخه
را چاپ کرده
و خارج
میشود.
--url=URL
گزارش
جمعآوریشده
را به جای
نوشتن در
خروجی
استاندارد،
به نشانی
مشخصشده
بارگذاری
میکند.
URL
باید به
کارسازی
اشاره کند
که
درخواستهای
POST حاوی بدنه
گزارش با
قالب JSON را
میپذیرد.
توجه:
نشانیهای
وب "http://" و "https://"
هر دو
پشتیبانی
میشوند،
اما
اتصالات از
طریق HTTP ساده
بدون
رمزگذاری
برقرار
میشوند.
بنابراین،
این حالت
فقط باید در
شرایط خاصی
استفاده
شود که
یکپارچگی و
محرمانگی
گزارش
الزامی
نبوده یا از
طریق
روشهای
دیگر تضمین
شده باشد.
استفاده از
"https://" توصیه
میشود.
در نسخه 261
اضافه شد.
--key=FILENAME
مسیری به
یک فایل
کلید SSL با
قالب PEM
دریافت
میکند که
برای احراز
هویت گواهی
کلاینت
هنگام
بارگذاری
استفاده
میشود.
همچنین
میتواند
روی "-"
تنظیم شود
تا احراز
هویت گواهی
کلاینت
غیرفعال
گردد. مقدار
پیشفرض
/etc/ssl/private/systemd-report.pem است.
در نسخه 261
اضافه شد.
--cert=FILENAME
مسیری به
یک فایل
گواهی SSL با
قالب PEM
دریافت
میکند که
برای احراز
هویت گواهی
کلاینت
هنگام
بارگذاری
استفاده
میشود.
مقدار
پیشفرض
/etc/ssl/certs/systemd-report.pem است.
در نسخه 261
اضافه شد.
--trust=FILENAME|all
مسیری به
یک فایل
گواهی مرجع
گواهی (CA)
اساسال
با قالب PEM
دریافت
میکند که
برای
اعتبارسنجی
گواهی
کارساز
استفاده
میشود، یا
رشته لفظی
all
برای
غیرفعال
کردن کامل
بررسی
گواهی.
مقدار
پیشفرض
/etc/ssl/ca/trusted.pem است.
در نسخه 261
اضافه شد.
--network-timeout=SEC
مدت زمان
انتظار
(تایماوت)
برای
عملیات
بارگذاری
شبکه.
مقداری بر
حسب ثانیه
(یا در صورت
داشتن
پسوندهایی
مانند "ms"،
"min"، "h" و
غیره با
سایر
واحدهای
زمانی)
میپذیرد؛
برای
جزئیات
systemd.time(7)
را ببینید.
مقدار
پیشفرض ۳۰
ثانیه است.
در نسخه 261
اضافه شد.
--extra-header=NAME:
VALUE
یک هدر HTTP
اضافی را به
درخواست
بارگذاری
تزریق
میکند.
میتواند
چندین بار
برای
افزودن
چندین هدر
مشخص شود.
ارسال یک
رشته خالی
تمام
هدرهای
اضافهشده
توسط
کاربردهای
قبلی
--extra-header= را
پاک میکند.
در نسخه 261
اضافه شد.
در صورت
موفقیت، 0
برگردانده
میشود؛ در
غیر این
صورت یک کد
خطای غیر
صفر
برگردانده
خواهد شد.
