Logging on Linux¶

The Output Engine log data is administrated and visualized by means of SEAL Elastic Stack.

Display the Log Data of PLOSSYS Output Engine via Kibana¶

The log data of PLOSSYS Output Engine can be displayed and evaluated via the Kibana user interface.

For how to open the Kibana user interface, refer to the SEAL Elastic Stack.

Set the Log Level¶

For setting the log level for all services of PLOSSYS Output Engine or a specific one, the following key has to be set for any or for a specific service:

LOG_LEVEL: Log level for the correspondent service

Example - setting key via PLOSSYS CLI for all services

plossys config set LOG_LEVEL debug

Example - setting key via PLOSSYS CLI for the seal-rest service

plossys config set LOG_LEVEL debug --service seal-rest

For available values for the log level, refer to LOG_LEVEL.

Log Audit Data¶

For specifying audit data, the current configuration of the services for example, the following keys are available:

AUDIT_LOG: Logging of audit data
AUDIT_LOG_USER: Logging of the user names in the audit data
JWT_USERNAME: Property name set in the JSON Web Token (JWT) for accessing the user name

Log the Job Metadata¶

For logging all job properties, the following key has to be set for the seal-ipp-checkin or the seal-ipp-checkin service:

The LOG_FULL_JOB_PROPERTIES: Logging of the job metadata

Show the Log File of a Specific Service¶

plossys log show <service_name>

Show the Log File of a Specific Job¶

plossys job logs <job_id>

Show the Temporary Files of a Specific Job¶

plossys job tempfiles <job_id>

Log Files¶

PLOSSYS Output Engine and Infrastructure Services¶

The log files of the Output Engine and infrastructure services such as MongoDB or Consul are located in the following directory:

/var/log/seal

System and Service Manager `systemd`¶

For the logging of the system and service manager, systemd, refer to the documentation of your Linux distribution.

File Size¶

In order to control the size of the log data, the log files are rotated. For this purpose, the configuration file /etc/logrotate.d/plossys is created during the installation.