Chapter 11. Configuring logging
Chapter 11. Configuring logging AMQ Interconnect contains internal logging modules that provide important information about each router. For each module, you can configure the logging level, the format of the log file, and the location to which the logs should be written. 11.1. Logging modules AMQ Interconnect logs are broken into different categories called logging modules . Each module provides important information about a particular aspect of AMQ Interconnect. DEFAULT The default module. This module applies defaults to all of the other logging modules. ROUTER This module provides information and statistics about the local router. This includes how the router connects to other routers in the network, and information about the remote destinations that are directly reachable from the router (link routes, waypoints, autolinks, and so on). ROUTER_HELLO This module provides information about the Hello protocol used by interior routers to exchange Hello messages, which include information about the router's ID and a list of its reachable neighbors (the other routers with which this router has bidirectional connectivity). ROUTER_LS This module provides information about link-state data between routers, including Router Advertisement (RA), Link State Request (LSR), and Link State Update (LSU) messages. Periodically, each router sends an LSR to the other routers and receives an LSU with the requested information. Exchanging the above information, each router can compute the hops in the topology, and the related costs. ROUTER_MA This module provides information about the exchange of mobile address information between routers, including Mobile Address Request (MAR) and Mobile Address Update (MAU) messages exchanged between routers. You can use this log to monitor the state of mobile addresses attached to each router. MESSAGE This module provides information about AMQP messages sent and received by the router, including information about the address, body, and link. You can use this log to find high-level information about messages on a particular router. SERVER This module provides information about how the router is listening for and connecting to other containers in the network (such as clients, routers, and brokers). This information includes the state of AMQP messages sent and received by the broker (open, begin, attach, transfer, flow, and so on), and the related content of those messages. AGENT This module provides information about configuration changes made to the router from either editing the router's configuration file or using qdmanage . CONTAINER This module provides information about the nodes related to the router. This includes only the AMQP relay node. ERROR This module provides detailed information about error conditions encountered during execution. POLICY This module provides information about policies that have been configured for the router. Additional resources For examples of these logging modules, see Section 16.2, "Troubleshooting using logs" . 11.2. Configuring default logging You can specify the types of events that should be logged, the format of the log entries, and where those entries should be sent. Procedure In the /etc/qpid-dispatch/qdrouterd.conf configuration file, add a log section to set the default logging properties: This example configures all logging modules to log events starting at the info level: module Specify DEFAULT . enable The logging level. You can specify any of the following levels (from lowest to highest): trace - provides the most information, but significantly affects system performance debug - useful for debugging, but affects system performance info - provides general information without affecting system performance notice - provides general information, but is less verbose than info warning - provides information about issues you should be aware of, but which are not errors error - error conditions that you should address critical - critical system issues that you must address immediately To specify multiple levels, use a comma-separated list. You can also use + to specify a level and all levels above it. For example, trace,debug,warning+ enables trace, debug, warning, error, and critical levels. For default logging, you should typically use the info+ or notice+ level. These levels will provide general information, warnings, and errors for all modules without affecting the performance of AMQ Interconnect. includeTimestamp Set this to yes to include the timestamp in all logs. For information about additional log attributes, see log in the qdrouterd.conf man page. If you want to configure non-default logging for any of the logging modules, add an additional log section for each module that should not follow the default. This example configures the ROUTER logging module to log debug events: Additional resources For more information about viewing and using logs, see Chapter 16, Troubleshooting AMQ Interconnect .
log { module: DEFAULT enable: info+ includeTimestamp: yes } log { module: ROUTER enable: debug includeTimestamp: yes }