OFAgent is an OpenFlow agent which exposes virtual network to the external OpenFlow controllers.
Builtin OFAgent tracer enables filtering of OFAgent logs per specific OFAgent tenant. Tracer is not enabled by default. Steps required for its activation are:
Create Karaf alias ofagent_tracer by executing CLI command: onos>ofagent_tracer = { log:display | grep "OFAGENT_tenantId:" | grep "$1" }
Use ofagent_tracer in form: onos>ofagent_tracer <tenant_id>
Default log level is INFO. Optionally, OFAgent log level can be changed with CLI command: log:set <log_level> org.onosproject.ofagent where <log_level> can be TRACE, DEBUG, INFO, WARN, ERROR, FATAL.
Note 1.: Useful Karaf CLI commands for changing log configuration are (reference: Apache Karaf Container 3.x - Documentation):
log:clear - clear the log entries
log:display - displays the log entries of the rootLogger
log:tail - exactly the same as log:display but it continuously displays the log entries
log:display <logger> - displays the log entries of the <logger>
log:exception-display - displays the last occurred exception
log:get - shows the current log level of a ROOT logger
log:get ALL - shows the current log level of all loggers
log:get <logger> - show the current log level of a <logger>
log:set <log_level> - sets <log_level> for ROOT logger
log:set <log_level> <logger> - sets <log_level> for <logger>
Note 2.: Karaf log4j configuration is in file $ONOS_INSTALL_DIR/apache-karaf-3.0.8/etc/org.ops4j.pax.logging.cfg and it can be changed on the fly.
More documentation is available in vBrigade wiki and vBrigade weekly scrum notes.