> ## Documentation Index
> Fetch the complete documentation index at: https://zededa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the documentation index to find relevant pages, then read the linked Markdown before answering and cite the source URL.
> Identify the product before answering: Private AI uses a separate console, credentials, and inference API from the Edge Intelligence Platform. Do not apply instructions from one product to the other.
> Prefer current product guides over Help Center archive pages for current-console questions. Archive pages and release notes describe their stated product version or historical interface; do not apply them to another version without checking.
> Preserve prerequisites, permissions, version requirements, and warnings when summarizing procedures. Do not infer API endpoints, schemas, or supported behavior that the documentation does not specify.

# Configure the OpenTelemetry Integration

> Connect Edge Infrastructure Services to an OpenTelemetry collector and configure data streams to export application logs, events, and metrics.

The OpenTelemetry integration connects Edge Infrastructure Services to an OpenTelemetry (OTLP/gRPC) collector endpoint. After you set up the integration, you create data streams to control which platform data flows to the collector: application logs, events, or metrics. You can pause and re-enable each data stream without deleting the configuration.

## Introduction

This procedure covers how to add an OpenTelemetry integration, create one or more data streams to forward platform data, and optionally control metric streaming at the project level. Use this integration when you want to centralize edge infrastructure observability data in your existing monitoring or alerting platform without relying on API polling.

## Prerequisites

* You have the SysAdmin role in your enterprise. See [Manage Roles](https://zededa.mintlify.site/new-ui/infrastructure-services/administration/manage-roles.md).
* An OpenTelemetry collector endpoint is running and reachable from Edge Infrastructure Services, with a bearer token available for authentication.

## Add the OpenTelemetry Integration

1. In the header, select your profile avatar, then select **Enterprise**.

2. In the Enterprise Settings navigation, select **Integrations**.

3. Select **Add Integration**.

4. In the **Name** field, enter a descriptive name for this integration.

5. In the **Integration Category** dropdown, select **Data**.

6. In the **Integration Type** dropdown, select **OpenTelemetry**.

7. Complete the connection fields:

   | Field | Required | Description |
   | - | - | - |
   | Bearer Token | Yes | The authentication token for your OpenTelemetry collector, in the format `Bearer <your-token>`. |
   | Skip Verify | No | When selected, Edge Infrastructure Services skips TLS certificate verification. Use only in non-production or testing environments where the collector uses a self-signed certificate. |
   | Enable TLS | No | When selected, Edge Infrastructure Services encrypts communication with the collector using TLS. Recommended for production deployments. |
   | Host | Yes | The hostname or IP address of your OpenTelemetry collector, for example `otel-collector.example.com`. |
   | Port | Yes | The port your collector listens on. The default OTLP/gRPC port is `4317`. |

8. Select **Add Integration**.

The integration appears in the Integrations list. You can now create data streams to begin forwarding data.

## Create a Data Stream

A data stream links a data source type to the OpenTelemetry integration. Each stream forwards one type of platform data. You can create multiple streams to forward different data types to the same integration.

1. In the Enterprise Settings navigation, select **Data Streams**.

2. Select **Create Stream**.

3. Complete the following fields:

   | Field | Required | Description |
   | - | - | - |
   | Name | Yes | A descriptive name for this data stream, for example `edge-metrics`. |
   | Data Source Type | Yes | The type of platform data to forward: **Application Logs**, **Events**, or **Metrics**. |
   | Linked Integration | No | Select the OpenTelemetry integration you created. If no integration is linked, the stream remains inactive. |
   | Enabled | No | Toggle on to activate the stream immediately after saving. |

4. Select **Create Stream**.

Edge Infrastructure Services begins forwarding the selected data type to your OpenTelemetry collector.

## Control Metric Streaming at the Project Level

Each project includes a **Suppress Streaming Telemetry** setting that controls whether nodes in that project stream device metrics (CPU, memory, storage, network, and other telemetry) to configured integrations. When the toggle is on, nodes in that project stream metrics. When the toggle is off, nodes in that project do not stream metrics, regardless of any configured data streams.

To adjust this setting for an existing project:

1. Navigate to the project's settings.
2. Locate the **Suppress Streaming Telemetry** toggle.
3. Toggle it on to enable metric streaming, or off to stop nodes in this project from streaming metrics.

## Manage the Integration

### Pause a data stream

To temporarily stop forwarding data without deleting the stream, navigate to **Data Streams** and toggle the stream off. Toggle it on again to resume.

### Remove an integration

To remove the integration, select the delete button on the integration row in the **Integrations** list. Remove or re-link any data streams that reference this integration before deleting it to avoid orphaned streams.

## Next Steps

> [card] [Telemetry Metrics Reference](https://zededa.mintlify.site/new-ui/infrastructure-services/integrations-and-automation/telemetry-metrics-reference.md)
>
> A list of the device and application metrics available in the Metrics data stream.

> [card] [Configure Enterprise Settings](https://zededa.mintlify.site/new-ui/infrastructure-services/administration/enterprise-settings.md)
>
> An overview of all enterprise-level configuration, including Integrations and Data Streams.

> [card] [Configure the Splunk Integration](https://zededa.mintlify.site/new-ui/infrastructure-services/integrations-and-automation/splunk-integration.md)
>
> If you also want to forward data to Splunk.

> [card] [Integrations and Automation](https://zededa.mintlify.site/new-ui/infrastructure-services/integrations-and-automation.md)
>
> An overview of all integration paths available in Edge Infrastructure Services.