1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40
|
An opinionated tracing plugin for RabbitMQ management. Build it like
any other plugin. After installation you should see a "Tracing" tab in
the management UI. Hopefully use is obvious.
Configuration
=============
There is one configuration option:
directory: This controls where the log files go. It defaults to
"/var/tmp/rabbitmq-tracing".
Performance
===========
On my workstation, rabbitmq-tracing can write about 2000 msg/s to a
log file. You should be careful using rabbitmq-tracing if you think
you're going to capture more messages than this. Of course, any
messages that can't be logged are queued.
The code to serve up the log files over HTTP is pretty dumb, it loads
the whole log into memory. If you have large log files you may wish
to transfer them off the server in some other way.
HTTP API
========
GET /api/traces
GET /api/traces/<vhost>
GET PUT DELETE /api/traces/<vhost>/<name>
GET /api/trace-files
GET DELETE /api/trace-files/<name> (GET returns the file as text/plain,
not JSON describing it.)
Example for how to create a trace:
$ curl -i -u guest:guest -H "content-type:application/json" -XPUT \
http://localhost:55672/api/traces/%2f/my-trace \
-d'{"format":"text","pattern":"#"}'
|