diff --git a/images/screenshot/pmg-gui-statistics-contact.png b/images/screenshot/pmg-gui-statistics-contact.png new file mode 100644 index 0000000..84986a5 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-contact.png differ diff --git a/images/screenshot/pmg-gui-statistics-domain.png b/images/screenshot/pmg-gui-statistics-domain.png new file mode 100644 index 0000000..d127986 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-domain.png differ diff --git a/images/screenshot/pmg-gui-statistics-general.png b/images/screenshot/pmg-gui-statistics-general.png new file mode 100644 index 0000000..b4132f4 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-general.png differ diff --git a/images/screenshot/pmg-gui-statistics-hourly-distribution.png b/images/screenshot/pmg-gui-statistics-hourly-distribution.png new file mode 100644 index 0000000..d22aaa6 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-hourly-distribution.png differ diff --git a/images/screenshot/pmg-gui-statistics-postscreen.png b/images/screenshot/pmg-gui-statistics-postscreen.png new file mode 100644 index 0000000..b737fd9 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-postscreen.png differ diff --git a/images/screenshot/pmg-gui-statistics-receiver.png b/images/screenshot/pmg-gui-statistics-receiver.png new file mode 100644 index 0000000..4624147 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-receiver.png differ diff --git a/images/screenshot/pmg-gui-statistics-sender.png b/images/screenshot/pmg-gui-statistics-sender.png new file mode 100644 index 0000000..b428348 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-sender.png differ diff --git a/images/screenshot/pmg-gui-statistics-spam-scores.png b/images/screenshot/pmg-gui-statistics-spam-scores.png new file mode 100644 index 0000000..9485d9a Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-spam-scores.png differ diff --git a/images/screenshot/pmg-gui-statistics-virus-charts.png b/images/screenshot/pmg-gui-statistics-virus-charts.png new file mode 100644 index 0000000..7b72735 Binary files /dev/null and b/images/screenshot/pmg-gui-statistics-virus-charts.png differ diff --git a/pmg-statistic.adoc b/pmg-statistic.adoc index 02ea81c..1ee20a4 100644 --- a/pmg-statistic.adoc +++ b/pmg-statistic.adoc @@ -9,6 +9,8 @@ The statistics are displayed for a selected period, which by default is the current day. This period can be changed to any other day, a whole month or even a whole year. +[thumbnail="pmg-gui-statistics-general.png", big=1] + On the main statistics page there are three graphs with additional data: 'Total Mail Count':: @@ -46,6 +48,8 @@ including their percentage of the total outgoing mail volume: Spam Scores ----------- +[thumbnail="pmg-gui-statistics-spam-scores.png", big=1] + The `Spam Scores` panel shows the distribution of the different spam scores for the selected time period. Note that you can also select a whole month or even a whole year as period to display. @@ -53,12 +57,23 @@ whole year as period to display. Virus Charts ------------ -The `Virus Charts` panel shows which and how many viruses were detected in the +[thumbnail="pmg-gui-statistics-virus-charts.png"] + +The `Virus Charts` panel gives you an overview of how many virus files were +tried to be transmitted through your mail infrastructure, but got caught early +by the {pmg}. + +The list shows which and how often a certain viruses were detected in the selected time period. +See xref:pmgconfig_clamav[Virus Detector Configuration] for details about how +{pmg} scans for virus files. + Hourly Distribution ------------------- +[thumbnail="pmg-gui-statistics-hourly-distribution.png", big=1] + The `Hourly Distribution` shows the amount of incoming and outgoing mail per hour for the selected time period. For periods spanning a whole month or a whole year the arithmetic average of mail volume in an hour will be shown. @@ -66,21 +81,45 @@ whole year the arithmetic average of mail volume in an hour will be shown. Postscreen ---------- -Contains a chart with the RBL and pregreet rejects for the selected time frame. +[thumbnail="pmg-gui-statistics-postscreen.png"] + +Contains a chart with the RBL (Real-time Blackhole Lists) and `pregreet` +rejects for the selected time frame. + +[quote, Postfix Postscreen Howto] +____ +For each connection from an SMTP client, postscreen(8) performs a number of +tests in the order as described below. Some tests introduce a delay of a few +seconds. postscreen(8) maintains a temporary allowlist for clients that pass +its tests; by allowing allowlisted clients to skip tests, postscreen(8) +minimizes its impact on legitimate email traffic. +____ + For more info about postscreen and pregreet tests, see the https://www.postfix.org/POSTSCREEN_README.html[postscreen readme]. Domain ------ +[thumbnail="pmg-gui-statistics-domain.png"] + The `Domain` view is split into two tabs, one for incoming and one for outgoing -mails. Each shows a summary grouped by the recipient domain in a selected time -frame, with stats for traffic, count, how many viruses were detected, and how -much of the mail volume was classified as spam. +mails. + +Each tab shows a list of domains that received mails in a selected time frame, +with stats for: + +* traffic amount +* counts for: +** mail flow to a domain +** how many viruses were detected, +** and how many mails were classified as spam Sender ------ +[thumbnail="pmg-gui-statistics-sender.png", big=1] + The `Sender` 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. @@ -91,6 +130,8 @@ recipients, complete with size, date and time. Receiver -------- +[thumbnail="pmg-gui-statistics-receiver.png"] + 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. @@ -105,6 +146,8 @@ sent mail during the selected time period or up to 90 days before. Contact ------- +[thumbnail="pmg-gui-statistics-contact.png"] + 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.