Skip to main content

Documentation Portal

Plant Integrations (connector) logs

Plant Integrations generates log files for Connector (WebHost and AppHost) and additionally for ApiGateway and Configurator (AppHost only). Each component has its own separate log files stored in the logs folder.

Two file formats are generated per component:

  • Text logs (.txt)

    Traditional human-readable log files with the naming convention connector.log_<id>.txt

  • JSONL logs (.jsonl)

    Structured, machine-readable log files with the naming convention connector.log_<id>.jsonl

    The JSONL files contain the same log entries as the corresponding text logs, but more suited for log aggregation tools and automated parsing.

Rotation settings

Log file retention and size can be configured via the connector API (via Swagger) at the api/logging/file endpoint. The defaults are:

  • Logs rotate when they reach 10MB in size

  • A maximum of 4 files of each type are retained

  • Older files are automatically deleted when the limit is reached

Log level

The current log level can be viewed and updated via the API without accessing config files directly. Log level settings persist across application restarts. More information on log levels can be found here: How to change the connector log level?

Windows Event Log (AppHost only)

Logs for Connector, ApiGateway, and Configurator are also written to Windows Event Log, accessible via Event Viewer under Application and Services Logs > Plant Integrations. This enables centralized monitoring using native Windows tooling, built-in filtering, and task automation.

In this section: