tstatd - Logs real-time accounting daemon
SYNOPSIS
tstatd [ options ] plugin [zone1:]wildcard1 ..
[zoneN:]wildcardN
OPTIONS
- -a zone, --agregate-zone=zone
- Agregate data from all anonymous logs (wildcards without explicit zone
specified) into zone. Default behavior is to create new zone for
each anonymous log from its file name.
- -b file, --database-file=file
- Use file as persistent storage to keep accumulated data across
daemon restarts. Default is auto generated from daemon name, specified
identity and '.db' suffix.
- --basename
- Use only base name (excluding directories and suffix) of anonymous log
file for auto-created zones.
- -c dir, --change-dir=dir
- Change current directory to dir before wildcards expanding.
- -d, --debug
- Composition of options: "--foreground"
and "--log-level=debug".
- -f, --foreground
- Don't detach daemon from control terminal, logging to
"stderr" instead log file or
syslog.
- --log-facility=name
- Use name as "facility" for syslog
logging (see syslog (3) for list of available values). Default is
'daemon'.
- --log-level=level
- Set minimal logging level to level (see syslog (3) for list of
available values). Default is 'notice'.
- --log-file=file
- Use logging to file instead of syslog logging (which is
default).
- -e num, --expand-period=num
- Do wildcards re-expanding and checking for new and missed logs every
num seconds. Default is '60'.
- -h, --help
- Print brief help message about available options.
- -i string, --identity=string
- Just a string used in title of daemon process, syslog ident (see
syslog(3)), "--database-file" and
"--pid-file". Idea behind this options -
multiple "tstatd" instances running
simultaneosly.
- -l [address:]port,
--listen=[address:]port
- Specify address and port for TCP listen socket binding.
Default is '127.0.0.1:3638'.
- --multiple
- With this option specified same log file could be included into several
zones (if log name satisifies several wildcards). Default behavior is to
include log file only in first satisified zone.
- -n num, --windows-num=num
- Set number of sliding-windows to num. Default is '60'.
- -o string, --options=string
- Comma-separated plugin supported options (like a mount (8) options).
- --override-from=file
- Load content of file into plugin package namespace. This is way to
easy customize plugin behavior without creating another plugin.
- -p file, --pid-file=file
- Use file to keep daemon process id. Default is auto generated from
daemon name, specified identity and '.pid' suffix.
- --parse-error=level
- Do logging with level (see syslog (3) for available values) about
all unparsed log lines. Hint: use 'none' for ignoring such lines. Default
is defining by plugin and usually is 'debug'.
- -r pattern, --regex=pattern
- Use pattern instead of plugin default regular expression for
matching log lines.
- --regex-from=file
- Load regular expression from file and use instead of plugin default
regular expression for matching log lines.
- -s num, --store-period=num
- Store accumulated data in a persistent storage every num seconds.
Default is '60'.
- --timer=zone:timer:num
- Create named timer firing every num seconds for
zone.
- -u <user>, --user=user
- Change effective privileges of daemon process to user.
- -v, --version
- Print version information of "tstatd"
and exit.
- -w num, --window-size=<num>
- Set size (duration) of sliding window to num seconds. Default is
'10'.
Oleg A. Mamontov, "<oleg@mamontov.net>"
This program is free software; you can redistribute it and/or modify it under
the terms of either: the GNU General Public License as published by the Free
Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.