Skip to main content

Prometheus Metrics for Cloud Users

For cloud users, BuildBuddy exposes Prometheus metrics to monitor and alert on their usage.

In order to fetch Prometheus metrics, you can add the following scrape config in your Prometheus configuration:

global:
scrape_interval: 3600s
scrape_configs
- job_name: buildbuddy
scheme: https
authorization:
type: "x-buildbuddy-api-key"
credentials: "<buildbuddy_api_key>"
metrics_path: "/api/v1/metrics"
static_configs:
- targets: ["app.buildbuddy.io"]

To view these metrics in a live-updating dashboard, we recommend using a tool like Grafana.

exported_buildbuddy_remote_execution_queue_length (Gauge)

Number of actions currently waiting in the executor queue.

Examples

sum(exported_buildbuddy_remote_execution_queue_length)

exported_buildbuddy_invocation_duration_usec (Histogram)

The total duration of each invocation, in microseconds.

Labels

  • invocation_status

Examples

# Median invocation duration in the past 5 minutes
histogram_quantile(
0.5,
sum(rate(exported_buildbuddy_invocation_duration_usec_bucket[5m])) by (le)
)

# Number of invocations per Second
sum by (invocation_status) (rate(exported_buildbuddy_invocation_duration_usec_count[5m]))

exported_buildbuddy_remote_cache_num_hits (Gauge)

Number of cache hits.

Labels

  • cache_type

Examples

# Number of Hits as measured over the last week
sum by (cache_type) (increase(exported_buildbuddy_remote_cache_num_hits[1w]))

exported_buildbuddy_remote_cache_download_size_bytes (Gauge)

Number of bytes downloaded from the remote cache.

Examples

# Number of bytes downloaded as measured over the last week
sum(increase(exported_buildbuddy_remote_cache_download_size_bytes[1w]))

exported_buildbuddy_remote_cache_upload_size_bytes (Gauge)

Number of bytes uploaded to the remote cache.

Examples

# Number of bytes uploaded as measured over the last week
sum(increase(exported_buildbuddy_remote_cache_upload_size_bytes[1w]))

exported_buildbuddy_remote_execution_duration_usec (Histogram)

The total duration of remote execution, in microseconds.

Labels

  • os

Examples

# The total duration of remote execution as measured over the last week
sum by (os) (rate(exported_buildbuddy_remote_execution_duration_usec_sum[1w]))