Skip to main content

On-prem client logs

Monitor the health and activity of your On-Premise Clients (OPC) through local log files. These logs are essential for troubleshooting connection issues, tracking extraction performance, and auditing agent activity.

Accessing your on-prem client logs

To access your on-prem client logs in the Celonis Platform:

  1. Click Admin & Settings - On-prem clients.

  2. For your client you want to view, click Options - Logs.

Available client logs

Here's the list of all available OPC log types with their details:

Log name

Purpose

Location

Retention period

CelonisAgent.err.log

Produced by the running OS service of the Agent. Contains errors sent to stderr by the Agent.

..\Celonis On-prem Clients\AGENT_TYPE\logs

Unlimited; Manually deleted, not removed automatically.

CelonisAgent.out.log

Produced by the running OS service of the Agent. Contains logs sent to stdout by the Agent

..\Celonis On-prem Clients\AGENT_TYPE\logs

Unlimited; Manually deleted, not removed automatically.

CelonisAgent.wrapper.log

Produced by the running OS service of the Agent. Contains logs produced by the service itself.

...\Celonis On-prem Clients\Extraction Agent\logs

Unlimited; Manually deleted, not removed automatically.

YYYY-MM-DD.n.log

Produced by the Agent process itself

..\Celonis On-prem Clients\AGENT_TYPE\logs\YYYY-MM-DD

28 days by default. Scheduled using using the application-local.yml file. See Setting up retention periods for the logs on the extractor server.

YYYY-MM-DD

Produced by the OPC Management Tool. Folder will be contained in the same location as the opc-management-tool executable

..\Celonis On-prem Clients\Shared\logs

Unlimited; Manually deleted, not removed automatically.

Related topics