Documentation rabbitmq_tracing

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)) :