Skip to content

Diagnosing MindConnect Software Agent

The MindConnect Software Agent's web UI provides a diagnosis tab to display diagnosis messages and download diagnosis, log and system files.

Diagnosis tab

In the navigation menu, click "Diagnosis" tab to open the "Diagnosis" area. It provides following features:


① Diagnosis messages

② Diagnosis files

③ Network analysis

Diagnosis messages

The "Diagnosis messages" section provides a list of currently stored diagnosis messages in the web UI of the following components in separate sub-tabs:

  • Box manager: Shows current states like onboarding, network connection, or data source connection states.
  • Data provider: Shows diagnosis messages of Modbus TCP, Rockwell and system information data sources.


Diagnosis messages of OPC UA and S7 data sources are currently not available.

  • MCSA: Shows diagnosis information of the internal MindConnect Software Agent.


Currently unexpected errors and file transfer settings related messages will be shown.

In “Diagnosis messages” section, the last diagnosis message will be displayed. You can download the previous diagnosis messages from the “Diagnosis files” section.

If the diagnosis messages section is open for a long time, the last 50 diagnosis messages will be displayed.

With the "Delete messages" button, the internal buffer of the currently visible component's diagnosis buffer will be deleted.

Diagnosis files

In “Diagnosis files” section, you can download the following kind of diagnosis files:


① Log files

② System files

③ Diagnostic files

To download the diagnosis files, select the checkbox. Thereafter, click "Get files" button to start the collection and preparation process. When the preparation process completed, the download buttons will be enabled, and you can the download the created diagnosis file packages by clicking download buttons.


If the files are not downloaded by the browser, check the download is blocked by the browser and enable the download for MindConnect Software Agent.

Network analysis

Cloud connection check

In “Network Analysis” section, a cloud connection check can be executed to verify the connection to Industrial IoT cloud is possible. By clicking the "Start" button an automatic cloud connection check will be executed by MindConnect Software Agent.


After the test has been executed the following test results will be shown:

  • Start and end time of the test in UTC format.
  • Current IP addresses of web and production interfaces.
  • Result of direct connection test.
  • Result of connection test via proxy server if the proxy server is configured in asset manager.
  • Proxy server and proxy authentication info if they are configured in asset manager.

After clicking the "Details" button the result log of the executed cloud connection check will be shown in a dialog. The result log can also be downloaded as a file by clicking the "Result file" button.

Cloud connection check status

The current status and the final status at the end of the command execution will be shown in the cloud connection check status area.


  • It might be possible that the execution of the cloud connection check will take some time depending on the current network configuration.
  • This feature is available with MindConnect Software Agent V03.06.00.04 b006 or higher.

Cloud connection status messages are also available in the MCSA tab in the diagnosis messages section.

Last update: January 22, 2024