.TH syslog\-ng\-ctl 1 "18 December 2025" 4.10.2 "The syslog\-ng OSE control tool manual page"
.SH "نام (NAME)"
syslog\-ng\-ctl \- نمایش آمار پیام‌ها و فعال‌سازی حالت‌های پرگویی (verbose)، اشکال‌زدایی (debug) و ردگیری (trace) در syslog\-ng OSE
.SH "خلاصه دستور (SYNOPSIS)"
.PP
syslog\-ng\-ctl [command] [options]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBیادداشت:\fP برنامه
.B syslog\-ng\-ctl
به همراه برنامه ثبت رویداد سیستمی syslog\-ng OSE توزیع می‌شود و معمولاً بخشی از بسته syslog\-ng OSE است. آخرین نسخه برنامه syslog\-ng OSE در صفحه وب syslog\-ng OSE در دسترس است.
.PP
این صفحه راهنما صرفاً یک چکیده است.
.PP
برنامه
.B syslog\-ng\-ctl
ابزاری است که می‌تواند برای موارد زیر استفاده شود:
.RS
.IP \(bu 2
فعال یا غیرفعال کردن پیام‌های گوناگون syslog\-ng OSE جهت عیب‌یابی
.IP \(bu 2
نمایش آمار درباره پیام‌های پردازش‌شده
.IP \(bu 2
مدیریت کلیدهای خصوصی محافظت‌شده با گذرواژه
.IP \(bu 2
نمایش پیکربندی در حال اجرای فعلی syslog\-ng OSE
.IP \(bu 2
بارگذاری مجدد پیکربندی syslog\-ng OSE.
.RE
.SH "فعال‌سازی پیام‌های عیب‌یابی (ENABLE TROUBLESHOOTING MESSAGES)"
.PP
command [options]
.PP
برای نمایش پیام‌های پرگویی (verbose)، ردگیری (trace) یا اشکال‌زدایی (debug) از دستور
.B syslog\-ng\-ctl <command> \-\-set=on
استفاده کنید. اگر در تلاش برای حل مشکلات پیکربندی هستید، پیام‌های verbose (و گهگاه trace) معمولاً کافی هستند. پیام‌های debug بیشتر برای یافتن خطاهای نرم‌افزاری نیاز می‌شوند. پس از حل مشکل، فراموش نکنید که این پیام‌ها را با استفاده از دستور
.B syslog\-ng\-ctl <command> \-\-set=off
خاموش کنید. توجه داشته باشید که فعال‌سازی پیام‌های debug باعث فعال شدن پیام‌های verbose و trace نمی‌شود.
.PP
برای نمایش فعال یا غیرفعال بودن نوع خاصی از پیام‌ها، دستور
.B syslog\-ng\-ctl <command>
را بدون هیچ پارامتری اجرا کنید.
.PP
اگر برای دسترسی به syslog\-ng OSE نیاز به استفاده از یک سوکت کنترلی غیراستاندارد دارید، از دستور
.B syslog\-ng\-ctl <command> \-\-set=on \-\-control=<socket>
برای تعیین سوکت مورد استفاده استفاده کنید.
.RS
.IP \(bu 2
verbose
.PP
چاپ پیام‌های پرگویی (verbose). اگر syslog\-ng OSE با گزینه
.B \-\-stderr
یا
.B \-e
شروع شده باشد، پیام‌ها به stderr فرستاده خواهند شد. در غیر این صورت، syslog\-ng OSE این پیام‌ها را در منبع داخلی خود ثبت می‌کند.
.IP \(bu 2
trace
.PP
چاپ پیام‌های ردگیری (trace) از چگونگی پردازش پیام‌ها. اگر syslog\-ng OSE با گزینه
.B \-\-stderr
یا
.B \-e
شروع شده باشد، پیام‌ها به stderr فرستاده خواهند شد. در غیر این صورت، syslog\-ng OSE این پیام‌ها را در منبع داخلی خود ثبت می‌کند.
.IP \(bu 2
debug
.PP
چاپ پیام‌های اشکال‌زدایی (debug). اگر syslog\-ng OSE با گزینه
.B \-\-stderr
یا
.B \-e
شروع شده باشد، پیام‌ها به stderr فرستاده خواهند شد. در غیر این صورت، syslog\-ng OSE این پیام‌ها را در منبع داخلی خود ثبت می‌کند.
.RE
.SS "مثال (EXAMPLE)"
.PP
.RS
.nf
syslog\-ng\-ctl verbose \-\-set=on
.fi
.RE
.SH "پرس‌وجو (syslog\-ng\-ctl query)"
.PP
برنامه syslog\-ng OSE داده‌ها، معیارها و آمارهای گوناگون را در یک جدول درهم‌سازی (هش) ذخیره می‌کند. هر ویژگی دارای یک نام و یک مقدار است. برای نمونه:
.PP
.RS
.nf
[syslog\-ng]
|
|_[destinations]\-[network]\-[tcp]\->[stats]\->{received=12;dropped=2}
|
|_[sources]\-[sql]\-[stats]\->{received=501;dropped=0}
.fi
.RE
.PP
شما می‌توانید گره‌های این درخت را پرس‌وجو کنید و همچنین از پالایه‌ها (فیلترها) برای انتخاب اطلاعات مورد نیاز خود بهره ببرید. یک پرس‌وجو در واقع مسیری در این درخت است. شما همچنین می‌توانید از نویسه‌های عام (wildcard) ? و * استفاده کنید. برای نمونه:
.RS
.IP \(bu 2
انتخاب همه ویژگی‌ها: *
.IP \(bu 2
انتخاب تمام مقادیر dropped از هر گره stats: *\&.stats.dropped
.RE
.PP
گره‌ها و ویژگی‌های موجود در درخت به پیکربندی syslog\-ng OSE شما (یعنی منابع، مقصدها و دیگر اشیایی که پیکربندی کرده‌اید) و همچنین به تنظیمات stats\-level() شما بستگی دارند.
.SH "دستور LIST (THE LIST COMMAND)"
.PP
syslog\-ng\-ctl query list
.PP
از دستور
.B syslog\-ng\-ctl query list
برای نمایش فهرست معیارهایی که syslog\-ng OSE درباره پیام‌های پردازش‌شده گردآوری می‌کند استفاده کنید.
.PP
یک نمونه خروجی:
.PP
.RS
center.received.stats.processed
center.queued.stats.processed
destination.d\fIelastic.stats.processed
source.s\fPtcp.stats.processed
source.severity.7.stats.processed
source.severity.0.stats.processed
source.severity.1.stats.processed
source.severity.2.stats.processed
source.severity.3.stats.processed
source.severity.4.stats.processed
source.severity.5.stats.processed
source.severity.6.stats.processed
source.facility.7.stats.processed
source.facility.16.stats.processed
source.facility.8.stats.processed
source.facility.17.stats.processed
source.facility.9.stats.processed
source.facility.18.stats.processed
source.facility.19.stats.processed
source.facility.20.stats.processed
source.facility.0.stats.processed
source.facility.21.stats.processed
source.facility.1.stats.processed
source.facility.10.stats.processed
source.facility.22.stats.processed
source.facility.2.stats.processed
source.facility.11.stats.processed
source.facility.23.stats.processed
source.facility.3.stats.processed
source.facility.12.stats.processed
source.facility.4.stats.processed
source.facility.13.stats.processed
source.facility.5.stats.processed
source.facility.14.stats.processed
source.facility.6.stats.processed
source.facility.15.stats.processed
source.facility.other.stats.processed
global.payload\fIreallocs.stats.processed
global.msg\fPclones.stats.processed
global.sdata\fIupdates.stats.processed
tag..source.s\fPtcp.stats.processed
.RE
.PP
دستور
.B syslog\-ng\-ctl query list
دارای گزینه‌های زیر است:
.RS
.IP \(bu 2
\-\-reset
.PP
برای صفر کردن شمارنده‌های انتخاب‌شده پس از اجرای پرس‌وجو، از
.B \-\-reset
استفاده کنید.
.RE
.SH "نمایش معیارها و آمارها (DISPLAYING METRICS AND STATISTICS)"
.PP
syslog\-ng\-ctl query get [options]
.PP
دستور
.B syslog\-ng\-ctl query get <query>
گره‌های منطبق با پرس‌وجو و مقادیر آن‌ها را فهرست می‌کند.
.PP
برای نمونه، پرس‌وجوی destination مقصدهای پیکربندی‌شده و معیارهای مرتبط با هر مقصد را فهرست می‌کند. یک نمونه خروجی:
.PP
.RS
destination.d_elastic.stats.processed=0
.RE
.PP
دستور
.B syslog\-ng\-ctl query get
دارای گزینه‌های زیر است:
.PP
\fB\fC\-\-sum\fR
    جمع بستن نتیجه هر گره منطبق و بازگرداندن تنها یک عدد تکی. برای نمونه، دستور \fB\fCsyslog\-ng\-ctl query get \-\-sum "destination*.dropped"\fR تعداد پیام‌های دور ریخته‌شده (dropped) توسط نمونه syslog\-ng OSE را نمایش می‌دهد.
.PP
\fB\fC\-\-reset\fR
    استفاده از \fB\fC\-\-reset\fR برای تنظیم شمارنده‌های انتخاب‌شده به \fB\fC0\fR پس از اجرای پرس‌وجو.
.SH "دستور STATS (THE STATS COMMAND)"
.PP
.RS
.nf
stats [options]
.fi
.RE
.PP
از دستور
.B stats
برای نمایش آمار درباره پیام‌های پردازش‌شده استفاده کنید. برای جزئیات پیرامون آمارهای نمایش‌داده‌شده، به راهنمای مدیریت syslog\-ng OSE مراجعه کنید.
دستور
.B stats
دارای گزینه‌های زیر است:
.PP
\fB\fC\-\-control=<socket>\fR یا \fB\fC\-c\fR
    مشخص کردن سوکت مورد استفاده برای دسترسی به syslog\-ng OSE. تنها هنگام استفاده از یک سوکت غیراستاندارد مورد نیاز است.
.PP
\fB\fC\-\-reset=<socket>\fR یا \fB\fC\-r\fR
    صفر کردن تمام آمارها، به جز شمارنده‌های صف (queued). (شمارنده‌های در صف، تعداد پیام‌های موجود در صف پیام گرداننده مقصد را نشان می‌دهند که در انتظار ارسال به مقصد هستند.)
.PP
\fB\fC\-\-remove\-orphans\fR
    حذف ایمن تمام شمارنده‌هایی که توسط هیچ‌یک از اشیای تولیدکننده آمار syslog\-ng ارجاع داده نشده‌اند.
.PP
.RS
.nf
این فلگ می‌تواند برای هرس کردن دستی شمارنده‌های پویا و ایستا استفاده شود.
این ویژگی مفید است، برای نمونه هنگامی که یک مقصد فایل قالب‌بندی‌شده آمار زیادی تولید می‌کند:

>dst.file;#anon\-destination0#0;/tmp/2021\-08\-16.log;o;processed;253592
>dst.file;#anon\-destination0#0;/tmp/2021\-08\-17.log;o;processed;156
>dst.file;#anon\-destination0#0;/tmp/2021\-08\-18.log;a;processed;961

\fBیادداشت:\fP گزینه stats(lifetime()) می‌تواند برای انجام خودکار و دوره‌ای
همین کار استفاده شود، اما در حال حاضر stats(lifetime()) تنها شمارنده‌های
پویایی را حذف می‌کند که فیلد برچسب زمانی (timestamp) برای آن‌ها تنظیم شده باشد.
.fi
.RE
.SS "مثال: STATS (EXAMPLE: STATS)"
.PP
.RS
.nf
syslog\-ng\-ctl stats
.fi
.RE
.PP
یک نمونه خروجی:
.PP
.RS
src.internal;s\fIall#0;;a;processed;6445
src.internal;s\fPall#0;;a;stamp;1268989330
destination;df\fIauth;;a;processed;404
destination;df\fPnews\fIdot\fPnotice;;a;processed;0
destination;df\fInews\fPdot\fIerr;;a;processed;0
destination;d\fPssb;;a;processed;7128
destination;df\fIuucp;;a;processed;0
source;s\fPall;;a;processed;7128
destination;df\fImail;;a;processed;0
destination;df\fPuser;;a;processed;1
destination;df\fIdaemon;;a;processed;1
destination;df\fPdebug;;a;processed;15
destination;df\fImessages;;a;processed;54
destination;dp\fPxconsole;;a;processed;671
dst.tcp;d\fInetwork#0;10.50.0.111:514;a;dropped;5080
dst.tcp;d\fPnetwork#0;10.50.0.111:514;a;processed;7128
dst.tcp;d\fInetwork#0;10.50.0.111:514;a;queued;2048
destination;df\fPsyslog;;a;processed;6724
destination;df\fIfacility\fPdot\fIwarn;;a;processed;0
destination;df\fPnews\fIdot\fPcrit;;a;processed;0
destination;df\fIlpr;;a;processed;0
destination;du\fPall;;a;processed;0
destination;df\fIfacility\fPdot\fIinfo;;a;processed;0
center;;received;a;processed;0
destination;df\fPkern;;a;processed;70
center;;queued;a;processed;0
destination;df\fIfacility\fPdot_err;;a;processed;0
.RE
.SH "مدیریت کلیدهای خصوصی محافظت‌شده با گذرواژه (HANDLING PASSWORD\-PROTECTED PRIVATE KEYS)"
.PP
syslog\-ng\-ctl credentials [options]
.PP
دستور
.B syslog\-ng\-ctl credentials status
به شما امکان می‌دهد وضعیت کلیدهای خصوصی را که syslog\-ng OSE در گرداننده‌های network() و syslog() استفاده می‌کند، پرس‌وجو کنید. همچنین می‌توانید با استفاده از دستور
.B syslog\-ng\-ctl credentials add
عبارت عبور (passphrase) کلیدهای خصوصی محافظت‌شده با گذرواژه را ارائه دهید. برای جزئیات پیرامون استفاده از کلیدهای محافظت‌شده با گذرواژه، به راهنمای مدیریت syslog\-ng OSE مراجعه کنید.
.SH "نمایش وضعیت کلیدهای خصوصی (DISPLAYING THE STATUS OF PRIVATE KEYS)"
.PP
syslog\-ng\-ctl credentials status [options]
.PP
دستور
.B syslog\-ng\-ctl credentials status
به شما امکان می‌دهد وضعیت کلیدهای خصوصی مورد استفاده syslog\-ng OSE در گرداننده‌های network() و syslog() را پرس‌وجو کنید. این دستور فهرست کلیدهای خصوصی استفاده‌شده و وضعیت آن‌ها را بازمی‌گرداند. برای نمونه:
.PP
.RS
.nf
syslog\-ng\-ctl credentials status
.fi
.RE
.PP
.RS
Secret store status:
/home/user/ssl_test/client\-1/client\-encrypted.key SUCCESS
.RE
.PP
اگر وضعیت یک کلید PENDING باشد، باید عبارت عبور آن کلید را ارائه دهید، در غیر این صورت syslog\-ng OSE نمی‌تواند از آن استفاده کند. منابع و مقصدهایی که از این کلیدها استفاده می‌کنند تا زمانی که گذرواژه‌ها را ارائه ندهید کار نخواهند کرد. سایر بخش‌های پیکربندی syslog\-ng OSE دست‌نخورده باقی خواهند ماند. شما باید عبارت عبور کلیدهای محافظت‌شده با گذرواژه را در هر بار راه‌اندازی مجدد syslog\-ng OSE وارد کنید.
.PP
پیام ثبت رویداد (log) زیر نیز شما را از عبارت‌های عبور PENDING آگاه می‌کند:
.PP
.RS
Waiting for password; keyfile='private.key'
.RE
.PP
\fB\fC\-\-control=<socket>\fR یا \fB\fC\-c\fR
.PP
.RS
.nf
تعیین سوکت مورد استفاده برای دسترسی به syslog\-ng OSE. تنها در صورت استفاده از یک سوکت غیراستاندارد مورد نیاز است.
.fi
.RE
.SH "باز کردن کلیدهای خصوصی محافظت‌شده با گذرواژه (OPENING PASSWORD\-PROTECTED PRIVATE KEYS)"
.PP
syslog\-ng\-ctl credentials add [options]
.PP
می‌توانید با استفاده از دستور زیر، عبارت عبور را به فایل کلید خصوصی محافظت‌شده با گذرواژه اضافه کنید. syslog\-ng OSE اعلانی را برای ورود عبارت عبور نمایش می‌دهد. توصیه ما استفاده از این روش است.
.PP
.RS
.nf
syslog\-ng\-ctl credentials add \-\-id=<path\-to\-the\-key>
.fi
.RE
.PP
همچنین می‌توانید عبارت عبور را در پارامتر \-\-secret قرار دهید:
.PP
.RS
.nf
syslog\-ng\-ctl credentials add \-\-id=<path\-to\-the\-key> \-\-secret=<passphrase\-of\-the\-key>
.fi
.RE
.PP
یا می‌توانید عبارت عبور را به دستور syslog\-ng\-ctl هدایت (pipe) کنید، برای نمونه:
.PP
.RS
.nf
echo "<passphrase\-of\-the\-key>" | syslog\-ng\-ctl credentials add \-\-id=<path\-to\-the\-key>
.fi
.RE
.PP
\fB\fC\-\-control=<socket>\fR یا \fB\fC\-c\fR
    تعیین سوکت مورد استفاده برای دسترسی به syslog\-ng OSE. تنها هنگام استفاده از یک سوکت غیراستاندارد نیاز است.
.PP
\fB\fC\-\-id=<path\-to\-the\-key>\fR یا \fB\fC\-i\fR
    مسیر فایل کلید خصوصی محافظت‌شده با گذرواژه. این همان مسیری است که در گزینه key\-file() فایل پیکربندی syslog\-ng OSE استفاده می‌کنید.
.PP
\fB\fC\-\-secret=<passphrase\-of\-the\-key>\fR یا \fB\fC\-s\fR
    گذرواژه یا عبارت عبور کلید خصوصی.
.SH "نمایش پیکربندی (DISPLAYING THE CONFIGURATION)"
.PP
syslog\-ng\-ctl config [options]
.PP
از دستور
.B syslog\-ng\-ctl config
برای نمایش پیکربندی که syslog\-ng OSE هم‌اکنون با آن در حال اجراست استفاده کنید. توجه داشته باشید که به طور پیش‌فرض، تنها محتوای فایل پیکربندی اصلی نمایش داده می‌شود و فایل‌های گنجانده‌شده (included) حل‌وفصل نمی‌شوند. برای حل‌وفصل فایل‌های گنجانده‌شده و نمایش کامل پیکربندی، از دستور
.B syslog\-ng\-ctl config \-\-preprocessed
استفاده کنید.
.SH "بارگذاری مجدد پیکربندی (RELOADING THE CONFIGURATION)"
.PP
syslog\-ng\-ctl reload [options]
.PP
از دستور
.B syslog\-ng\-ctl reload
برای بارگذاری مجدد فایل پیکربندی syslog\-ng OSE بدون نیاز به راه‌اندازی مجدد برنامه syslog\-ng OSE استفاده کنید. عملکرد
.B syslog\-ng\-ctl reload
مشابه سیگنال SIGHUP است.
.PP
دستور
.B syslog\-ng\-ctl reload
در صورت موفقیت‌آمیز بودن عملیات 0 و در غیر این صورت 1 برمی‌گرداند.
.SH "فایل‌ها (FILES)"
.PP
/Users/hofi/Develop/Balabit/syslog-ng/build/install/sbin/syslog\-ng\-ctl
.PP
\fBیادداشت:\fP
اگر با مشکلی مواجه شدید یا نیاز به راهنمایی در مورد syslog\-ng OSE دارید، به \fIsyslog\-ng OSE Administration Guide\fP[1] مراجعه کنید، یا به \fIsyslog\-ng OSE mailing list\fP[2] سر بزنید.
برای اخبار و اعلان‌های مربوط به syslog\-ng OSE، از \fIsyslog\-ng OSE blogs\fP[3] دیدن کنید.
.SH "نویسنده (AUTHOR)"
.PP
این صفحه راهنما از روی \fIsyslog\-ng OSE Administration Guide\fP[1] تولید شده است که توسط چندین مشارکت‌کننده نوشته شده است و صمیمانه از آن‌ها سپاسگزاری می‌کنیم.
.SH "حق نشر (COPYRIGHT)"
.SH "نکات (NOTES)"
.PP
[1] \fB\fCsyslog\-ng OSE Administration Guide\fR
    \[la]https://syslog-ng.github.io/admin-guide/README\[ra]
.PP
[2] \fB\fCsyslog\-ng OSE mailing list\fR
    \[la]https://lists.balabit.hu/mailman/listinfo/syslog-ng\[ra]
.PP
[3] \fB\fCsyslog\-ng OSE blogs\fR
    \[la]https://syslog-ng.com/blog\[ra]