Configuring Zorka Logging

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