Loading...
 

Debugging

Enable System Debugging

To permanently enable system debugging, add the following line to your $OMQ_DIR/etc/options file:
qorus.debug-system: true and then restart the server.

In addition to increasing the verbose level of the server (or interface); system debugging can be enabled online with the following rest command (from Qorus 3.1+):
qrest put system?action=setDebug

disable with:
qrest put system?action=setDebug\;flag=false

for Qorus < 3.1. use the RPC API:
ocmd omq.system.debug.system true

When you turn on debugging, you should get verbose information (including stack backtraces) for system exceptions, which can be helpful when debugging the system itself.

HTTP Debugging

list listeners:
qrest system/listeners?short=1

turn on HTTP header and body logging for a particular listener:
qrest put system/listeners/qorus-0?action=setLogOptions\;option=-1

Note: The HTTP or service logger (with Qorus 4+) must have log level DEBUG or higher; call the following REST API to ensure that the log level is high enough:
qrest post system/http/logger cloneDefault=1; qrest put system/http/logger level=DEBUG
or for service my-service:
qrest post services/my-service/logger cloneDefault=1; qrest put services/my-service/logger level=DEBUG

turn off HTTP header and body logging for a particular listener:
qrest put system/listeners/qorus-0?action=setLogOptions\;option=0