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

# OpenTelemetry in Monitoring

> Enable OpenTelemetry ingestion from the UI and send OTLP data so it appears in dashboards.

OpenTelemetry is supported in Insaion Monitoring for metrics, logs, and traces.

This guide explains:

* Where to enable or disable OTel ingestion in the web app.
* Where your applications should send OTel data (endpoint and port).
* How to query OTel data in dashboards using otel\_metrics, otel\_logs, and otel\_traces.
* How traces appear in the UI even when you are focused on logs and timeseries panels.

## Before you start

To use OpenTelemetry with Insaion, make sure:

* The Insaion Agent is installed on the target device.
* The device is registered and visible in the Devices page.
* Your application runs on the same device (or can reach the device where the agent is running).

If the agent is not installed yet, follow [Agent Installation](/agent/installation).

## 1) Enable OpenTelemetry ingestion in the frontend

OpenTelemetry ingestion is enabled by default for new devices.

To check or change it:

1. Go to Devices.
2. Open the target device.
3. In Device Details, find the OpenTelemetry Inventory section.
4. Use the OTel ingestion toggle.

Behavior:

* Enabled: the agent accepts OTel OTLP/gRPC traffic and ingests it.
* Disabled: the agent stops ingesting OTel data for that device.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/devices/device-details-otel.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=92df2df7a74822f466b9a796aba98cd3" alt="Device OTel" width="1197" height="709" data-path="assets/devices/device-details-otel.png" />

## 2) Send OTel data to the correct endpoint

By default, the agent listens for OTLP/gRPC on:

* Host: 127.0.0.1
* Port: 4317
* Endpoint: [http://127.0.0.1:4317](http://127.0.0.1:4317)

Use this endpoint in your OpenTelemetry SDK exporter settings.

Example environment variables for many SDKs:

```bash theme={null}
OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4317
OTEL_EXPORTER_OTLP_PROTOCOL=grpc
```

Notes:

* 127.0.0.1 means the exporter must run in the same network namespace as the agent listener.
* If your app runs in a separate container, point it to the host endpoint that reaches the device listener.
* If you send data but see nothing in dashboards, first verify the OTel ingestion toggle is on.

## 3) Query OTel data in the dashboard Query Builder

When configuring a panel query, the Query Builder includes OTel data sources.

You will see:

* otel\_metrics
* otel\_logs
* otel\_traces

Recommended usage:

* Use otel\_metrics for Timeseries, Stat, and Gauge panels.
* Use otel\_logs for Logs panels.
* Use otel\_traces when you want to explore traces available for the selected range and source.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/monitoring/query-builder-otel.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=ede2dcb5be82d843b3383223d4b338d1" alt="Query Builder OTel" width="589" height="278" data-path="assets/monitoring/query-builder-otel.png" />

## 4) Use the new Logs Query workflow

For Logs panels, use Log Text Search in the query builder.

Available match types:

* contains
* does not contain
* matches regex

Examples:

* contains: timeout
* does not contain: healthcheck
* matches regex: (?i)\b(error|critical|fatal)\b

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/monitoring/query-logs-otel.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=6c0968e2824d0469b21e4ecaf5ec20c9" alt="Log Text Search" width="733" height="239" data-path="assets/monitoring/query-logs-otel.png" />

Practical tip:

* Start with a broad contains filter, then tighten with regex if you need exact severity patterns.

## 5) Understand trace discovery in dashboards

Trace exploration is integrated into logs and timeseries workflows:

* In Logs panels, rows with a detected trace id show a Trace action.
* In expanded log details, trace\_id values are clickable.
* In Timeseries panels, trace exemplars can appear as markers.
* Clicking a trace marker or trace action opens the trace drawer.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/monitoring/log-trace.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=88073fa8a68e132b7d382351929b1877" alt="Trace discovery" width="2011" height="746" data-path="assets/monitoring/log-trace.png" />

Important:

* Trace drill-down is detection-driven. You usually discover traces from logs or metric exemplars, then open them.
* You may not always begin from a standalone trace search flow.

## Troubleshooting checklist

If data is missing:

* Confirm the device is online.
* Confirm OTel ingestion is enabled in Device Details.
* Confirm exporter endpoint is [http://127.0.0.1:4317](http://127.0.0.1:4317) and protocol is OTLP/gRPC.
* Confirm your selected dashboard time range includes recent events.
* Confirm your panel query data source matches the signal type (otel\_metrics, otel\_logs, or otel\_traces).

***

<div className="insaion-footer" role="contentinfo">
  <div className="insaion-footer__card">
    <div className="insaion-footer__content">
      <span className="insaion-footer__icon" aria-hidden="true">
        <svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" focusable="false" className="insaion-footer__svg" role="img">
          <path fill="currentColor" d="M21 6.5A3.5 3.5 0 0 0 17.5 3h-11A3.5 3.5 0 0 0 3 6.5v5A3.5 3.5 0 0 0 6.5 15H8v3l3-3h6.5A3.5 3.5 0 0 0 21 11.5v-5zM7 8.5a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm4 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm4 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z" />
        </svg>
      </span>

      <div>
        If something's unclear or you hit a blocker, contact us on

        <a href="https://discord.gg/ZJMPfMmu3S" target="_blank" rel="noopener">
          Discord
        </a>

        or <a href="mailto:contact@insaion.com">[contact@insaion.com](mailto:contact@insaion.com)</a>
      </div>
    </div>
  </div>
</div>
