---
title: Manage Connectors
slug: bhdo/manage-connectors
createdAt: 2022-08-18T22:54:16.000Z
---

After you add connectors to Belden Horizon Data Operations, you can navigate to the **Integration&#x20;**&#x70;ane to manage them.&#x20;

# Filter and Search Connectors

You can filter and search for connectors from the *Integration&#x20;*&#x70;ane by clicking the **Toggle Connector Filter** icon.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/qM7AFJ4paAA21jmHYsX2B_filter-icons.png" size="80" width="1042" height="614" caption="Toggle Connector Filter icon" position="center" showCaption="true"}

# Manage Individual Connectors

Refer to the image and callouts below for management options for connectors.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VpLePcnO_B_TLsPjj2pGY_image.png" size="70" width="380" height="294" caption="Management options for connectors" position="center" showCaption="true"}

\[1] **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`.&#x20;

\[2] **Copy Instance identifier**

\[3] **Edit connector**: Update the fields for the connector.&#x20;

\[4] **Purge connector**: 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.&#x20;

\[5] **Remove connector**: Remove the connector from the *Integration&#x20;*&#x70;ane.&#x20;

# Enable Logging

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.

:::hint{type="info"}
**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&#x20;*&#x70;ane.
:::

**To enable logging:**

1. From a connector tile within an *Integration&#x20;*&#x70;ane, click the **Edit** icon.
   The *Edit Connector* dialog box appears.
2. Select the **Enable logging** check box, and then click **Update**.
   The *Logging&#x20;*&#x69;con appears on the connector tile indicating that logging is active.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/c4pq2b2JY9PRjZNobGRqy_image.png" size="70" width="361" height="274" caption="The enable logging icon" position="center" showCaption="true"}

# Access Connector Information

You can access device information and edit options by clicking the connector tile.&#x20;

## Connector Dashboard

After clicking a connector tile, the dashboard for the connector displays.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/cR4kD3MN3Pc9Lx8SuUqIv_connector-dashboard.png" size="80" width="999" height="683" caption="The Connector dashboard" position="center" showCaption="true"}

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.&#x20;

## Connector Configuration

The *Configuration&#x20;*&#x74;ab allows you to review and update the fields for the connector.&#x20;

Make updates as needed and click **Update**.&#x20;

## Connector Topics

The *Topics&#x20;*&#x74;ab allows you to add and manage topics for the connector.&#x20;

Refer to the image and callouts below for options in the *Topics&#x20;*&#x74;ab.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4dnGFs5QYaEQlfTApqtIg_connector-topics.png" size="80" width="1144" height="683" caption="Connector Topic options" position="center" showCaption="true"}

\[1] **Show filter**: Search for topics.&#x20;

\[2] **Add a new subscription**: Add a topic to the connector. See the "Add a Topic to a Connector" section below to learn more.&#x20;

\[3] **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.&#x20;

\[4] **Enable all topics**: Enable all topics listed in the pane.&#x20;

\[5] **Disable all topics**: Disable all topics listed in the pane.&#x20;

\[6] **Delete all topics**: Delete all tags in the pane.&#x20;

## Connector Logs

To view the *Logs&#x20;*&#x74;ab, you must enable logging for the connector. To enable logging, edit the connector and select the **Enable logging** check box.&#x20;

From the *Logs&#x20;*&#x74;ab, you can download a file of the log and refresh the log.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/pSGHYsEXV9ATfR888v-Ms_connector-logs.png" size="80" width="1004" height="526" caption="The Connector Logs tab" position="center" showCaption="true"}

# Add a Topic to a Connector&#x20;

You can add inbound and outbound topics to a connector. To automatically import tags to create outbound topics, you have the option of clicking the **Import from DeviceHub tags&#x20;**&#x69;con.&#x20;

:::hint{type="info"}
**Note**: If you add topic to a `CONNECTED` connector, the connector will need to restart.&#x20;
:::

## Before You Begin

Before adding a topic, make sure you do the following:

- Add a device and at least one tag. See [Connect a Device](docId\:FzHgH9_zgcK06u648n-cR) and [Add Tags](docId:4Y_4F9l-R7iRmK69LmEoZ) to learn more.&#x20;
- Add a connector. See [Add a Connector](docId\:fH_ZnNUNA4eW64gyzeLkm) to learn more.&#x20;
- Copy a *Raw Topic* for an existing tag. See [Manage Tags](docId\:G4wBF95UqzTy3Oa1M0Py8) for more information.

**To add a topic to a connector:**

1. From the *Integration&#x20;*&#x70;ane, click the connector tile you want to add the topic to.&#x20;
2. Click the **Topics&#x20;**&#x74;ab.
3. Click the **Add a new subscription** icon. The *Data Integration* dialog box appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/SLpcAoh55Uyu5qb4o8mdY_add-connector-topic.png" size="80" width="1004" height="512" caption="The Add a new subscription icon" position="center" showCaption="true"}
4. Select a data direction from the *Data Direction* drop-down list.&#x20;
   - **Local to Remote - Inbound**
   - **Remote to Local - Outbound**
5. In the **Local Data Topic** field, paste the *Raw Topic&#x20;*&#x63;opied for the device tag.
6. The **Remote Data Topic** field may have a default value for the *Integration topic* parameter of the connector. If the field is blank,  enter the remote data topic name. &#x20;
7. Enter a short description in the **Description** field.
8. (If available) From the **Qos** dropdown menu, select a [Quality of Service](https://www.hivemq.com/blog/mqtt-essentials-part-6-mqtt-quality-of-service-levels/) value .
   Available values: `default`, `0`, `1`, `2`
9. Click the **Enable** toggle to enable the connection.
10. Click **OK**.
    If the connector is CONNECTED, the *Confirmation&#x20;*&#x64;ialog box appears.
11. Click **Yes**. Follow the prompt to restart the connector.
    The new topic appears on the Topics pane and is enabled.

# Manage Connector Topics

You can manage connector topics from the *Topics&#x20;*&#x74;ab.&#x20;

To manage a topic, click the **Action menu** for the topic.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/l1uJdIqvZ0t9an7rc2nP__manage-connector-topics.png" size="80" width="1095" height="478" caption="The action menu for a connector topic" position="center" showCaption="true"}

- **Edit**: Update the parameters for the topic. You can also click the topic name to update parameters.&#x20;
- **Remove**: Remove the topic from the connector.&#x20;
- **Enable/Disable**: Enable or disable the topic for the connector.&#x20;

