Chapter 14. Monitoring using qdstat

The qdstat tool is a command-line tool for monitoring the status and performance of AMQ Interconnect router networks.

14.1. Syntax for using qdstat

You can use qdstat with the following syntax: 

$ qdstat <option> [<connection-options>] [<secure-connection-options>]

This specifies:

  • An option for the type of information to view.

  • One or more optional connection options to specify a router for which to view the information.

    If you do not specify a connection option, qdstat connects to the router listening on localhost and the default AMQP port (5672).

  • The secure connection options if the router for which you want to view information only accepts secure connections.

Additional resources

14.2. Commands for monitoring the router network

You can use qdstat to view the status of routers on your router network. For example, you can view information about the attached links and configured addresses, available connections, and nodes in the router network.

To…​Use this command…​

Create a state dump containing all statistics for all routers

A state dump shows the current operational state of the router network. 

$ qdstat --all-routers --all-entities

If you run this command on an interior router, it displays the statistics for all interior routers. If you run the command on an edge router, it displays the statistics for only that edge router.

Create a state dump containing a single statistic for all routers 

$ qdstat -l|-a|-c|--autolinks|--linkroutes|-g|-m --all-routers

If you run this command on an interior router, it displays the statistic for all interior routers. If you run the command on an edge router, it displays the statistic for only that edge router.

Create a state dump containing all statistics for a single router 

$ qdstat --all-entities

This command shows the statistics for the local router only.

View general statistics for a router 

$ qdstat -g [all-routers|<connection-options>]

View a list of connections to a router 

$ qdstat -c [all-routers|<connection-options>]

View the AMQP links attached to a router

You can view a list of AMQP links attached to the router from clients (sender/receiver), from or to other routers into the network, to other containers (for example, brokers), and from the tool itself. 

$ qdstat -l [all-routers|<connection-options>]

View known routers on the router network 

$ qdstat -n [all-routers|<connection-options>]

View the addresses known to a router 

$ qdstat -a [all-routers|<connection-options>]

View a router’s autolinks 

$ qdstat --autolinks [all-routers|<connection-options>]

View the status of a router’s link routes 

$ qdstat --linkroutes [all-routers|<connection-options>]

View a router’s policy global settings and statistics 

$ qdstat --policy [all-routers|<connection-options>]

View a router’s policy vhost settings 

$ qdstat --vhosts [all-routers|<connection-options>]

View a router’s policy vhost statistics 

$ qdstat --vhoststats [all-routers|<connection-options>]

View a router’s vhostgroup settings 

$ qdstat --vhostgroups [all-routers|<connection-options>]

View a router’s memory consumption 

$ qdstat -m [all-routers|<connection-options>]

Additional resources

  • For more information about the fields displayed by each qdstat command, see the qdstat man page.