Maintenance

Owned by Trello
Last updated: Nov 06, 2016 by Petr Jůza
2 min read

Integration platform generates application logs and writes records to database.

Application logs

This chapter is specific for OpenHub admin GUI use.

 

Application logs are generated via logback library and are configured in logback.xml. There is Maven property log.folder that specifies target folder for application logs.

Log names are in format logFile_RRRR-MM-DD_N.log, where N is order number unique for each day. If the log file is greater then 10MB then new log file with next order number is created. It's best practice to backup these application logs, at least for 2 months.

Logback offers lot of possibilities where and how log items save to - to file system, to database, send it by emails etc. 

 

OpenHub provides simple tool for application log searching (see Admin GUI). This tool must be correctly configured (log.folder.path - path to application logs, log.file.pattern - format of log file names) and then allows to go through all application logs and find searched information.

 

When we use standard installation with Apache Tomcat server then we have all logs in /srv/project_name/logs/ folder with the the following sub-folders:

  • apache: logs generated by Apache HTTP server
  • j2ee: logs from integration platform
  • tomcat: logs generated by Apache Tomcat

Database

OpenHub stores lot of records to database, namely to these tables (see Data model for more information):

  • message
  • external_call
  • request (it depends on configuration)
  • response (it depends on configuration)

Also database records should be backuped. Remove old records to keep good performance - we remove records older then 2 months usually on our production installations.

 

There is functionality for archiving database tables.

Stop ESB

OpenHub allows to switch to stopping mode where no new requests will be processed, only current asynchronous messages will be finished (messages in states PROCESSING and WAITING_FOR_RES).

You will find more information in admin GUI documentation.