diff --git a/HowtoRabbitMQ.md b/HowtoRabbitMQ.md index 36b8f01b..7e0c28f7 100644 --- a/HowtoRabbitMQ.md +++ b/HowtoRabbitMQ.md @@ -240,6 +240,41 @@ $ rabbitmqadmin export rabbitmq.dump Exported definitions for localhost to "rabbitmq.dump" ~~~ +### Tracing des messages + +> **Activer le tracing des messages cause une réduction de performance qui peut être importante.** + +Afin d'obtenir un log des messages passant par un cluster rabbitmq, il est possible d'activer sa fonction de tracing. + +Soit en créant un échange `amq.rabbitmq.trace` avec la commande `rabbitmqctl trace_on` (la désactivation globale étant avec `rabbitmqctl trace_off`). + +Soit par l'intermédiaire du plugin `rabbitmq_tracing` qui permet l'écriture de ces traces dans des fichiers de logs et la gestion de ce qui est tracé par l'interface de gestion. + +Pour activer le plugin `rabbitmq_tracing` il faut faire les actions suivantes : + +1. Activer le plugin. + + ``` + # rabbitmq-plugins enable rabbitmq_tracing + ``` + +2. Configurer le plugin dans `/etc/rabbitmq/rabbitmq.conf`. L'utilisateur configuré doit avoir les droits de créé une queue, de la lié à `amq.rabbitmq.trace` et de consommé les messages dans cette queue. + + ``` + [...] + {rabbitmq_tracing, + [ + {directory, "/path/to/tracing/log/directory"}, + {username, <<"admin">>}, + {password, <<"password">>} + ] + }, + [...] + ``` + +3. Redémarrer le cluster RabbitMQ. +4. Les administrateurs devraient à présent avoir accès à un onglet "Tracing" dans l'interface de gestion. + ## Munin On utilise *rabbitmq_connections* (merci [ask](https://github.com/ask)) :