<!--startmeta
custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/logs/integrations/opentelemetry_logs.md"
meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/logs/metadata.yaml"
sidebar_label: "OpenTelemetry Logs"
learn_status: "Published"
learn_rel_path: "Logs"
keywords: ['opentelemetry', 'otel', 'otlp', 'logs']
message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE LOGS' metadata.yaml FILE"
endmeta-->

<!-- markdownlint-disable MD012 MD033 MD043 MD045 -->

# OpenTelemetry Logs


<img src="https://netdata.cloud/img/opentelemetry.svg" width="150"/>


The OpenTelemetry plugin by Netdata makes viewing, exploring and analyzing OpenTelemetry logs simple and efficient.

It receives OTLP-formatted log data and indexes it for fast querying. The logs are explored from the "Logs" tab of the Netdata UI, using the same powerful exploration interface used for systemd journal logs.

Follow [Ingest OpenTelemetry Metrics and Logs](https://github.com/netdata/netdata/blob/master/docs/opentelemetry/otlp-ingestion.md) for a maintained Collector configuration and end-to-end verification steps.


<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />

## Visualization

You can start exploring OpenTelemetry logs on the "Logs" tab of the Netdata UI.


## Key features

- Views logs ingested via **OpenTelemetry OTLP/gRPC** protocol.
- Allows filtering on **any log field** or **field value**, for any time-frame.
- Allows **full text search** (`grep`) on all log fields, for any time-frame.
- Provides a **histogram** for log entries over time, with a breakdown per field-value, for any field and any time-frame.
- Uses **fast indexed lookups** with pre-built indexes for performance.
- Supports **faceted search** across log fields (severity, hostname, service, etc.).
- In PLAY mode shows new log entries immediately after they are received.
- Uses `service.namespace` and `service.name` resource attributes to identify log streams.

## Setup

### Prerequisites

- A Netdata Cloud account (the `otel-logs` view is access-gated and requires a Netdata Cloud sign-in).
- The `otel.plugin` enabled, with its OTLP/gRPC endpoint configured in `otel.yaml` (see the [plugin reference](https://github.com/netdata/netdata/blob/master/src/crates/otel-plugin/README.md)).
- An OpenTelemetry exporter (an OTel Collector or an SDK) pointed at that endpoint to send OTLP logs.


### Configuration

There is no configuration needed for this integration.
