Skip to main content

Documentation Portal

How to fetch Plant Integration (connector) logs?

Plant Integrations logs can be fetched in three ways: via ConfigHub (recommended), via the API endpoint or manually from the server.

Option 1 — Download via ConfigHub

  1. Open ConfigHub -> Connectors.

  2. Select the connector you want to download logs from.

  3. Under 'Options' select "Download logs".

    ConfigHub will automatically collect the logs and download them as a ZIP file.

    Notice

    For custom connector implementations and connector versions below 4.105.1, the "Download logs" option is not available. If the user clicks the button, an error will be returned.

confighub-download-logs.png

Option 2 — Via API endpoint

  1. Open a browser and navigate to the Swagger UI of your connector: https://<your-connector-url>/swagger

  2. Locate the Logging section.

  3. Expand the GET /api/logging endpoint.

  4. Click Try it out, then Execute.

  5. Wait for the response to load, then click Download file to download the returned .zip file — it contains all log files present in the connector's logs folder.

2026_R1_PlantIntegrations_Swagger_GetLogs.png

Option 3 — Manually from the server

  1. Log in on the Plant Integrations (connector) server.

  2. Open the folder C:/…/<my-connector>/logs

    2026_R1_PlantIntegrations_LogsFolder_1.png
  3. Select all log files and compress them into a .zip file. 

    2026_R1_PlantIntegrations_LogsFolder_2.png

    Note

    Plant Integrations generates two types of log files, each with its own numbering sequence: text logs (connector.log_<id>.txt) and JSONL logs (connector.log_<id>.jsonl). Both contain the same entries — the JSONL format is simply a structured alternative that makes it easier to process logs programmatically, integrate with aggregation tools, and run automated diagnostics.

To upload the logs to the TrendMiner file server
  1. Open the browser and browse to https://files.trendminer.com

    files_trendminer_com.png
  2. Log in using your TrendMiner file server credentials. If you don't know these or your credentials are not working, please contact your TrendMiner Customer Success Manager or send a support request to support@trendminer.com

    files_trendminer_com-login.png
  3. Click on upload.php

    files_trendminer_com-upload.png
  4. Select your file and enter your company or plant name and click 'Send File'.

    files_trendminer_com-upload2.png