Logging configuration in Zorka Agent

Due to sheer number of mechanisms and components in zorka agent, and needs for debugging (especially when implementing new extension scripts) there are a lot of logging directives allowing for fine grained log tuning. Zorka can log to local file or send its logs to remote syslog server.

General logging settings

  • zorka.log.level = DEBUG - overall log level (TRACE, DEBUG, INFO, WARN, ERROR, FATAL are allowed);

  • zorka.log.size = 4m - maximum size of log files (in megabytes if m is added as a suffix);

  • zorka.log.num = 4 - maximum number of archived log files;

  • zorka.log.exceptions = yes - controls whether full stack traces of encountered exceptions will be logged;

  • zorka.log.fname = zorka.log - zorka log file name’;

Syslog related logging settings;

Below options enable sending agent logs to syslog server in real time.

  • zorka.syslog = no - enables sending zorka logs to remote syslog server if set to yes;

  • zorka.syslog.server = 127.0.0.1 - IP address and (optional) port number of syslog server in addr:port form;

  • zorka.syslog.facility = F_LOCAL0 - syslog facility code each message will be tagged with;

Agent core logging settings

zorka.log.agent = INFO

The following flags are available:

  • NONE - turn off all messages from agent core;

  • CONFIG - agent configuration information;

  • QUERIES - logs every query handled (and its result);

  • TRACES - logs detailed (trace) messages from agent core;

  • WARNINGS - logs warning messages from agent core;

  • ERRORS - logs error messages from agent core;

Additional grouping flags have been added for convenience:

  • INFO = CONFIG, ERRORS (default setting)

  • DEBUG = INFO, QUERIES

  • TRACE = DEBUG, TRACES

Zorka Spy subsystem logging settings

zorka.log.spy = INFO

The following flags are available:

  • NONE - turn off all messages from spy engine;

  • ARGPROC - argument processing information (for instrumented code);

  • CONFIG - spy configuration information;

  • SUBMIT - argument fetch and submission information (for instrumented code);

  • ERRORS - tracer errors

  • CLASS_DBG - class-level debug information;

  • METHOD_DBG - method-level debug information;

  • CLASS_TRC - class-level trace information;

  • METHOD_TRC - method-level trace information;

Additional grouping flags have been added for convenience:

  • INFO = CONFIG, ERRORS (default setting)

  • DEBUG = INFO, CLASS_DBG, METHOD_DBG

  • TRACE = DEBUG, SUBMIT, ARGPROC, CLASS_TRC, METHOD_TRC

Tracer subsystem log flags

zorka.log.tracer = INFO

This configures tracer logging flags. The following flags are available:

  • NONE - turn off all log messages related to tracer;

  • CONFIG - tracer configuration information;

  • INSTRUMENT_CLASS - class-level messages from instrumentation engine;

  • INSTRUMENT_METHOD - method-level messages from instrumentation engine;

  • SYMBOL_REGISTRY - log changes in symbol registry;

  • SYMBOL_ENRICHMENT - log which symbols are to be sent to output trace file;

  • TRACE_ERRORS - log internal errors of tracer engine;

  • TRACE_CALLS - log each and every call of tracer engine (from instrumented methods);

Additional grouping flags have been added for convenience:

  • INFO = CONFIG, TRACE_ERRORS

  • DEBUG = INFO, INSTRUMENT_CLASS, INSTRUMENT_METHOD

  • TRACE = DEBUG, SYMBOL_REGISTRY, SYMBOL_ENRICHMENT

  • TRACE_FULL = TRACE, TRACE_CALLS