Auto-instrument HTTP and gRPC services for RED metrics and traces using Grafana Beyla eBPF without modifying application code

domain: grafana.com/docs/beyla · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Verify the Linux kernel is 5.8 or later with BTF enabled (most distros enable BTF by default from kernel 5.14+); check with ls /sys/kernel/btf/vmlinux
  2. Run Beyla as a sidecar container or DaemonSet with the BEYLA_OPEN_PORT or BEYLA_EXECUTABLE_NAME environment variable set to identify the target process
  3. Configure Beyla's exporter section to send OTLP traces and metrics to an OTel Collector or Grafana Cloud endpoint, or use the Prometheus exporter for a local scrape
  4. To use Beyla inside Grafana Alloy, add a beyla.ebpf block specifying open_port or exe_path, a kubernetes metadata block for pod enrichment, and a forward_to pointing to your otelcol.exporter
  5. Beyla automatically emits http.server.request.duration, rpc.server.duration, and related OTel semantic convention metrics; import the provided Grafana dashboard for RED visualization
  6. Enable trace context propagation in Beyla so that eBPF-captured spans carry the same traceparent as application-level spans, allowing correlation in Tempo or Jaeger

Known gotchas

Related routes

Deploy Grafana Beyla for eBPF auto-instrumentation of HTTP and gRPC services
grafana.com · 5 steps · unrated
Deploy Grafana Beyla as a DaemonSet on Kubernetes for eBPF auto-instrumentation of HTTP and gRPC services without code changes
grafana.com · 5 steps · unrated
Instrument a web application with the Grafana Faro Web SDK for real user monitoring, error tracking, and trace correlation
grafana.com/docs/grafana-cloud · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans