Configure Verbosity

You can configure the desired log verbosity for your RSK node installation according to your needs. More information can be found at: Logback Project.

Requirements

  • RSK Node Installed
  • SSH Access
  • SuperUser Access (sudo)

Where to find RSK log files

Real time log:

/var/log/rsk/rsk.log

Compressed logs:

/var/log/rsk/rskj-YYYY-MM-DD.N.log.gz

Log level options

When you configure your log level, all log items for that level and below get written to the log file. In the following table, the left column represents the the possible values you can set in your configuration.

Log Levels

Setting your desired verbosity configuration

You need to edit logback.xml file to set your desired level of verbosity.

sudo vi /etc/rsk/logback.xml

This file allows you to configure different log levels for different parts of the application.

    <logger name="execute" level="INFO"/>
    <logger name="blockvalidator" level="INFO"/>
    <logger name="blocksyncservice" level="TRACE"/>
    <logger name="blockexecutor" level="INFO"/>
    <logger name="general" level="DEBUG"/>
    <logger name="gaspricetracker" level="ERROR"/>
    <logger name="web3" level="INFO"/>
    <logger name="repository" level="ERROR"/>
    <logger name="VM" level="ERROR"/>
    <logger name="blockqueue" level="ERROR"/>
    <logger name="io.netty" level="ERROR"/>
    <logger name="block" level="ERROR"/>
    <logger name="minerserver" level="INFO"/>
    <logger name="txbuilderex" level="ERROR"/>
    <logger name="pendingstate" level="INFO"/>
    <logger name="hsqldb.db" level="ERROR"/>
    <logger name="TCK-Test" level="ERROR"/>
    <logger name="db" level="ERROR"/>
    <logger name="net" level="ERROR"/>
    <logger name="start" level="ERROR"/>
    <logger name="cli" level="ERROR"/>
    <logger name="txs" level="ERROR"/>
    <logger name="gas" level="ERROR"/>
    <logger name="main" level="ERROR"/>
    <logger name="trie" level="ERROR"/>
    <logger name="org.hibernate" level="ERROR"/>
    <logger name="peermonitor" level="ERROR"/>
    <logger name="bridge" level="ERROR"/>
    <logger name="org.springframework" level="ERROR"/>
    <logger name="rlp" level="ERROR"/>
    <logger name="messagehandler" level="ERROR"/>
    <logger name="syncprocessor" level="TRACE"/>
    <logger name="sync" level="ERROR"/>
    <logger name="BtcToRskClient" level="ERROR"/>
    <logger name="ui" level="ERROR"/>
    <logger name="java.nio" level="ERROR"/>
    <logger name="org.eclipse.jetty" level="ERROR"/>
    <logger name="wire" level="ERROR"/>
    <logger name="BridgeSupport" level="ERROR"/>
    <logger name="jsonrpc" level="ERROR"/>
    <logger name="wallet" level="ERROR"/>
    <logger name="blockchain" level="INFO"/>
    <logger name="blockprocessor" level="ERROR"/>
    <logger name="state" level="INFO"/>
    <logger name="messageProcess" level="INFO"/>

    <root level="DEBUG">
        <appender-ref ref="stdout"/>
        <appender-ref ref="FILE-AUDIT"/>
    </root>
  • Save your changes
  • RSK logback.xml config will watch and apply changes without restarting RSK Node. (The watcher can take up to 1 hour to notice the changes and reload the logging configuration)
  • RSK logs with default installation will rotate on daily basis and/or when the log file reach 100MB

Using this configuration:

  • Most areas of the application will only log FATAL and ERROR events for most areas of the application.
  • The execute, blockvalidator, blockexecutor, web3, minerserver, pendingstate, blockchain, messageProcess, areas specify INFO, so those will only log FATAL, ERROR, WARN, and INFO events.
  • The will be no DEBUG, INFO, and TRACE logs.

Using logback configuration file

A logback configuration example can be downloaded from here.

Using logback with a installed node

If you’re running a node using the release jar file use the following command:

java -cp rskj-core-0.6.2-ORCHID-all.jar co.rsk.Start -Dlogback.configurationFile=path/to/logback.xml

Using logback with a compiled node

If you’re running a node by compiling the code on VM Options add:

-Dlogback.configurationFile=path/to/logback.xml

Note: path should be written without abbreviations (full path)