pmg-statistic.adoc

   1 [[chapter_stats]]
   2 Statistics
   3 ==========
   4
   5 {pmg} provides a useful and feature-rich statistics interface that allows
   6 administrators to quickly get an overview of the overall workload and easily
   7 identify problems.
   8
   9 The statistics are displayed for a selected period, which by default is the
  10 current day. This period can be changed to any other day, a whole month or even
  11 a whole year.
  12
  13 [thumbnail="pmg-gui-statistics-general.png", big=1]
  14
  15 On the main statistics page there are three graphs with additional data:
  16
  17 'Total Mail Count'::
  18
  19 Shows the total mail flow as a graph and the following details:
  20
  21 * Total Mails
  22 * Incoming/Outgoing Mails (as count and percentage)
  23 * Virus Outbreaks (the amount of outgoing virus mails)
  24 * Avg. Mail Processing Time
  25 * Incoming/Outgoing Mail Traffic
  26
  27 'Incoming Mails'::
  28
  29 Displays the count of incoming mails from each of the following categories,
  30 including their percentage of the total incoming mail volume:
  31
  32 * Incoming Mails
  33 * Junk Mails (Virus + Spam + Greylisted + SPF rejects + RBL rejects)
  34 * Greylisted Mails
  35 * Spam Mails (Mails with Spamscore >= 3 and not containing a virus)
  36 * SPF rejects
  37 * Bounces (mails with an empty envelope-sender address)
  38 * Virus Mails
  39
  40 'Outgoing Mails'::
  41
  42 Displays the count of outgoing mails from each of the following categories,
  43 including their percentage of the total outgoing mail volume:
  44
  45 * Outgoing Mails
  46 * Bounces (mails with an empty envelope-sender address)
  47 * Virus Mails
  48
  49 [[pmgstats_spam_scores]]
  50 Spam Scores
  51 -----------
  52
  53 [thumbnail="pmg-gui-statistics-spam-scores.png", big=1]
  54
  55 The `Spam Scores` panel shows the distribution of the different spam scores for
  56 the selected time period. Note that you can also select a whole month or even a
  57 whole year as period to display.
  58
  59 [[pmgstats_viruses]]
  60 Virus Charts
  61 ------------
  62
  63 [thumbnail="pmg-gui-statistics-virus-charts.png"]
  64
  65 The `Virus Charts` panel gives you an overview of how many virus files were
  66 tried to be transmitted through your mail infrastructure, but got caught early
  67 by the {pmg}.
  68
  69 The list shows which and how often a certain viruses were detected in the
  70 selected time period.
  71
  72 See xref:pmgconfig_clamav[Virus Detector Configuration] for details about how
  73 {pmg} scans for virus files.
  74
  75 [[pmgstats_hourly_distribution]]
  76 Hourly Distribution
  77 -------------------
  78
  79 [thumbnail="pmg-gui-statistics-hourly-distribution.png", big=1]
  80
  81 The `Hourly Distribution` shows the amount of incoming and outgoing mail per
  82 hour for the selected time period. For periods spanning a whole month or a
  83 whole year the arithmetic average of mail volume in an hour will be shown.
  84
  85 [[pmgstats_postscreen]]
  86 Postscreen
  87 ----------
  88
  89 [thumbnail="pmg-gui-statistics-postscreen.png"]
  90
  91 Contains a chart with the RBL (Real-time Blackhole Lists) and `pregreet`
  92 rejects for the selected time frame.
  93
  94 [quote, Postfix Postscreen Howto]
  95 ____
  96 For each connection from an SMTP client, postscreen(8) performs a number of
  97 tests in the order as described below. Some tests introduce a delay of a few
  98 seconds. postscreen(8) maintains a temporary allowlist for clients that pass
  99 its tests; by allowing allowlisted clients to skip tests, postscreen(8)
 100 minimizes its impact on legitimate email traffic.
 101 ____
 102
 103 For more info about postscreen and pregreet tests, see the
 104 https://www.postfix.org/POSTSCREEN_README.html[postscreen readme].
 105
 106 [[pmgstats_domain]]
 107 Domain
 108 ------
 109
 110 [thumbnail="pmg-gui-statistics-domain.png"]
 111
 112 The `Domain` view is split into two tabs, one for incoming and one for outgoing
 113 mails.
 114
 115 Each tab shows a list of domains that received mails in a selected time frame,
 116 with stats for:
 117
 118 * traffic amount
 119 * counts for:
 120 ** mail flow to a domain
 121 ** how many viruses were detected,
 122 ** and how many mails were classified as spam
 123
 124 [[pmgstats_sender]]
 125 Sender
 126 ------
 127
 128 [thumbnail="pmg-gui-statistics-sender.png", big=1]
 129
 130 The `Sender` panel contains a list of e-mail addresses that sent mail out in
 131 the selected time frame, with a total count, how many viruses were detected and
 132 how big these mails were.
 133
 134 If you click on one of these e-mail addresses, you see a detailed list of
 135 recipients, complete with size, date and time.
 136
 137 [[pmgstats_receiver]]
 138 Receiver
 139 --------
 140
 141 [thumbnail="pmg-gui-statistics-receiver.png"]
 142
 143 Similar to the `Sender` panel, this contains a list of e-mail addresses that
 144 received e-mails from outside, with a total, spam and virus count, as well
 145 as the total mail size.
 146
 147 If you click an entry, it shows a detailed list of mails with size, date,
 148 time, virus and spam score info.
 149
 150 If the `Use advanced statistics filters` option (`Configurations -> Options`)
 151 is enabled, only active accounts will be listed. Active accounts are those that
 152 sent mail during the selected time period or up to 90 days before.
 153
 154 [[pmgstats_contact]]
 155 Contact
 156 -------
 157
 158 [thumbnail="pmg-gui-statistics-contact.png"]
 159
 160 This contains the list of external recipients that received mail from this
 161 {pmg}, coming in on the internal port, with total count, virus count and size.
 162
 163 If you click an entry, it shows a list of mails with size, date and time.
 164
 165 If the `Use advanced statistics filters` option (`Configurations -> Options`)
 166 is enabled, active accounts will be filtered out, since they can already be
 167 seen in the `Receiver` panel.  Active accounts are those which sent mail in the
 168 selected time frame or up to 90 days before.