Telemetry

Prover Node monitoring through metrics exports.

Prover Nodes are required to run their nodes alongside a "sidecar" Docker container to export useful metrics about the node. These metrics are aggregated and are visible in a public Grafana dashboard.

API Key

Please reach out through our channels to get your Grafana API key.

Running Telemetry

When going through Installation, you may opt into installing telemetry. This step will launch a Grafana Alloy docker container.

The prover node will then attempt to connect to the localhost collector.

---

OpenTelemetry

All Operators can enable and export metrics using OTL protocol through Grafana Alloy using a provided API key. Operators can customize their configuration to export to additional OpenTelemetry collectors.

Currently, the node exports the following:

• Logs

• Tracing Spans (Instrumentation)

• Metrics (e.g. Gauges, Counters)

Configuration

Please refer to the Grafana Alloy documentation when modifying the provided config.alloy file.

Find below the specific section for telemetry configuration within the Prover Node config file.

More configuration options coming soon.

~/.fermah/config/prover-node-config.toml

[telemetry]
mode = { Alloy = {} }
layers = "logs,metrics,traces"
filter = "info"
interval = 30
temporality = { Cumulative = {} }

By default, we export all logs that match INFO level.