com.rabbitmq.tools

Class Tracer

java.lang.Object

com.rabbitmq.tools.Tracer

All Implemented Interfaces:

Runnable

public class Tracer
extends Object
implements Runnable

AMQP 0-9-1 protocol traffic capture program. Listens on a port (in-port) and when a connection arrives, makes an outbound connection to a host and port (out-port). Relays frames from the in-port to the out-port. Commands are decoded and printed to a supplied Tracer.Logger.

The stand-alone program (main(String[])) prints to System.out, using a private Tracer.AsyncLogger instance. When the connection closes the program listens for a subsequent connection and traces that to the same Tracer.Logger. This continues until the program is interrupted.

Options for controlling, for example, whether command bodies are decoded, are obtained from System.properties, and are reported to the console before starting the trace.

These constructors block waiting for a connection to arrive on the listenPort. Tracing does not begin until the tracer is start()ed which Tracer.Logger.start()s the supplied logger and creates and starts a Thread for relaying and deconstructing the frames.

The properties specified in props are used at start() time and may be modified before this call.

See Also:

Tracer.Logger, Tracer.AsyncLogger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Tracer.AsyncLogger A Tracer.Logger designed to print Strings to a designated OutputStream on a private thread.
static interface	Tracer.Logger Logging strings to an outputStream.

Constructor Summary

Constructors

Constructor and Description
Tracer(int listenPort, String id, String host, int port, Tracer.Logger logger, Properties props)
Tracer(String id)
Tracer(String id, Properties props)

Method Summary

Modifier and Type	Method and Description
void	log(String message)
void	logException(Exception e)
static void	main(String[] args)
void	run()
void	start()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Tracer

public Tracer(int listenPort,
              String id,
              String host,
              int port,
              Tracer.Logger logger,
              Properties props)
       throws IOException

Throws:

IOException

Tracer

public Tracer(String id)
       throws IOException

Throws:

IOException

Tracer

public Tracer(String id,
              Properties props)
       throws IOException

Throws:

IOException

Method Detail

main

public static void main(String[] args)

start

public void start()

run

public void run()

Specified by:

run in interface Runnable

log

public void log(String message)

logException

public void logException(Exception e)