FoundationDB Metrics Exporter

A tool which will poll status of your FoundationDB cluster and expose human-readable metrics for Prometheus. When it is useful, metrics are tagged with appropriate data to be easily retriveable.

Metrics this exporter exposes are available in METRICS.md.

Not all metrics from status are yet available, but the ones we use are available. If you need more metrics, feel free to contribute!

Getting started

Docker

We expect that you have a FoundationDB running and accessible from the container. You can start with a sample cluster to try the exporter.

# Pull exporter version 1.0.0 for FoundtionDB version 7.3.33
docker pull clevercloud/foundationdb-exporter:1.0.0-7.3.33
# Environment variables:
#   FDB_COORDINATOR: DNS name of the coordinator node
#   FDB_COORDINATOR_PORT: Port of the coordinator node process
#   FDB_NETWORKING_MODE: Either container or host, describe docker networking
docker run \
  -e FDB_NETWORKING_MODE=container \
  -e FDB_COORDINATOR=coordinator \
  -e FDB_COORDINATOR_PORT=4500 \
  clevercloud/foundationdb-exporter:1.0.0-7.3.33

The exporter images are tagged based on both the exporter version and on FoundationDB versions. Each new version of the exporter will create a container tag as follow: ${exporter_version}-${foundationdb_version}. Our CI will create tags for latest patch version for FoundationDB 7.3 and 7.1. We do not create tag for version 7.2 as it shouldn't be used in production.

Binary

Go to releases page and download the compressed asset matching your system distribution.

A monitoring tool for FoundationDB with exporting capabilities for prometheus

Usage: foundationdb-exporter [OPTIONS]

Options:
  -p, --port <PORT>            Listening port of the web server [env: FDB_EXPORTER_PORT=] [default: 9090]
  -c, --cluster <CLUSTER>      Location of fdb.cluster file [env: FDB_CLUSTER_FILE=]
  -d, --delay-sec <DELAY_SEC>  Delay in seconds between two update of the status & metrics [env: FDB_EXPORTER_DELAY=] [default: 15]
  -h, --help                   Print help
  -V, --version                Print version

Running with a sample FoundationDB Cluster

Our docker compose will run a fully functional FoundationDB cluster along with the exporter on port 9090

git clone git@github.com:clevercloud/foundationdb-exporter.git
cd foundationdb-exporter
# Run a FoundationDB cluster with the exporter
docker compose up -d
# Fetch metrics available from the exporter
curl localhost:9090

Build

Rust 1.74.0 at least is required

cargo build --release
./target/release/foundationdb-exporter

Contributing

We welcome contributions, please see CONTRIBUTING.md for more specifics.