This is documentation for the next version of Grafana Beyla documentation. For the latest stable release, go to the latest version.

Documentation Beyla Set up

Set up Beyla

You can run Grafana Beyla 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.

• 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
  Learn how to deploy Beyla with the Kubernetes Monitoring Helm chart in Kubernetes for Knowledge Graph and Application Observability in Grafana Cloud.
• Grafana Alloy Helm chart
  Learn how to instrument an application export data with Prometheus to Grafana Cloud
• Kubernetes
  Learn how to deploy Beyla in Kubernetes.
• Security
  Privileges and capabilities required by Beyla
• Cilium compatibility
  Compatibility notes when running Beyla alongside Cilium
• Use OBI with Grafana
  Replace Grafana Beyla features that OpenTelemetry eBPF Instrumentation (OBI) doesn't have, and configure OBI for Grafana Cloud Application Observability and Knowledge Graph.

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.