Send logs on Grafana Labs

OTLP for logs

Wed, 07 Oct 2026 11:08:53 -0500

OTLP for logs

The Grafana Cloud OTLP endpoint accepts OpenTelemetry logs and routes them into Grafana Cloud Logs. Grafana stores them with extra fields beside the log line (structured metadata) and with labels you can use to filter streams.

If you already run Grafana Alloy or another OpenTelemetry Collector, point its OTLP exporter at that endpoint. Other Collector distributions need additional setup. An SDK, a software library in your application, can send OTLP directly for non-production use, or when you cannot deploy a collector.

Considerations

The same endpoint accepts metrics, logs, and traces.
Log attributes are stored as structured metadata. Some resource attributes, which describe where the log came from, are copied into labels.
Grafana Alloy is the production collector. Another OpenTelemetry Collector needs additional setup. An SDK can send directly for non-production use, or when you cannot deploy a collector.

Documentation

Push API for logs

Wed, 07 Oct 2026 11:08:53 -0500

Push API for logs

POST /loki/api/v1/push is the endpoint that ingests log entries into Loki, which is the system behind Grafana Cloud Logs.

The default request body is a Snappy-compressed Protocol Buffer message, a compressed binary format, with Content-Type: application/x-protobuf. If you set Content-Type: application/json, you can POST a JSON body instead. That body is a streams array. Each stream has labels and a list of timestamped log lines.

Considerations

The API reference includes a curl example that posts one JSON stream.
You can gzip the JSON body with Content-Encoding: gzip.
You can attach structured metadata to a log line by adding a JSON object of string keys and values after the line text.
This is the ingest endpoint in the Loki HTTP API. It is separate from the query API, which is documented for reading Grafana Cloud Logs programmatically.

Send logs on Grafana Labs

OTLP for logs

OTLP for logs

Considerations

Documentation

Push API for logs

Push API for logs

Considerations

Documentation

Resources

Resources

Documentation

Blog posts

Community