stats module

[Jeff Abrahamson]

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.

-- 

Jeff Abrahamson
+33 6 24 40 01 57
+44 7920 594 255

http://p27.eu/jeff/