Configuring diagnostic settings for MindConnect Software Agent - Developer Documentation
Skip to content

Configuring diagnostic settings for MindConnect Software Agent

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, Software Agent.

To perform a buffer behavior change proceed as follows:

  1. In "Asset" tab, select the asset.
  2. Open "MindConnect" plugin.
  3. Click setting-icon, next to "Onboarding Status".
  4. In "Buffer Behavior" section, select "Chronological Upload".


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

Last update: August 28, 2023