Loftware Enterprise SP Log Files

Loftware Enterprise SP logs information, error, and warning messages to a set of log files. The log files that are created can be found in the Loftware Enterprise SP logs folder. Log files "roll over" at the interval configured in the log4j2.xml file. The previous file is compressed and renamed with a timestamp.

Tip: For more information about logging levels and types of messages, see Logging Levels.

System Log (spectrum.log)

The System Log is the default log for Loftware Enterprise SP. It provides a full, lifetime view of the application. All messages are captured in this log, so the other logs can be reconciled against this one to provide additional context if needed. The default logging level for this log is WARN.

UI to Server Message Log (spectrum-amf.log)

Default log file object level request/response details pertaining to the messages sent between the Loftware Enterprise SP UI and the Loftware Application Server.

Critical Event Log (spectrum-critical.log)

The Critical Event Log includes messages about issues that are critical to the functioning of Loftware Enterprise SP. The default logging level for this log is INFO. Depending on the logging level configured, information such as the following may be included.

  • Startup and shutdown information (if the logging level is INFO level or better).
  • Licensing changes (if the logging level is INFO level or better).
  • Fatal error messages (if the logging level is FATAL or better).
  • Any appropriate error messages (if the logging level is ERROR or better).

Data Map Log (spectrum-data.log)

The data log captures the contents of the data map.

Driver Install Log (spectrum-drv-install-svc.log)

The Driver Install Log captures information about device driver service. The default logging level is DEBUG.

Integration Event Log (spectrum-integration.log)

The Integration Event Log captures information for Java Message Service (JMS) integrations. Loftware Enterprise SP supports the Event JMS Consumer and the Event JMS Producer integrations. For more information, see Event Integration.

The default logging level for this log is INFO. Depending on the logging level configured, information such as the following may be included.

  • Messages sent between client computers.
  • Custom user log messages, such as logs entered in the JavaScript for integrations.

Printing Event Log (spectrum-print.log)

The Printing Event Log captures every meaningful state transition in the lifetime of a job and a print job detail as they progress through Loftware Enterprise SP, as well as any issues that occur. Device connection information is included.

The default logging level for this log is INFO. Depending on the logging level configured, information such as the following may be included.

  • The beginning and end of each print job.
  • The printing state for each job.
  • The printing state for each print job detail.
  • The destination (device) for each job.
  • The label template and layout for each job.
  • The requester of the print job.
  • Any errors that occur during printing.

Security Event Log (spectrum-security.log)

The Security Event Log includes messages about actions–positive and negative–related to security. The default logging level for this log is INFO. Depending on the logging level configured, information such as the following may be included.

  • User additions, modifications, or deletions (if the logging level is INFO level or better). The user name is included.
  • Security problems (if the logging level is WARN or better). For example, a user without the necessary permissions attempting to perform an action, or an administrator attempting to create an object without providing a required parameter. In many cases, the Loftware Enterprise SP user interface will prevent these issues, but those not prevented by the user interface are recorded in the Security Event Log.
  • User sign ins and sign outs (if the logging level is INFO level or better). The user name is included.

SOAP Web Service Log (spectrum-soap.log)

The SOAP Web Service log captures information about SOAP Web Service Data Service requests. The default logging level is WARN.

Entity Sync Log (spectrum-sync-entity.log)

The Entity Sync Log includes information about objectsClosed An item in Loftware such as a role, group, user, business rule, application, workflow template, data service, form, image, integration, job, label template, layer object, layout, field data catalog, device, device group, process, reusable object, facility, Remote Site, Loftware Application Server, or server process. replicated from headquarters to facilities during synchronization in a multi-site deployment. The default logging level is DEBUG.

Transaction Sync Log (spectrum-sync-transaction.log)

The Transaction Sync Log includes information about transactional dataClosed In a multi-site deployment of Loftware, information about recent synchronizations that can be used for auditing. During a transaction sync, this data can be replicated from a facility to headquarters. replicated from facilities to headquarters during synchronization in a multi-site deployment. The default logging level is DEBUG.

User Interface Log (spectrum-ui.log)

The User Interface (UI) Log includes errors that occur in the UI or browser to help with troubleshooting. You can enable UI logging for all users or for a single (current) user session.

  • To enable UI logging for all users, add the following system property in System System Management > System Properties:

    Namespace: systemManagement
    Key: ui.logging
    Value: true

  • To enable UI logging for the current user session, add ?uiLogging=true to the end of the Loftware Enterprise SP URL.

    Example

    https://www.example.com:8443/loftwarespectrum/main/jobStatus/searchName/?uiLogging=true

User Event Log (user-rules.log)

The User Event Log can be turned on to show user-defined log messages from business rules. The default logging level for this log is INFO.