Pipeline logs tab
View logs generated during a pipeline execution, filtered by level.
The Pipeline logs tab displays logs generated during pipeline
execution. In the Pipeline executions page, select View
logs from the three-dot menu of the pipeline to view the Pipeline logs.
The pipeline execution is stored in the Platform for 45 days and in Runtime Archive for up to two years. Environment admins can use the Runtime Archive to download the older logs. You can configure the log file size and the number of log files retained on the Snaplex.
- In certain Environments, if a JCC node is evicted, replaced, or scaled down, the local log data on that instance is permanently lost and cannot be recovered from the Pipeline logs tab.
- The 45-day retention period applies only to execution records and runtime details in Monitor, such as status, duration, and statistics. It does not apply to the pipeline log files, which are stored locally on the executing node.
- Log availability depends on the node's log rotation policy. Logs may become unavailable well before 45 days if the data on the node is deleted or the node is not available at the time when the user requests the log.
Pipeline logs are read from the /opt/snaplogic/run/log directory on the
Snaplex node. Logs are therefore available only if:
- The Snaplex node is up and running.
- The log files for the requested execution have not been rolled over or removed from the node.
For persistent and reliable log access, especially in Elastic or K8s Groundplex deployments, we recommend that you configure external log forwarding, for example via OpenTelemetry to an external observability platform such as Datadog.
You can filter logs by the following options:
- ALL displays all log messages.
- INFO messages record normal operational activity.
- WARN messages flag potential issues that didn't stop execution — review them even on successful runs to catch misconfiguration or deprecated behavior.
- ERROR messages indicate failures that caused the pipeline to stop or produce incomplete results.
From this tab you can:
- Download logs as a JSON file, or download a full runtime dump that includes Snap statistics, logs, pipeline parameters, and state transition data. Use the download icon in the panel header to access both options.
- With the optional Telemetry subscription, Groundplex users can forward pipeline logs to third-party observability tools using the OpenTelemetry (OTEL) standard, enabling centralized log aggregation, alerting, and distributed tracing outside of SnapLogic. Refer to Third-party observability tools.