stats module

Aki Tuomi aki.tuomi at dovecot.fi
Fri Nov 3 08:41:12 EET 2017


Hi!

To add inet listener for stats, do

service stats {
   inet_listener {
      port = 24242
  }
}

Aki


On 02.11.2017 23:22, Jeff Abrahamson wrote:
> I'd like to monitor my dovecot instance (running on ubuntu 16.04) using
> telegraf.
>
>     [T] jeff at nantes-1:log $ dovecot --version
>     2.2.22 (fe789d2)
>     [T] jeff at nantes-1:log $
>
> To do that, I think I need to use the stats module and get it to talk on
> port 24242.  I've not found enough documentation on this module to feel
> really comfortable with it, so it doesn't surprise me that I don't have
> it working.  But I'd much appreciate if someone could point me in the
> right direction.
>
> In particular, nothing listens on 24242.
>
>     # This file is based on https://wiki2.dovecot.org/Statistics
>
>     # Dovecot v2.1+ supports gathering statistics (CPU, disk usage, etc.)
>     # from mail processes (IMAP, POP3, LMTP, etc.) to the stats
>     # process. The stats process can later be queried what's going on in
>     # the system. With imap_stats plugin you can get per-command level
>     # statistics for IMAP commands.
>     #
>     # There are different "zoom levels" you can look at the statistics:
>     #
>     # * command: Per-IMAP command
>     # * session: Per IMAP/POP3 connection
>     # * user: Per user (all of user's sessions summed up)
>     # * domain: Per domain (all of domain's users summed up)
>     # * ip: Per IP address (all sessions from the IP summed up)
>     # * global: Everything summed up (2.2.16+)
>
>     mail_plugins = $mail_plugins stats
>     protocol imap {
>       mail_plugins = $mail_plugins imap_stats
>     }
>     plugin {
>       # how often to session statistics (must be set)
>       stats_refresh = 30 secs
>       # track per-IMAP command statistics (optional)
>       stats_track_cmds = yes
>     }
>
>     # You'll also need to give enough permissions for mail processes to be
>     # able to write to stats-mail fifo. For example if you use a single
>     # "vmail" user for mail access:
>     service stats {
>       fifo_listener stats-mail {
>         user = vmail
>         mode = 0600
>       }
>     }
>
>     # Memory usage configuration
>
>     # The stats process attempts to keep memory usage below a specified
>     # amount. This value is only approximate because of extra overhead
>     # caused by malloc() itself.
>
>     stats_memory_limit = 16 M
>
>     # Once the memory limit is reached, oldest statistics are freed from
>     # memory. Different statistics levels have different timeout limits,
>     # which are configured in:
>
>     stats_command_min_time = 1 mins
>     stats_domain_min_time = 12 hours
>     stats_ip_min_time = 12 hours
>     stats_session_min_time = 15 mins
>     stats_user_min_time = 1 hours
>
>     service stats {
>       inet_listener {
>         address = 127.0.0.1
>         port = 24242
>       }
>     }
>
> Thanks in advance.
>



More information about the dovecot mailing list