Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Order logs and task logs are stored in the JS7 - Database in a compressed format and are available from the JS7 - Order History and JS7 - Task History views respectively. This includes to display Both views allow display of the log output in a log view window.

...

  • Files are a frequent source of error as they might may not be created due to restrictions of disk space restrictions or lack of permissions.
  • If Job processing could be blocked if a log file cannot be created then this could block processing of jobs. Even worse, if log files are not available then users are blind about unable to see job execution results.

JS7 therefore streams log output from Agents to the Controller and to JOC Cockpit without the use of files.

  • Streaming makes job log output available to JOC Cockpit within 1s. 
  • Streaming allows a running log which translates to the fact that users observe ongoing log output of orders and jobs in the log view window.
  • In case of missing connections:
    • between Controller and Agent then - the Agent stores log output in its journal and forwards logs when reconnected to a Controller later on. 
    • between JOC Cockpit and Controller then - the Controller stores log output in its journal and forwards logs when reconnected to JOC Cockpit at a later onpoint.

Log Files

A number of users prefer to have log files available for each order execution and job execution, for example to consolidate log files on a file server or to submit log files to specific tools for log analysis.

  • Log analysis is useful but usually comes too late. It's more a reporting activity that is not intended to replace near-real time monitoring.
  • Log analysis starts when the log is completed. In Unix environments parallel read and write operations on log files can occur. 
  • Log analysis is useful when it comes to parsing logs for unexpected output or errors. However, it might prove tedious to teach a log analyzer recovery of errors from log output in case that of a job was being successfully restarted for a specific order.

To support The JS7 - REST Web Service API allows access to log output of orders and jobs and thereby supports a situation when log output should be consolidated or should be analyzed by external tools the JS7 - REST Web Service API allows access to log output of orders and jobs.

The JS7 - PowerShell Module is a lightweight wrapper for the REST Web Service API that can be used with Linux and Windows to provide orders order logs and task logs from files , see Linksas described in the linked articles below. Users are free to use the JS7 REST Web Service from their preferred scripting language to provide similar functionality.

...