NAME

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'.

SEE ALSO

Tail::Stat

AUTHOR

Oleg A. Mamontov, "<oleg@mamontov.net>"

COPYRIGHT & LICENSE

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.