Scope

• JS7 provides a number of log files for Controller, Agent and JOC Cockpit.
• The purpose of log files and their location are explained.
• Log files are subject to log rotation, see JS7 - Log Rotation
• To control log levels see JS7 - Log Levels and Debug Options

Controller

Log file location: logs sub-directory of the Controller installation.

Agent

Log file location: logs sub-directory of the Agent installation.

JOC Cockpit

• Log file location: logs sub-directory of the JOC Cockpit installation.
  
  

• Jetty Log

  	Main Log
  Log File	jetty.log
  Log Rotation	with each (re)start
  Log Retention	0d
  Purpose	The log file holds log output created on start-up of the servlet container. If the Jetty servlet container wouldn't start then this is the log file to check for errors.

  
  
  

• JOC Cockpit Log

  	Main Log	Debug Log
  Log File	joc.log	joc-debug.log
  Log Rotation	daily	daily
  Log Retention	30d	30d
  Purpose	The log file holds log output created by the JOC Cockpit application. For problems occurring during operation of JOC Cockpit, e.g. with database connections, this log file includes detailed information.

  
  
  

• Audit Log

  	Main Log
  Log File	audit.log
  Log Rotation	monthly
  Log Retention	unlimited
  Purpose	The JS7 - Audit Log stores information about any changes to the state of objects, such as deploying workflows, cancelling and suspending orders etc. Consider that information from the audit log file can be subject to compliance requirements.

  
  
  

• Authentication Log

  	Debug Log
  Log File	authentication-debug.log
  Log Rotation	daily
  Log Retention	30d
  Purpose	This log is available for debug output only. It provides detailed information about login to JOC Cockpit including connections to LDAP Directory Services for authentication.

  
  
  

• Connection Pool Log

  	Debug Log
  Log File	connection-pool-debug.log
  Log Rotation	daily
  Log Retention	30d
  Purpose	This log is available for debug output only. It provides detailed information about session management of the connection pool that handles database connections.

  
  
  

• Service Logs

  • JS7 - Cleanup Service

    	Main Log	Debug Log
    Log File	service-cleanup.log	service-cleanup-debug.log
    Log Rotation	daily	daily
    Log Retention	30d	30d
    Purpose	The service cleans up entries from the order and task history, deployment history, daily plan history and audit log.

    
    
    

  • JS7 - Cluster Service

    	Main Log	Debug Log
    Log File	service-cluster.log	service-cluster-debug.log
    Log Rotation	daily	daily
    Log Retention	30d	30d
    Purpose	The service operates the JOC Cockpit cluster and performs switch-over and fail-over operations when required.

    
    
    

  • JS7 - Daily Plan Service

    	Main Log	Debug Log
    Log File	service-dailyplan.log	service-dailyplan-debug.log
    Log Rotation	daily	daily
    Log Retention	30d	30d
    Purpose	The service plans orders from schedules and submits orders to Controllers.

    
    
    

  • JS7 - History Service

    	Main Log	Debug Log
    Log File	service-history.log	service-history-debug.log
    Log Rotation	daily	daily
    Log Retention	30d	30d
    Purpose	The service receives events about order state transitions and log output of underlying jobs from Controllers and adds them to the history.