Skip to content

natesales/gpsd-exporter

Repository files navigation

Prometheus exporter for gpsd

Release Go Report License

gpsd-exporter polls gpsd over its TCP JSON interface and exports the data to Prometheus.

Supported gpsd classes

  • Time position value (TPV)
  • Sky view (SKY)
  • Satellite (Satellite)
  • Pseudorange noise report (GST)
  • Time offset (TOFF)
  • Pulse per second (PPS)
  • Oscillator (OSC)
  • gpsd Version (VERSION)

See gpsd's protocol responses for more information.

Grafana

Grafana

A simple dashboard is available to import into Grafana from the gpsd-exporter Grafana JSON file.

Quickstart

With gpsd running on localhost:2947:

Linux

Install gpsd-exporter from the apt/yum repo or build with go build

$ gpsd-exporter
INFO[0000] Starting metrics exporter on :9978/metrics
INFO[0000] Connecting to gpsd on localhost:2947

Docker

docker run -p 9978:9978 ghcr.io/natesales/gpsd-exporter

Usage

Usage of ./gpsd-exporter:
  -d string
        gpsd address (default "localhost:2947")
  -l string
        metrics listen address (default ":9978")
  -p duration
        gpsd poll interval (default 10s)
  -v    enable verbose logging
  -vv
        enable extra verbose logging