Configuring diagnostic settings - Developer Documentation
Skip to content

Configuring diagnostic settings

Buffer Mechanism

In buffer mechanism, there are two options:

  • Default Buffer Mechanism: It provides parallel upload from cache and real time data. It prioritizes newest data to old data while storing (works as a last in, first out (LIFO))
  • Chronological Buffer Mechanism: It is chronological upload of data. If "Chronologic Upload" is selected, the buffer mechanism will prioritize oldest data to new data (works as first in, first out (FIFO)).

You can configure the buffer behavior from "Network and Diagnostic Settings" screen.


If the buffer behavior is changed, it will restart the data collection process and this process will take few minutes.

Data loss

The data collection will be stopped during the time of buffer behavior change. The amount of data collection is stopped for few minutes, it depends on restart of the device. It may take longer time on slow devices like, IoT2040.

To perform a buffer behavior change proceed as follows:

  1. In "Asset" tab, select the asset.
  2. Open "MindConnect" plugin.
  3. Click Settings, next to "Onboarding Status".
  4. In "Buffer Behavior" section, select "Chronological Upload".
  5. Click “Save”.


Chronologic Upload Specification

  • If there is a bad network connection or no connection at all, the data is going to be stored in cache memory. In "Chronologic Upload", overwritten of cache memory is not possible. Only if there is any space on cache memory, the data is going to be written to it. If the cache memory reaches out it's limit and filled with data, then the data is not going to be saved on cache memory. It will cause data loss until some data is uploaded.
  • As chronological upload the flow of real data to cloud will take longer time comparing to default behavior.
  • The events are not cached in any case of the disconnection. Therefore, "Chronologic Upload" is not applicable for the event upload.

Diagnostic Settings

This section contains the configurations related with logging. To perform a diagnostic settings change, follow these steps:

  1. In "Asset" tab, select the asset.
  2. Open MindConnect plugin.
  3. Click Settings, next to "Onboarding Status".
  4. In “Diagnostic Settings” section, make the changes in Auto Log Upload or Log Level.


  5. Click “Save”.

Auto Log Upload

If Auto Log Upload is enabled, the device is going to upload all generated logs to Insights Hub periodically. Log upload functionality for the device is enabled by default.

Auto log upload enabled

Log Levels

Log level represents the log level of MindConnect device. There are five possible log levels, and the hierarchy is as follows in lowest (TRACE) to highest (ERROR) priority. In “TRACE” mode, the device will log extensively and in “ERROR” mode device will only log error messages.


The selected log level and logging mechanism works as logging only selected level and the higher levels.

Log level is set to “INFO” by default.

Auto Log Level Change

  • “TRACE/DEBUG” log levels provide more verbose logs which will be helpful to troubleshoot issues, however they produce more files. If the log level is set to “TRACE/DEBUG”. It will be automatically changed to INFO after one day.
  • Auto log level change operation will not be synchronized with the asset’s device configuration.

Upload Logs Now

If you click “Upload Logs Now”, the device immediately uploads latest logs to Insights Hub regardless Auto Log Upload status. It can be used for troubleshooting purposes.

Upload Logs Now Image

Remote Services Integration

The integration of Remote Services to MindConnect IoT2040 aims to provide solution for accessing factory related device via IoT2040. There are plenty of different services and protocols offered by MRS to connect to the field devices and data. For more information on MRS application, refer to Remote Services documentation.

To integrate MRS application with MindConnect IoT2040, follow these steps:

  1. Create asset.


To create an asset, see Creating an asset for MindConnect IoT2040.

  1. Onboard agent.


To onboard an agent, see Overview of onboarding MindConnect IoT2040.

  1. Link asset id with MRS application.
  2. Enable MRS Services on the agent using toggle button and configure use cases in MRS applications.
  3. Click "Save".


  • Be aware that enabling MRS application might effect on the time-series data transfer. Ensure that MindConnect IoT2040 is able to perform operations smoothly via Insights Hub Monitor occasionally.
  • MRS Application does not support proxy authentication, thus enabling the proxy authentication will disable the MRS application if it is enabled.


  • Starting or stopping MRS application is an asynchronous task, during this ongoing phase the toggle on or off operations will be neglected.
  • MRS application itself has a separate management system of devices, the user needs to create a device on MRS application and associate it with MindConnect IoT2040’s asset via their id’s. Thereafter, user can be able to enable the application from the MindConnect element UI.
  • If the MRS application is not provisioned for the customer tenant then the user will not be able to enable the application and will see the below message on MindConnect element UI. To provision the application contact Support Team.

Last update: November 21, 2023