[pmg-devel] applied: [PATCH v2 pmg-docs 2/2] add documentation for the pmg-log-tracker

[Stoiko Ivanov]

huge thanks for the work and the review

applied

On Tue, 24 Aug 2021 11:33:13 +0200
Mira Limbeck <m.limbeck at proxmox.com> wrote:

> 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 at proxmox.com>
> ---
> v2:
>  - reworded based on Dylan's suggestions
>  - removed reference to pmg-log-tracker manpage which doesn't yet exist
> 
>  pmg-admin-guide.adoc |  2 ++
>  pmg-log-tracker.adoc | 36 ++++++++++++++++++++++++++++++++++++
>  2 files changed, 38 insertions(+)
>  create mode 100644 pmg-log-tracker.adoc
> 
> diff --git a/pmg-admin-guide.adoc b/pmg-admin-guide.adoc
> index 043b94a..5ca2b0c 100644
> --- a/pmg-admin-guide.adoc
> +++ b/pmg-admin-guide.adoc
> @@ -79,6 +79,8 @@ include::pmgreport.adoc[]
>  
>  include::pmgupgrade.adoc[]
>  
> +include::pmg-log-tracker.adoc[]
> +
>  :leveloffset: 1
>  
>  include::nmap.adoc[]
> diff --git a/pmg-log-tracker.adoc b/pmg-log-tracker.adoc
> new file mode 100644
> index 0000000..3be58a8
> --- /dev/null
> +++ b/pmg-log-tracker.adoc
> @@ -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[]
> +