---
title: "otel | Grafana Alloy documentation"
description: "Learn about the otel command"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# `otel`

> **EXPERIMENTAL**: This is an [experimental](/docs/release-life-cycle/) feature. Experimental features are subject to frequent breaking changes, and may be removed with no equivalent replacement.

The `otel` command runs Alloy with the OTel Engine. This command accepts OpenTelemetry Collector YAML configuration files.

The OTel Engine includes receivers, processors, exporters, extensions, and connectors from the OpenTelemetry Collector core and contrib repositories. This includes components for OTLP, Prometheus, Kafka, Zipkin, and other popular integrations.

As with the `run` command, this runs in the foreground until an interrupt is received.

## Usage

shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```shell
alloy otel --config=<CONFIG_FILE> [<FLAGS> ...] 
```

Replace the following:

- *`<CONFIG_FILE>`* : Path to an OpenTelemetry Collector configuration file.
- *`<FLAGS>`* : One or more flags that [configure the OpenTelemetry Collector](https://opentelemetry.io/docs/collector/configuration/). These flags are the same as upstream. Run `alloy otel --help` to show the complete list of supported flags.

In addition to the upstream flags, the `otel` command accepts:

- `--disable-reporting`: Disable [anonymous usage statistics reporting](../../../data-collection/) to Grafana.

## Configuration

The `otel` command accepts standard OpenTelemetry Collector YAML configuration files. The configuration file defines receivers, processors, exporters, and other components that make up your telemetry pipeline.

### Run the Default Engine in parallel

The OTel Engine includes the option to run pipelines with the Default Engine alongside the OTel Engine. Use the built-in Alloy Engine extension to enable this.

This runs a Default Engine pipeline *in parallel* to the OTel Engine pipeline. The two pipelines can’t natively interact.

### Examples

Refer to [The OpenTelemetry Engine](../../../set-up/otel_engine/) for examples that show you how to run the OTel Engine and Alloy Engine extension.

## Included components

The OTel Engine includes:

- Standard components from the OpenTelemetry Collector Core repository
- Selected components from the OpenTelemetry Collector Contrib repositories
- The `alloyengine` extension

Alloy v1.19.0 bundles OpenTelemetry Collector components from version v0.158.0. You can find more information about the bundled version in both the [OpenTelemetry Collector](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0) and [OpenTelemetry Collector Contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0) repositories.

The following sections list all included components:

Extensions

- [alloyengine](https://github.com/grafana/alloy/tree/main/extension/alloyengine)
- [basicauth](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/basicauthextension/README.md)
- [bearertokenauth](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/bearertokenauthextension/README.md)
- [headerssetter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/headerssetterextension/README.md)
- [healthcheck](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/healthcheckextension/README.md)
- [jaegerremotesampling](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/jaegerremotesampling/README.md)
- [k8sleaderelector](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/k8sleaderelector/README.md)
- [oauth2clientauth](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/oauth2clientauthextension/README.md)
- [opamp](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/opampextension/README.md)
- [pprof](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/pprofextension/README.md)
- [sigv4auth](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/sigv4authextension/README.md)
- [filestorage](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/extension/storage/filestorage/README.md)
- [zpages](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/extension/zpagesextension/README.md)

Configuration Providers

- [env](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/confmap/provider/envprovider/README.md)
- [file](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/confmap/provider/fileprovider/README.md)
- [http](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/confmap/provider/httpprovider/README.md)
- [https](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/confmap/provider/httpsprovider/README.md)
- [yaml](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/confmap/provider/yamlprovider/README.md)

Receivers

- [awscloudwatch](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/awscloudwatchreceiver/README.md)
- [awsecscontainermetrics](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/awsecscontainermetricsreceiver/README.md)
- [awss3](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/awss3receiver/README.md)
- [cloudflare](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/cloudflarereceiver/README.md)
- [datadog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/datadogreceiver/README.md)
- [faro](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/faroreceiver/README.md)
- [filelog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/filelogreceiver/README.md)
- [filestats](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/filestatsreceiver/README.md)
- [fluentforward](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/fluentforwardreceiver/README.md)
- [googlecloudpubsub](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/googlecloudpubsubreceiver/README.md)
- [hostmetrics](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/hostmetricsreceiver/README.md)
- [influxdb](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/influxdbreceiver/README.md)
- [jaeger](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/jaegerreceiver/README.md)
- [k8sclusterreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/k8sclusterreceiver/README.md)
- [k8sobjectsreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/k8sobjectsreceiver/README.md)
- [kafka](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/kafkareceiver/README.md)
- [kubeletstatsreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/kubeletstatsreceiver/README.md)
- [nginx](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/nginxreceiver/README.md)
- [prometheus](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/prometheusreceiver/README.md)
- [prometheusremotewrite](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/prometheusremotewritereceiver/README.md)
- [solace](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/solacereceiver/README.md)
- [splunkhec](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/splunkhecreceiver/README.md)
- [syslog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/syslogreceiver/README.md)
- [tcplog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/tcplogreceiver/README.md)
- [vcenter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/vcenterreceiver/README.md)
- [zipkin](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/receiver/zipkinreceiver/README.md)
- [nop](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/receiver/nopreceiver/README.md)
- [otlp](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/receiver/otlpreceiver/README.md)

Connectors

- [count](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/connector/countconnector/README.md)
- [grafanacloud](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/connector/grafanacloudconnector/README.md)
- [servicegraph](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/connector/servicegraphconnector/README.md)
- [signaltometrics](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/connector/signaltometricsconnector/README.md)
- [spanmetrics](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/connector/spanmetricsconnector/README.md)
- [forward](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/connector/forwardconnector/README.md)

Processors

- [attributes](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/attributesprocessor/README.md)
- [cumulativetodelta](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/cumulativetodeltaprocessor/README.md)
- [deltatocumulative](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/deltatocumulativeprocessor/README.md)
- [filter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/filterprocessor/README.md)
- [groupbyattrs](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/groupbyattrsprocessor/README.md)
- [interval](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/intervalprocessor/README.md)
- [k8sattributes](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/k8sattributesprocessor/README.md)
- [metricstarttime](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/metricstarttimeprocessor/README.md)
- [probabilisticsampler](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/probabilisticsamplerprocessor/README.md)
- [redaction](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/redactionprocessor/README.md)
- [resource](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/resourceprocessor/README.md)
- [resourcedetection](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/resourcedetectionprocessor/README.md)
- [span](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/spanprocessor/README.md)
- [tailsampling](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/tailsamplingprocessor/README.md)
- [transform](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/processor/transformprocessor/README.md)
- [batch](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/processor/batchprocessor/README.md)
- [memorylimiter](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/processor/memorylimiterprocessor/README.md)

Exporters

- [awss3](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/awss3exporter/README.md)
- [faro](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/faroexporter/README.md)
- [file](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/fileexporter/README.md)
- [googlecloud](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/googlecloudexporter/README.md)
- [googlecloudpubsub](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/googlecloudpubsubexporter/README.md)
- [kafka](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/kafkaexporter/README.md)
- [loadbalancing](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/loadbalancingexporter/README.md)
- [prometheus](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/prometheusexporter/README.md)
- [prometheusremotewrite](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/prometheusremotewriteexporter/README.md)
- [splunkhec](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/splunkhecexporter/README.md)
- [syslog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/syslogexporter/README.md)
- [zipkin](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.158.0/exporter/zipkinexporter/README.md)
- [debug](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/exporter/debugexporter/README.md)
- [nop](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/exporter/nopexporter/README.md)
- [otlp](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/exporter/otlpexporter/README.md)
- [otlphttp](https://github.com/open-telemetry/opentelemetry-collector/tree/v0.158.0/exporter/otlphttpexporter/README.md)

To view the full list of components and their versions, refer to the [OpenTelemetry Collector Builder manifest](https://github.com/grafana/alloy/blob/main/collector/builder-config.yaml).

## Related documentation

- [OpenTelemetry in Alloy](../../../introduction/otel_alloy/): Learn when to use the OTel Engine or Default Engine.
- [OpenTelemetry Collector documentation](https://opentelemetry.io/docs/collector/): Official OpenTelemetry Collector documentation.