pmg-statistic.adoc

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