Menu
Open source
Set up Beyla
You can run Grafana Beyla on a Linux host, as a Docker container, or in Kubernetes with a Helm chart or your own manifests. Before you set up Beyla, check the requirements and limitations.
- Linux host
Download the Grafana Beyla binary, run it on a Linux host to instrument a service, and send metrics and traces to a backend or run Beyla as a systemd service. - Docker
Run Grafana Beyla in a Docker container to instrument a service in another container, with the Docker CLI or Docker Compose. - Beyla Helm chart
Install Grafana Beyla in Kubernetes with the Beyla Helm chart, customize its configuration, reduce its privileges, scrape its metrics with the Prometheus Operator, and pass OTLP credentials from a Secret. - Beyla Helm chart for Grafana Cloud
Deploy Grafana Beyla with the Beyla Helm chart and send span metrics, service graph metrics, and traces directly to the Grafana Cloud OTLP endpoint for Application Observability and Knowledge Graph, with no collector in between. - Kubernetes Monitoring Helm chart
Deploy Grafana Beyla as the auto-instrumentation feature of the Grafana Kubernetes Monitoring Helm chart, which runs Beyla alongside cluster monitoring and uses Grafana Alloy to collect Beyla metrics and traces and send them to Grafana Cloud or any compatible backend. - Grafana Alloy Helm chart
Deploy Grafana Beyla in Kubernetes as the beyla.ebpf component of Grafana Alloy with the Alloy Helm chart, and send Beyla metrics and traces through Alloy pipelines to Grafana Cloud. - Kubernetes manifests
Deploy Grafana Beyla in Kubernetes with your own manifests, as a DaemonSet that instruments the applications on each node, and send metrics and traces to an OpenTelemetry endpoint. - Cilium
Configure Grafana Beyla and Cilium so their traffic control eBPF programs don't conflict, and fix the Cilium compatibility error at Beyla startup.
For configuration options and data export modes, refer to Configure Beyla.
By default, Beyla groups URL paths into routes with the low-cardinality routes decorator.
To define route patterns for your application, refer to Configure Beyla routes decorator.