proxmox-mirrors/pmg-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pmg-docs synced 2025-08-11 12:20:02 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

add documentation for the pmg-log-tracker

Browse Source 
The Tracking Center makes assumptions which are working fine for most of
the users, but not for some.
It might be useful for some users to know that this exists and is the
backend for the Tracking Center.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
This commit is contained in:
Mira Limbeck 2021-08-24 11:33:13 +02:00 committed by Stoiko Ivanov
parent 99c4f2cd56
commit 00dbdd0525
2 changed files with 38 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
pmg-admin-guide.adoc
View File

@ -79,6 +79,8 @@ include::pmgreport.adoc[]
include::pmgupgrade.adoc[]
include::pmg-log-tracker.adoc[]
:leveloffset: 1
include::nmap.adoc[]

36
pmg-log-tracker.adoc Normal file
View File

@ -0,0 +1,36 @@
[[chapter_pmg-log-tracker]]
ifndef::manvolnum[]
pmg-log-tracker - Backend for the Tracking Center
=================================================
:pmg-toplevel:
endif::manvolnum[]
`pmg-log-tracker` is the backend for the Tracking Center. It parses the syslog
files in `/var/log/` for mail information. You can specify a different file to
parse, for example the mail log `/var/log/mail.log`, using the `-i` option.
As an example, parsing the mail.log file for everything between the 1st and 15th
of July would be possible with the following command:
----
pmg-log-tracker -i /var/log/mail.log -s "2021-07-01 00:00:00" -e "2021-07-15 23:59:59"
----
Start time `-s` and end time `-e` are optional. By default the end time will be
the current time and the start time will be 0:00 of the current day.
With the `--verbose` option, additional info will be printed, such as the
complete log for every mail.
It is also possible to filter the log entries based on hostname, from address,
to address, and other parameters. For a complete overview of all available
options, see `pmg-log-tracker --help`.
As a side effect of parsing the syslog, which doesn't contain information about
the year of the entries, the year passed to the `-s` and `-e` options has to
be the current one, rather than the one in which the logs were actually created.
ifdef::manvolnum[]
include::pmg-copyright.adoc[]
endif::manvolnum[]