Instrument an application with Beyla

Grafana Beyla is an eBPF instrumentation solution that is easy to set up and automatically instruments network-level telemetry for all languages and frameworks.

Recommended set up

Grafana Labs recommends you set up instrumentation through the Grafana Cloud connection tiles. This opinionated approach includes all the binaries, configuration, and connection parameters you need to set up OpenTelemetry and Application Observability.

Other set up methods

To learn more about the various Beyla installation and configurations options, consult the Beyla documentation.

Test your instrumentation

To test if you’ve successfully instrumented your application with Beyla, run your application with Beyla and fetch metrics from the exposed Prometheus endpoint:

curl http://localhost:9090/metrics

If you installed Beyla via the Grafana Helm chart, first run kubectl -n beyla port-forward <BEYLA_POD_NAME>, with your Beyla pod name.

The curl request should return results that look similar to:

# HELP beyla_build_info A metric with a constant '1' value labeled by version, revision, branch, goversion from which Beyla was built, the goos and goarch for the build, and thelanguage of the reported services
# TYPE beyla_build_info gauge
beyla_build_info{goarch="arm64",goos="linux",goversion="go1.22.4",revision="b672ca01",target_lang="generic",version="b672ca01"} 1
beyla_build_info{goarch="arm64",goos="linux",goversion="go1.22.4",revision="b672ca01",target_lang="go",version="b672ca01"} 1
# HELP http_client_request_body_size_bytes size, in bytes, of the HTTP request body as sent from the client side
# TYPE http_client_request_body_size_bytes histogram
http_client_request_body_size_bytes_bucket{http_request_method="GET",http_response_status_code="200",http_route="/**",service_name="coredns",service_namespace="",target_instance="",le="0"} 2
http_client_request_body_size_bytes_bucket{http_request_method="GET",http_response_status_code="200",http_route="/**",service_name="coredns",service_namespace="",target_instance="",le="32"} 2