Examining Situate Logs

Situate agents and servers keep multiple types of log file to document the history of workflows, tasks and all manner of things in the Situate environment.

Agent Logs

Agent logs record information about each agent's actions. Agent logs are maintained on a daily basis and rolled to the Situate server automatically every night. The agent will keep the last 10 instances of each agent's logs, and automatically clean up additional files. Situate agent logs are located in INSTALLPATH/logs/situate.[iso-date].log.

Task Logs

Task logs include any output generated by an executed task directed to stdout or stderr. Task logs are maintained on the asset that executes each individual task. Each log is kept as a header and a body. These logs are located at INSTALLPATH/logs/tasklogs/[taskname].[workflow-instance].log and INSTALLPATH/logs/tasklogs/[taskname].[workflow-instance]-header.log for the body and header respectively. Since these logs are created by the processes executed via Situate there is no automated clean up process. It is generally advised for users to build a workflow or process to periodically clean old task logs.

Workflow Execution Logs

Workflow Execution logs record the status of each task executed in a workflow. Execution logs are stored in a proprietary format. Execution logs are recorded by the Situate server at INSTALLPATH/data/workflow/execlogs/[workflow-id]/[workflow-instance-id].ser. The quantity of these logs is controlled by each workflow's log retention policy.

Debugger Logs

Debugger Logs are created whenever a workflow runs that has debugging turned on. Debug logs are stored in a proprietary format in the file INSTALLPATH/data/workflow/execlogs/[workflow-id]/[workflow-instance-id].dbg. Debug logs are removed whenever the corresponding workflow execution log is cleaned.

Audit Log

The Audit log records every action undertaken in a Situate domain. Audit logs are stored in a RDBM system via an HSQL database located in the directory INSTALLPATH/database/. Audit logs are kept for 90 days by default, however this can be changed by modifying daysOfAuditToKeep in the property file INSTALLPATH/data/extended-config.properties. The Situate server will automatically clean the audit logs.