from small one page howto to huge articles all in one place 
 
  
poll results
  Last additions:
  May 25th. 2007:
 
  April, 26th. 2006:
 
  |  
 You are here: manpages
 
 SYSLOG\-NG\-CTL
Section: The syslog-ng control tool man (1) Updated: 11/20/2016 Index
Return to Main Contents 
 
NAME
syslog-ng-ctl - Display message statistics and enable verbose, debug and trace modes in syslog-ng Open Source Edition
  
SYNOPSIS
- 
syslog-ng-ctl [command] [options]
  
 
DESCRIPTION
 NOTE: The syslog-ng-ctl application is distributed with the syslog-ng Open Source Edition system logging application, and is usually part of the syslog-ng package. The latest version of the syslog-ng application is available at
m[blue]the official syslog-ng websitem[][1].
This manual page is only an abstract; for the complete documentation of syslog-ng, see
m[blue]The syslog-ng Open Source Edition Administrator Guidem[][2].
 
The
syslog-ng-ctl
application is a utility that can be used to:
 
 - 
*
enable/disable various syslog-ng messages for troubleshooting;
  
 - 
*
display statistics about the processed messages.
  
 
ENABLING TROUBLESHOOTING MESSAGES
- 
command [options]
  
 Use the
syslog-ng-ctl <command> --set=on
command to display verbose, trace, or debug messages. If you are trying to solve configuration problems, the debug (and occassionally trace) messages are usually sufficient; debug messages are needed mostly for finding software errors. After solving the problem, do not forget to turn these messages off using the
syslog-ng-ctl <command> --set=off. Note that enabling debug messages does not enable verbose and trace messages.
Use
syslog-ng-ctl <command>
without any parameters to display whether the particular type of messages are enabled or not.
 
If you need to use a non-standard control socket to access syslog-ng, use the
syslog-ng-ctl <command> --set=on --control=<socket>
command to specify the socket to use.
 
verbose
 - 
Print verbose messages. If syslog-ng was started with the
--stderr
or
-e
option, the messages will be sent to stderr. If not specified, syslog-ng will log such messages to its internal source.
  
trace
 - 
Print trace messages of how messages are processed. If syslog-ng was started with the
--stderr
or
-e
option, the messages will be sent to stderr. If not specified, syslog-ng will log such messages to its internal source.
  
debug
 - 
Print debug messages. If syslog-ng was started with the
--stderr
or
-e
option, the messages will be sent to stderr. If not specified, syslog-ng will log such messages to its internal source.
  
Example:
 
 - 
syslog-ng-ctl verbose --set=on
 
  
 
THE STATS COMMAND
- 
stats [options]
  
 Use the
stats
command to display statistics about the processed messages. The
stats
command has the following options:
--control=<socket> or -c
 - 
Specify the socket to use to access syslog-ng. Only needed when using a non-standard socket.
  
Example:
 
 - 
syslog-ng-ctl stats
 
  
An example output:
 
 - 
src.internal;s_all#0;;a;processed;6445
src.internal;s_all#0;;a;stamp;1268989330
destination;df_auth;;a;processed;404
destination;df_news_dot_notice;;a;processed;0
destination;df_news_dot_err;;a;processed;0
destination;d_ssb;;a;processed;7128
destination;df_uucp;;a;processed;0
source;s_all;;a;processed;7128
destination;df_mail;;a;processed;0
destination;df_user;;a;processed;1
destination;df_daemon;;a;processed;1
destination;df_debug;;a;processed;15
destination;df_messages;;a;processed;54
destination;dp_xconsole;;a;processed;671
dst.tcp;d_network#0;10.50.0.111:514;a;dropped;5080
dst.tcp;d_network#0;10.50.0.111:514;a;processed;7128
dst.tcp;d_network#0;10.50.0.111:514;a;stored;2048
destination;df_syslog;;a;processed;6724
destination;df_facility_dot_warn;;a;processed;0
destination;df_news_dot_crit;;a;processed;0
destination;df_lpr;;a;processed;0
destination;du_all;;a;processed;0
destination;df_facility_dot_info;;a;processed;0
center;;received;a;processed;0
destination;df_kern;;a;processed;70
center;;queued;a;processed;0
destination;df_facility_dot_err;;a;processed;0
 
  
 
FILES
/usr/sbin/syslog-ng-ctl
 
 SEE ALSO
m[blue]The syslog-ng Administrator Guidem[][2]
 
syslog-ng.conf(5)
 
syslog-ng(8)
 
m[blue]The syslog-ng OSE 3.3 Administrator Guidem[][2]
 
If you experience any problems or need help with syslog-ng, visit
m[blue]visit the syslog-ng wikim[][3]
or the
m[blue]syslog-ng mailing listm[][4].
 
For news and notifications about of syslog-ng, visit the
m[blue]syslog-ng Insider Blogm[][5].
 
 AUTHOR
This manual page was written by the BalaBit Documentation Team <documentation@balabit.com>.
 
 COPYRIGHT
 
The authors grant permission to copy, distribute and/or modify this manual page under the terms of the GNU General Public License Version 2 or newer (GPL v2+).
 
 NOTES
-  1.
 - 
the official syslog-ng website
- 
http://www.balabit.com/network-security/syslog-ng/
  
 -  2.
 - 
           The syslog-ng Open Source Edition Administrator Guide
         
 - 
http://www.balabit.com/support/documentation/
  
 -  3.
 - 
visit the syslog-ng wiki
- 
http://www.balabit.com/wiki/syslog-ng-faq
  
 -  4.
 - 
syslog-ng mailing list
- 
https://lists.balabit.hu/mailman/listinfo/syslog-ng
  
 -  5.
 - 
syslog-ng Insider Blog
- 
http://insider.blogs.balabit.com
  
   
 
 Index
- NAME
 - 
 - SYNOPSIS
 - 
 - DESCRIPTION
 - 
 - ENABLING TROUBLESHOOTING MESSAGES
 - 
 - THE STATS COMMAND
 - 
 - FILES
 - 
 - SEE ALSO
 - 
 - AUTHOR
 - 
 - COPYRIGHT
 - 
- 
  
 - NOTES
 - 
  
 
 
 
 
  |