metrics.md

February 4, 2023 ยท View on GitHub

Prometheus Metrics

In relay mode, plumber will launch a http server exposing Prometheus metrics running at http://localhost:8080/metrics

Prometheus metrics can be pulled from Plumber by adding a new source to your prometheus.yml config

scrape_configs:
- job_name: plumber
  scrape_interval: 5s
  static_configs:
  - targets:
    - your-hostname:8080

You may modify the listen address/port using the PLUMBER_RELAY_HTTP_LISTEN_ADDRESS environment variable or the --listen-address flag.

The following metrics are available in addition to all golang metrics

MetricTypeDescription
plumber_relay_rategaugeCurrent rare of messages being relayed to Streamdal (5 second interval)
plumber_relay_totalcounterTotal number of events relayed to Streamdal
plumber_read_errorscounterNumber of errors when reading messages
plumber_grpc_errorscounterNumber of errors when making GRPC calls