Ajout doc stats + maj section munin
This commit is contained in:
whirigoyen
parent
9030561449
commit
5718163e74
104
HowtoDovecot.md
104
HowtoDovecot.md
|
|
@ -325,6 +325,71 @@ plugin {
|
|||
|
||||
Note : Il est très probable, lors de ce genre de migration, que votre ancienne configuration Postfix (et Dovecot) ai besoin d'être ajusté pour que Postfix utilise Dovecot comme MDA local plutot que procmail.
|
||||
|
||||
|
||||
### Statisques
|
||||
|
||||
Le module `stats` permet notamment de faire fonctionner les plugins Munin.
|
||||
|
||||
#### Dovecot 2.2
|
||||
|
||||
Documentation officielle : <https://doc.dovecot.org/configuration_manual/stats/old_statistics/>
|
||||
|
||||
~~~
|
||||
mail_plugins = $mail_plugins stats
|
||||
protocol imap {
|
||||
mail_plugins = $mail_plugins imap_stats
|
||||
}
|
||||
plugin {
|
||||
stats_refresh = 30 secs
|
||||
stats_track_cmds = yes
|
||||
}
|
||||
service stats {
|
||||
fifo_listener stats-mail {
|
||||
user = vmail
|
||||
group = vmail
|
||||
mode = 0660
|
||||
}
|
||||
}
|
||||
~~~
|
||||
|
||||
Note : La directive `mail_plugins` globale (pas celle dans les filtres `{}`) doit précéder toutes les directives `mail_plugins` se trouvant dans les filtres. Sinon, on aura un warning du genre :
|
||||
|
||||
~~~
|
||||
# doveconf -n > /dev/null
|
||||
doveconf: Warning: /etc/dovecot/conf.d/XX.conf line XX: Global setting mail_plugins won't change the setting inside an earlier filter at /etc/dovecot/conf.d/XX line XX (if this is intentional, avoid this warning by moving the global setting before /etc/dovecot/conf.d/XX line XX)
|
||||
~~~
|
||||
|
||||
#### Dovecot 2.3
|
||||
|
||||
Dovecot 2.3 a introduit un nouveau module `stats`, complètement différents de l'ancien.
|
||||
|
||||
Sa sortie et sa configuration ne sont pas rétrocompatible.
|
||||
|
||||
L'ancien module `stats` de la version 2.2 a été renommé `old_stats` en 2.3 (ainsi que toutes ses variables de configuration).
|
||||
|
||||
Documentation officille pour continer à utiliser le module `old_stats` : <https://doc.dovecot.org/installation_guide/upgrading/from-2.2-to-2.3/>
|
||||
|
||||
~~~
|
||||
mail_plugins = $mail_plugins old_stats
|
||||
protocol imap {
|
||||
mail_plugins = $mail_plugins imap_old_stats
|
||||
}
|
||||
plugin {
|
||||
old_stats_refresh = 30 secs
|
||||
old_stats_track_cmds = yes
|
||||
}
|
||||
service old-stats {
|
||||
fifo_listener old-stats-mail {
|
||||
user = vmail
|
||||
group = vmail
|
||||
mode = 0660
|
||||
}
|
||||
}
|
||||
~~~
|
||||
|
||||
Même remarque que pour la version 2.2 au sujet de l'ordre des directives `mail_plugins`.
|
||||
|
||||
|
||||
## Sieve
|
||||
|
||||
Sieve est un langage permettant d'écrire des règles de filtrage d'emails, du même type que [procmail](https://fr.wikipedia.org/wiki/Procmail).
|
||||
|
|
@ -640,17 +705,46 @@ On utilise les checks classiques pour POP(S)/IMAP(S) :
|
|||
|
||||
### Munin
|
||||
|
||||
Plusieurs plugins Munin sont disponibles sur <https://github.com/munin-monitoring/contrib/search?q=dovecot>
|
||||
3 plugins Munin sont disponibles sur <https://github.com/munin-monitoring/contrib/tree/master/plugins/dovecot>.
|
||||
|
||||
Nous utilisons principalement <https://raw.githubusercontent.com/munin-monitoring/contrib/master/plugins/dovecot/dovecot>
|
||||
à télécharger dans /etc/munin/plugins/ avec les droits 755 que l'on fait tourner avec le groupe adm via
|
||||
/etc/munin/plugin-conf.d/munin-node :
|
||||
Nous les copions dans `/usr/local/lib/munin/plugins/` et faisons des liens symboliques dans `/etc/munin/plugins/`.
|
||||
|
||||
Nous utilisons `dovecot1` et `dovecot_stats_` (ce dernier est un plugin Munin wildcard).
|
||||
|
||||
~~~
|
||||
[dovecot]
|
||||
# cat /etc/munin/plugin-conf.d/z-custom
|
||||
[dovecot1]
|
||||
group adm
|
||||
|
||||
[dovecot_stats_*]
|
||||
group adm
|
||||
~~~
|
||||
|
||||
Le plugin `dovecot_stats_` fait des statistiques par domaine. Pour avoir les statistiques globales, il faut le patcher :
|
||||
|
||||
~~~
|
||||
[...]
|
||||
+if [ "${domain}" = "global" ]; then
|
||||
+ args="global"
|
||||
+else
|
||||
+ args="domain domain=$domain"
|
||||
+fi
|
||||
|
||||
# Fetch data
|
||||
# Gawk script cadged from http://awk.info/?JanisP
|
||||
-doveadm $stats_command dump domain domain=$domain | gawk -F\\t -v cols="user_cpu sys_cpu min_fa ults maj_faults vol_cs invol_cs read_count write_count num_logins num_cmds mail _lookup_path mail_lookup_attr mail_read_count mail_cache_hits " -v domain=${dom ain//\./_} '
|
||||
+doveadm $stats_command dump $args | gawk -F\\t -v cols="user_cpu sys_cpu min_fa ults maj_faults vol_cs invol_cs read_count write_count num_logins num_cmds mail _lookup_path mail_lookup_attr mail_read_count mail_cache_hits " -v domain=${dom ain//\./_} '
|
||||
[...]
|
||||
~~~
|
||||
|
||||
On peut ainsi faire des statistiques par domaine et/ou globales :
|
||||
|
||||
~~~
|
||||
ln -s /usr/local/lib/munin/plugins/dovecot_stats_ /etc/munin/plugins/dovecot_stats_global
|
||||
ln -s /usr/local/lib/munin/plugins/dovecot_stats_ /etc/munin/plugins/dovecot_stats_example.org
|
||||
~~~
|
||||
|
||||
|
||||
## Migration depuis Courier
|
||||
|
||||
<https://wiki.dovecot.org/Migration/Courier>
|
||||
|
|
|
|||
Loading…
Reference in a new issue