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.

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
  • 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

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.

Note: These preset configurations can serve as a guide, but you should verify that the resulting integration’s structure and variables meet your requirements.

You can use any of the following preset configurations for your stream integration:

  1. Splunk Observability Cloud

  2. Grafana

  3. Honeycomb

  4. Signoz

  5. Dynatrace

Caution: When you select a preset configuration, any settings you have already made in the fields are deleted.

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.

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

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

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.

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.

Last updated