pmg-log-tracker.adoc

   1 [[chapter_pmg-log-tracker]]
   2 ifndef::manvolnum[]
   3 pmg-log-tracker - Backend for the Tracking Center
   4 =================================================
   5 :pmg-toplevel:
   6 endif::manvolnum[]
   7
   8 `pmg-log-tracker` is the backend for the Tracking Center. It parses the syslog
   9 files in `/var/log/` for mail information. You can specify a different file to
  10 parse, for example the mail log `/var/log/mail.log`, using the `-i` option.
  11
  12 As an example, parsing the mail.log file for everything between the 1st and 15th
  13 of July would be possible with the following command:
  14 ----
  15 pmg-log-tracker -i /var/log/mail.log -s "2021-07-01 00:00:00" -e "2021-07-15 23:59:59"
  16 ----
  17
  18 Start time `-s` and end time `-e` are optional. By default the end time will be
  19 the current time and the start time will be 0:00 of the current day.
  20
  21 With the `--verbose` option, additional info will be printed, such as the
  22 complete log for every mail.
  23
  24 It is also possible to filter the log entries based on hostname, from address,
  25 to address, and other parameters. For a complete overview of all available
  26 options, see `pmg-log-tracker --help`.
  27
  28 As a side effect of parsing the syslog, which doesn't contain information about
  29 the year of the entries, the year passed to the `-s` and `-e` options has to
  30 be the current one, rather than the one in which the logs were actually created.
  31
  32
  33 ifdef::manvolnum[]
  34 include::pmg-copyright.adoc[]
  35 endif::manvolnum[]
  36