Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/send-data/alloy/set-up/otel_engine.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/send-data/alloy/set-up/otel_engine/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
The Alloy OpenTelemetry Engine
The OTel Engine is an OpenTelemetry Collector distribution embedded in Alloy. It runs standard OpenTelemetry Collector YAML configuration without translating it to Alloy syntax.
You can run it with the CLI, the OpenTelemetry Collector Helm chart, or a service installation. To run a Default Engine pipeline inside the OTel Engine, add the Alloy Engine extension to any of these. You can also build your own binary with the OpenTelemetry Collector Builder.
To manage the OTel Engine configuration remotely, use the otel-supervisor command.
It runs the OTel Engine under an embedded OpAMP supervisor that receives the configuration from Grafana Fleet Management.
To learn when to use each engine, refer to OpenTelemetry in Alloy.
EXPERIMENTAL: OTel Engine is an experimental feature. Experimental features are subject to frequent breaking changes, and may be removed with no equivalent replacement.
To maintain full compatibility of the OTel Engine with the upstream OpenTelemetry Collector and expose a compatible command line interface, the OTel Engine isn’t hidden behind a stability flag.
Make sure that you understand the risks involved before using an experimental feature in your production environments.
- Run the Alloy OpenTelemetry Engine with the CLI
- Run the Grafana Alloy Engine extension
- Run the Alloy OpenTelemetry Engine with the OpenTelemetry Collector Helm chart
- Run the Alloy OpenTelemetry Engine with service installations
- Build a custom Grafana Alloy binary with the OpenTelemetry Collector Builder (OCB)
Next steps
Was this page helpful?
Related resources from Grafana Labs


