Monitoring and Diagnosis for LedgerBridge and LedgerBridge Connector

In this section:

The Gospel console provides various options for monitoring the activities in the LedgerBridge and LedgerBridge Connector. For a quick view of the activities in the LedgerBridge, you can access the widgets on the dashboard. However, for detailed information, you can access the Logs section in the LedgerBridge Administrative Panel.

LedgerBridge dashboard

The dashboard provides a great way to quickly view and analyse the LedgerBridge activities in the system. The widgets are created using the detailed data reported in the logs and chain code, thus enabling you to easily identify issues, so you can ensure the fastest resolution.

When you log on to the LedgerBridge Administrative Panel, the following widgets are displayed:

OptionDescription
Collectors
ActiveThe number of collectors that are currently active
SpawnedThe number of collectors that are currently connected to the LedgerBridge connector 
Records
ReadThe total number of records read from the data source
CreatedThe total number of records created on successful completion of the read operation 
Errors
ErrorsThe total number of errors reported since this session of LedgerBridge was started  
Last ErrorThe date and time when the last error was displayed
Queue
QueueThe total number of records currently in the queue
Read/secTime taken in seconds to read the file

Analyse log messages

Logs are automatically generated, time-stamped messages, and provide an audit trail for events that have occurred in the LedgerBridge. Various types of logs are provided by the system to collect logging messages. Each log type records information for each event type. For example, "3  |  19/12/2018  |  15:23:17  |  DEBUG: Ledgerbridge Starting

Log messages from the server are written to the chain code and the LedgerBridge Administrative Panel > Logs section. 

Logging Types

The log type determines the type of messageThe logging types that can be specified are:

Log Message Type
Description
DISABLEDDisables logging and stops logging messages

ERROR

Logs errors and critical errors. For example, in case a serious issue or failure of something important an ERROR is logged.

Logs a message with level "ERROR" on this logger. 

INFO

INFO messages correspond to normal application behaviour and milestones.

Logs a message with level "INFO" on this logger. 

WARN

Logs warnings, errors, and critical errors. For example, warning messages indicate that there might have a problem and someone should investigate the messages.

Logs a message with level "WARN" on this logger. 

DEBUG

Logs diagnostic messages and also logs informational messages, warnings, errors, and critical errors.

Logs a message with level "DEBUG" on this logger. 

TRACE

Logs trace messages that are useful when performing problem analysis.

Logs a message with level "TRACE" on this logger.

Using JConsole

JConsole (Java™ Monitoring and Management Console) is a graphical tool that allows the user to monitor and manage the behaviour of Java applications. The LedgerBridge and LedgerBridge connector are configured to automatically discover active sessions and generate application-specific metrics. 

You can start the JConsole by typing jconsole on the command line. In the JConsole: New Connection window select the required process and click Connect. The JConsole starts where you can view the generated metrics.