[pmg-devel] [PATCH pmg-docs v2 1/2] config: add reference to postfix postconf

[pmg-devel] [PATCH pmg-docs v2 1/2] config: add reference to postfix postconf

[Dominik Csapak]

so that the users can find the place where the options are described

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 pmgconfig.adoc | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/pmgconfig.adoc b/pmgconfig.adoc
index 564b87c..87e3192 100644
--- a/pmgconfig.adoc
+++ b/pmgconfig.adoc
@@ -302,8 +302,11 @@ ifndef::manvolnum[]
 [thumbnail="pmg-gui-mailproxy-relaying.png", big=1]
 endif::manvolnum[]
 
-These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`,
-using the following configuration keys:
+These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`. Some of these correspond
+to postfix options in the `main.cf` (see the
+https://www.postfix.org/postconf.5.html[postconf documentation]).
+
+They use the following configuration keys:
 
 include::pmg.mail-relaying-conf-opts.adoc[]
 
@@ -328,8 +331,11 @@ ifndef::manvolnum[]
 [thumbnail="pmg-gui-mailproxy-ports.png", big=1]
 endif::manvolnum[]
 
-These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`,
-using the following configuration keys:
+These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`. Many of these correspond
+to postfix options in the `main.cf` (see the
+https://www.postfix.org/postconf.5.html[postconf documentation]).
+
+They use the following configuration keys:
 
 include::pmg.mail-ports-conf-opts.adoc[]
 
-- 
2.30.2

[pmg-devel] [PATCH pmg-docs v2 2/2] administration: add section for statistics

[Dominik Csapak]

by explaining each panel and it's options

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 pmg-admin-guide.adoc |   2 +
 pmg-statistic.adoc   | 113 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 115 insertions(+)
 create mode 100644 pmg-statistic.adoc

diff --git a/pmg-admin-guide.adoc b/pmg-admin-guide.adoc
index 5ca2b0c..7c92781 100644
--- a/pmg-admin-guide.adoc
+++ b/pmg-admin-guide.adoc
@@ -31,6 +31,8 @@ include::pmg-mail-filter.adoc[]
 
 include::pmg-administration.adoc[]
 
+include::pmg-statistic.adoc[]
+
 include::pmgbackup.adoc[]
 
 include::pmgcm.adoc[]
diff --git a/pmg-statistic.adoc b/pmg-statistic.adoc
new file mode 100644
index 0000000..58e4d77
--- /dev/null
+++ b/pmg-statistic.adoc
@@ -0,0 +1,113 @@
+Statistics
+==========
+
+{pmg} offers a useful and feature-rich statistics interface, which allows the
+administrators to quickly see the general workload and makes it easy to identify
+problems.
+
+The statistics are shown for the selected time range, which defaults to the
+current day, but can be changed to any other day, a whole month, or even a
+whole year.
+
+On the main statistics page there are three graphs with additional data:
+
+'Total Mail Count'::
+
+Shows the total mail flow as a graph and the following details:
+
+* Total Mails
+* Incoming/Outgoing Mails (as count and percentage)
+* Virus Outbreaks (the amount of outgoing virus mails)
+* Avg. Mail Processing Time
+* Incoming/Outgoing Mail Traffic
+
+'Incoming Mails'::
+
+Shows the incoming mail counts as a graph and the following details
+(as counts and percentages of the incoming mail volume):
+
+* Incoming Mails
+* Junk Mails (Virus + Spam + Greylisted + SPF rejects + RBL rejects)
+* Greylisted Mails
+* Spam Mails (Mails with Spamscore >= 3 and not containing a virus)
+* SPF rejects
+* Bounces (mails with an empty envelope-sender address)
+* Virus Mails
+
+'Outgoing Mails'::
+
+Shows the outgoing mail counts as a graph and the following details
+(as counts and percentages of the outgoing mail volume):
+
+* Outgoing Mails
+* Bounces (mails with an empty envelope-sender address)
+* Virus Mails
+
+Spam Scores
+-----------
+
+This panel shows the distribution of the different spam scores for the selected
+time frame.
+
+Virus Charts
+------------
+
+This panel shows which and how many viruses were detected in the selected
+time frame.
+
+Hourly Distribution
+-------------------
+
+Shows the amount of incoming and outgoing mail per hour for the selected
+time frame.
+
+Postscreen
+----------
+
+Contains a chart with the RBL and pregreet rejects for the selected time frame.
+For more info about postscreen and pregreet tests, see the
+https://www.postfix.org/POSTSCREEN_README.html[postscreen readme].
+
+Domain
+------
+
+Contains a summary for the recipient domain of the incoming and outgoing mails
+of the selected time frame, with traffic, count, how many viruses were detected,
+and how much of it was spam.
+
+Sender
+------
+
+This panel contains a list of e-mail addresses that sent mail out in the
+selected time frame, with a total count, how many viruses were detected and how
+big these mails were.
+
+If you click on one of these e-mail addresses, you see a detailed list of
+recipients, complete with size, date and time.
+
+Receiver
+--------
+
+Similar to the `Sender` panel, this contains a list of e-mail addresses that
+received e-mails from outside, with a total, spam and virus count, as well
+as the total mail size.
+
+If you click an entry, it shows a detailed list of mails with size, date,
+time, virus and spam score info.
+
+If the `advanced statistics filters` are active, only active accounts will be
+listed. Active accounts are those which sent mail in the selected time frame
+or up to 90 days before.
+
+Contact
+-------
+
+This contains the list of external recipients that received mail from this
+{pmg}, coming in on the internal port, with total count, virus count and size.
+
+If you click an entry, it shows a list of mails with size, date and time.
+
+If the `advanced statistics filters` are active, active accounts will be
+filtered out, since they can already be seen in the `Receiver` panel. Active
+accounts are those which sent mail in the selected time frame or up to 90 days
+before.
-- 
2.30.2

[pmg-devel] applied-series: [PATCH pmg-docs v2 1/2] config: add reference to postfix postconf

[Stoiko Ivanov]

applied both patches - thank you very much!

additionally ran make update (to get the actual postfix-options from the
corresponding api-patch) - found a tiny glitch in the markup in the api
commit. This was fixed, along with the addition of the enable_smtputf8
reference for my recent change and pushed directly to pmg-api


On Mon, 27 Mar 2023 14:22:39 +0200
Dominik Csapak <d.csapak@proxmox.com> wrote:

> so that the users can find the place where the options are described
> 
> Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
> ---
>  pmgconfig.adoc | 14 ++++++++++----
>  1 file changed, 10 insertions(+), 4 deletions(-)
> 
> diff --git a/pmgconfig.adoc b/pmgconfig.adoc
> index 564b87c..87e3192 100644
> --- a/pmgconfig.adoc
> +++ b/pmgconfig.adoc
> @@ -302,8 +302,11 @@ ifndef::manvolnum[]
>  [thumbnail="pmg-gui-mailproxy-relaying.png", big=1]
>  endif::manvolnum[]
>  
> -These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`,
> -using the following configuration keys:
> +These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`. Some of these correspond
> +to postfix options in the `main.cf` (see the
> +https://www.postfix.org/postconf.5.html[postconf documentation]).
> +
> +They use the following configuration keys:
>  
>  include::pmg.mail-relaying-conf-opts.adoc[]
>  
> @@ -328,8 +331,11 @@ ifndef::manvolnum[]
>  [thumbnail="pmg-gui-mailproxy-ports.png", big=1]
>  endif::manvolnum[]
>  
> -These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`,
> -using the following configuration keys:
> +These settings are saved to the 'mail' subsection in `/etc/pmg/pmg.conf`. Many of these correspond
> +to postfix options in the `main.cf` (see the
> +https://www.postfix.org/postconf.5.html[postconf documentation]).
> +
> +They use the following configuration keys:
>  
>  include::pmg.mail-ports-conf-opts.adoc[]
>  

[pmg-devel] applied: [PATCH pmg-docs v2 2/2] administration: add section for statistics

[Thomas Lamprecht]

Am 27/03/2023 um 14:22 schrieb Dominik Csapak:
> by explaining each panel and it's options
> 
> Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
> ---
>  pmg-admin-guide.adoc |   2 +
>  pmg-statistic.adoc   | 113 +++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 115 insertions(+)
>  create mode 100644 pmg-statistic.adoc
> 
>

applied, with a follow up on top for grammar/content clarification, thanks!