# Manage Integrations

This guide provides instructions for managing ThousandEyes OpenTelemetry integrations, including listing, editing, and deleting integrations, as well as customizing advanced configuration options.

## Common Use Cases

* **Updating a Target URL**: Use the **Edit** functionality (via UI or API) to update the `streamEndpointUrl` when migrating to a new endpoint.
* **Managing Authentication**: Add or update headers to align with changes in your endpoint’s authentication requirements.

## Supported Signals by Test Type

The OpenTelemetry signals (metrics, traces, logs) available for an integration depend on the test types you select.

* For a full matrix of which signals are supported per ThousandEyes test type, see [Support and Limitations](https://docs.thousandeyes.com/product-documentation/integration-guides/opentelemetry/support-and-limitations).
* For details on what each signal represents and when to use it, see [Supported Signals](https://docs.thousandeyes.com/product-documentation/integration-guides/opentelemetry#supported-signals).

## Manage Integrations Using the UI - Integrations 1.0

### List Integrations

The **Manage > Integrations > Integrations 1.0** page displays all types of integrations except Splunk Observability Cloud or Enterprise in a unified list view.

![Integrations List](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-998e28518e307c39c82e8092a14251b15abfa8e8%2Fproduct-documentation_integration-guides_custom-built-integrations_opentelemetry-list-integrations-view.png?alt=media\&token=37e58a27-f821-4f93-8658-7058fa7ab1a2)

* **Search and Sort**: Use the search bar to find integrations by name, type, or target. Sort the list by clicking on the column headers.
* **Table Columns:**
  * **Name**: The name of the integration.
  * **Type**: The integration type.
  * **Status**: The status of the integration.
    * **Connected:** Data is being sent to the integration's target.
    * **Pending:** No data is currently being sent to the integration's target.
    * **Failed**: Data could not be sent to the integration target.
  * **Target**: The URL of the target of the integration.
  * **Supported Services**: The services the integration supports.
* **Actions**: On the right side of each integration row, click the menu icon to access additional options to **Edit** and **Delete** integrations.

### Edit an Integration

To edit an integration:

1. Click on the integration row or select **Edit** from the menu.
2. Modify the editable fields, which include:
   * **Name**
   * **Integration Status**
   * **Auth Type**
   * **Custom Headers**
   * **Network & App Synthetics Tests**
   * **Endpoint Experience Tests**
   * **Tags**
3. Click **Save** to apply the changes.

### Delete an Integration

1. Navigate to the **Integrations** page.
2. Locate the integration you want to delete.
3. Select the **Delete** option from the menu on the right of the integration entry and confirm the action.

### Advanced Configuration Options in the UI

Customize your integration using the following fields:

| **Field**                 | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Preset Configurations** | <p>These optional preset configurations provide a starting place from which you can create your stream integration. If you use a preset configuration, it populates the fields below with sample content that you can adapt.</p><p><strong>Note</strong>: These preset configurations can serve as a guide, but you should verify that the resulting integration’s structure and variables meet your requirements.</p><p>You can use any of the following preset configurations for your stream integration:</p><ol><li>Splunk Observability Cloud</li><li>Grafana</li><li>Honeycomb</li><li>Signoz</li><li>Dynatrace</li></ol><p><strong>Caution</strong>: When you select a preset configuration, any settings you have already made in the fields are deleted.</p> |
| **Auth Type**             | Choose from **Basic**, **Token**, or **Custom** authentication methods.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Custom Headers**        | Add key-value pairs for HTTP headers. Use **+ New Header** to add more fields.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Data Model Version**    | Select between v1 and v2 OpenTelemetry data models. For more information, see[ ThousandEyes for OpenTelemetry Data Model](https://docs.thousandeyes.com/product-documentation/integration-guides/opentelemetry/data-model).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

## Manage Integrations Using the UI - Integrations 2.0

### List Integrations

The **Manage > Integrations > Integrations 2.0** page displays all Splunk Observability Cloud or Enterprise integrations in a unified list view. Connectors and Operations are listed separately.

### Connectors

* **Search and Sort**: Use the search bar to find connectors by name, type, or target. Sort the list by clicking on the column headers.
* **Table Columns:**
  * **Connector Name**: The name of the connector.
  * **Type**: The type of the connector.
  * **URL**: The URL of the target of the connector.
  * **Assigned Operations**: The list of operations assigned to the connector.
* **Actions**: On the right side of each connector row, click the menu icon to access additional options to **Edit**, **Manage Operations** and **Delete** connectors.

![Connectors List](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-41fa60f37cf4a44b337be60a3073040e74f2eaa2%2Fproduct-documentation_integration-guides_custom-built-integrations_splunk-enterprise-list-connectors-view.png?alt=media)

### Operations

* **Search and Sort**: Use the search bar to find operations by name, type, or target. Sort the list by clicking on the column headers.
* **Table Columns:**
  * **Operation Name**: The name of the operation.
  * **Enabled**: Indicates whether the operation is enabled.
  * **Status**: The status of the operation.
    * **Connected:** Data is being sent to the associated connector's target.
    * **Pending:** No data is being sent to the associated connector's target.
    * **Failing**: Data could not be sent to the associated connector's target.
  * **Type**: The type of the operation.
  * **Connector Name**: The name of the connector associated with the operation.
* **Actions**: On the right side of each connector row, click the menu icon to access additional options to **Edit**, **Assign Connector** and **Delete** operations.

![Operations List](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-41a11e0fa07efa69740724f8d193382181ac66d3%2Fproduct-documentation_integration-guides_custom-built-integrations_splunk-enterprise-list-operations-view.png?alt=media)

### Delete an Integration

To completely remove an integration, delete the operation associated with the connector, then delete the connector.

To delete an operation or connector, select the **Delete** option from the menu on the right of the operation or connector entry.

**Note:** If you delete a connector with an operation already associated with it, that operation will no longer work until a new connector is associated with it.

### Edit an Integration

#### Edit a Connector

To edit a connector:

1. Click on the connector row or select **Edit** from the menu.
2. Modify the editable fields, which include:
   * **Name**
   * **Target**
   * **Auth Type**
   * **Token**
3. Click **Save** to apply the changes.

**Note:** For Splunk operations to function correctly, the Auth Type must be set to "Other Token", and it must include a valid Splunk HEC token.

#### Edit an Operation

To edit an operation:

1. Click on the operation row or select **Edit** from the menu.
2. Modify the editable fields, which include:
   * **Operation Name**
   * **Index**
   * **Source**
   * **Source Type**
   * **Operation Status**
   * **Network & App Synthetics Tests**
   * **Endpoint Experience Tests**
   * **Tags**
3. Click **Save** to apply the changes.

## Manage Integrations Using the API

For more information on how to list, edit, and delete integration using the API, see [ThousandEyes for OpenTelemetry API](https://developer.cisco.com/docs/thousandeyes/v7/thousandeyes-for-opentelemetry-api-overview/).

## Updating Data Model Versions

You cannot change the data model version after creating an integration. To use a different data model version (for example, migrating from v1 to v2), you must delete the existing integration and create a new one with the desired data model setting.
