Manage Connectors
After you add connectors to Manufacturing Connect Edge, you can navigate to the Integration pane to manage them.
You can filter and search for connectors from the Integration pane by clicking the Toggle Connector Filter icon.
Refer to the image and callouts below for management options for connectors.
Note: As of Manufacturing Connect Edge version 3.10.0, Manage Tags is updated to Manage Topics.
[1] Action menu
- Edit connector: Update the fields for the connector.
- Remove connector: Remove the connector from the Integration pane.
[2] Enable/Disable connector: Use the toggle to enable or disable the connector. The status will update to one of the following: Connected, Failed, or Disabled.
[2] Copy Instance identifier
When you enable logging for a connector, the log displays connection and publish-based error messages. This can increase CPU usage. Therefore, it is preferable to use logging only for debugging.
Notes:
- The connector must be added and connected before logging can be enabled.
- With the exception of the default connector, all connectors have logging capability.
- Clicking the connector tile shows the details for the connector. You can view the logs section from there.
- You can download and refresh log files from the Details pane.
To enable logging:
- From a connector tile within an Integration pane, click the Edit icon. The Edit Connector dialog box appears.
- Select the Enable logging check box, and then click Update.
You can access device information and edit options by clicking the connector tile.
After clicking a connector tile, the dashboard for the connector displays.
The dashboard displays the following information for the connector:
- Size on Disk
- Disk Usage
- Persistence Size
For Disk Usage and Persistence Size, you can use the icons to manipulate the charts and also download the charts in SVG, PNG, or CSV format.
The Configuration tab allows you to review and update the fields for the connector.
Make updates as needed and click Update.
The Topics tab allows you to add and manage topics for the connector.
Refer to the image and callouts below for options in the Topics tab.
[1] Show filter: Search for topics.
[2] The Add icon allows you to add topics individually or by CSV upload (as of Manufacturing Connect Edge 3.8.0).
- Add a new subscription: Add a topic to the connector. See the "Add a Topic to a Connector" section below to learn more.
- Upload CSV: This option is available for Manufacturing Connect Edge version 3.10.0 and later. You can upload a csv file of topics.
[3] (Available for Manufacturing Connect Edge version 3.10.0 and later) The Download icon allows you to download a CSV file of current topics in the connector or a sample of a CSV file you can use to upload.
- Download a sample: Download a sample file that you can use to upload a number of topics for the connector.
- Download CSV: Download a file of current topics in the connector.
[4] Import from DeviceHub tags: Import outbound topics to a connector from the DeviceHub tags. If you import DeviceHub tags for a CONNECTED connector, the connector will need to restart. All topics will be disabled upon initial import.
[5] Enable all topics: Enable all topics listed in the pane.
[6] Disable all topics: Disable all topics listed in the pane.
[7] Delete all topics: Delete all tags in the pane.
To view the Logs tab, you must enable logging for the connector. To enable logging, edit the connector and select the Enable logging check box.
From the Logs tab, you can download a file of the log, refresh the log, and clear the log (available for Manufacturing Connect Edge 3.10.0 and later).
In the course of its operation, a connector persists inbound and outbound data. You might need to periodically purge the connector's data storage to avoid excessive use of disk space. Select this option to empty the connector's data storage.
See Add Topics to Connectors to learn about the different ways to add topics.
You can manage connector topics from the Topics tab.
To manage a topic, click the Action menu for the topic.
- Edit: Update the parameters for the topic. You can also click the topic name to update parameters.
- Remove: Remove the topic from the connector.
- Enable/Disable: Enable or disable the topic for the connector.