====== SLOG - System/Node Statistics Log Viewer ======

The Synchronet ''slog'' utility prints the daily statistics history (logons, posts, e-mail, feedback, uploads, downloads, new users, etc.) recorded by Synchronet for either the system as a whole or for an individual [[:dir:node|node]].

Slog is ''[[:dir:exec]]/slog'' on *nix and ''[[:dir:exec]]/slog.exe'' on Windows.

The same functionality is available as a JavaScript module ''[[:dir:exec]]/slog.js'' (run via [[util:jsexec]]).

===== Usage =====
<code>
usage: slog [-opt [...]] [path]

 opts:
        -p[rows]  enable screen pause prompt
        -d<days>  specify maximum number of days
        -t        display totals
</code>

''path'' specifies the directory containing the ''csts.tab'' statistics file. If omitted, the ''SBBSCTRL'' [[:config:env|environment variable]] is used (the Synchronet ''[[:dir:ctrl]]'' directory). To view per-node statistics, pass the corresponding ''[[:dir:node]]'' directory as the path.

If the ''csts.tab'' file is not found at the resolved path, ''slog'' exits with an error.

===== Output Format =====
Each line begins with the date and a series of single-letter columns:

^ Field ^ Meaning ^
| ''T'' | Total minutes online that day |
| ''L'' | Logons |
| ''P'' | Posts |
| ''E'' | E-mails sent |
| ''F'' | Feedback messages sent |
| ''U'' | Upload bytes (estimated) / files |
| ''D'' | Download bytes (estimated) / files |
| ''N'' | New users created |

Example:
<code>
26/05/02 T:   73 L:  12 P:   5 E:  23 F:   7 U:   0M/0     D:  14G/39351  N:5
26/05/01 T:   37 L:  14 P:   3 E:   7 F:   3 U:   1M/2     D:  16G/79357  N:0
</code>

With ''-t'', a ''===TOTAL==='' summary is appended showing aggregate ''Time'', ''Logons'', ''Posts'', ''Email Sent'', ''Feedbacks'', ''New Users'', ''Uploads'', and ''Downloads'' across all displayed days.

The output may be redirected to a file for archival, e.g.:
<code>
slog > slog.txt
</code>

===== See Also =====
  * [[:util:|util index]]
  * [[:dir:ctrl]] (location of system ''csts.tab'')
  * [[:dir:node]] (per-node ''csts.tab'')
  * [[:monitor:statsfiles]]
  * [[:module:str_cmds|;SLOG / ;NS / ;NLOG sysop string commands]]

{{tag>slog statistics}}