Configuring ThousandEyes for OpenTelemetry Using the UI

This section describes how to create data streams using the ThousandEyes application UI. For information on creating integrations and data streams using the API, see Configuring ThousandEyes for OpenTelemetry Using the API

Prerequisites

To configure ThousandEyes for OpenTelemetry using the UI, ensure you meet the following requirements:

  • Your user role must have the following permissions:

    • Edit streaming integrations, to view and manage integrations.

    • View streaming integrations, to view details about integrations.

    • View labels, to assign API tags to an integration.

Create an Integration

Step 1: Create a ThousandEyes for OpenTelemetry Integration

To create a new integration, do the following:

  1. In the ThousandEyes platform, go to Integrations.

  2. Click + New Integration to open a menu for selecting the type of integration to configure.

  3. Choose ThousandEyes for OpenTelemetry to proceed to the configuration form.

Step 2: Fill Out the Configuration Form

Fill out the following mandatory fields:

  • Name: A name for your integration.

  • Target Type: Choose between GRPC and HTTP. These are the currently supported target types.

  • Target URL: The target URL of the integration, which may include the port, such as https://example.com:443.

    When you create a stream, the target URL must satisfy the Stream endpoint URL requirements.

  • Integration Status: Toggle the integration status to either enable or disable the integration upon creation.

Optional fields:

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

    • Splunk Observability Cloud

    • Grafana

    • Honeycomb

    • Signoz

    • Dynatrace

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

  • Auth Type: Set the authentication method for your stream integration:

    • Basic

    • Token

    • Custom

  • Custom Headers: This field contains key/value pairs that make up the integration’s HTTP header to a server. The key/value pairs you enter here are static (a set key and its set value).

    • To add additional key/value pairs to the header of your integration, click + New Header and enter the key and value.

    • To remove a key/value pair, click the - symbol.

  • Data Model Version: Determines how the telemetry data is represented in the OTel format. For more information, see ThousandEyes for OpenTelemetry Data Model.

Step 3: Configure the Test Data

Configure what data is streamed by selecting tests and tags associated with your current account group under Test Data Configuration:

  • Cloud and Enterprise Agent Tests: Select Cloud and Enterprise Agent test data that is available in your account group to stream to the target.

  • Endpoint Agent Tests: Similarly, select Endpoint Agent test data to stream to the target.

  • Tags: Select tags from your current account group to associate with the integration. Data from Cloud and Enterprise Agent tests and Endpoint tests tagged with the same tags selected in this dropdown will be streamed to the configured target.

Step 4: Save the Integration

After completing the form, click Save to create the integration. This integration will now be visible in the list view.

List Your Integrations

The Integrations page displays all types of integrations in a unified list view.

  • 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: Indicates that the integration is enabled.

      • Pending: Indicates that the integration is disabled.

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

Delete an Integration

To delete an integration, select the Delete option from the menu on the right of the integration entry.

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

    • Cloud and Enterprise Agent Tests

    • Endpoint Agent Tests

    • Tags

  3. Click Save to apply the changes.

PreviousConfiguring ThousandEyes for OpenTelemetry Using the APINextConfiguring ThousandEyes for Splunk Cloud or Enterprise using the API

Last updated