# 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](/files/QpBRkEp4CmY6PwnhZYQ9)

* **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](/files/0cXp2T657BPgocj1Dl4l)

### 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](/files/8BrD6RcJ65rhLoc3poL6)

### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thousandeyes.com/product-documentation/integration-guides/opentelemetry/manage-integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
