shelly-plug-exporter

Shelly plug exporter

Prometheus exporter for Shelly Plugs and devices (generation 1 and 2) Can probe list of targets or use mDNS service discovery

Usage

Usage:
  shelly-plug-exporter [OPTIONS]

Application Options:
      --debug                            debug mode [$DEBUG]
  -v, --verbose                          verbose mode [$VERBOSE]
      --log.json                         Switch log output to json format [$LOG_JSON]
      --shelly.request.timeout=          Request timeout (default: 5s) [$SHELLY_REQUEST_TIMEOUT]
      --shelly.auth.username=            Username for shelly plug login [$SHELLY_AUTH_USERNAME]
      --shelly.auth.password=            Password for shelly plug login [$SHELLY_AUTH_PASSWORD]
      --shelly.servicediscovery.timeout= mDNS discovery response timeout (default: 5s) [$SHELLY_SERVICEDISCOVERY_TIMEOUT]
      --shelly.servicediscovery.refresh= mDNS discovery refresh time (default: 15m) [$SHELLY_SERVICEDISCOVERY_REFRESH]
      --server.bind=                     Server address (default: :8080) [$SERVER_BIND]
      --server.timeout.read=             Server read timeout (default: 5s) [$SERVER_TIMEOUT_READ]
      --server.timeout.write=            Server write timeout (default: 10s) [$SERVER_TIMEOUT_WRITE]

Help Options:
  -h, --help                             Show this help message

Docker & Prometheus

For mDNS service discovery the docker container must run on host network for multicast requests so the exporter needs to be exposed on the host machine.

docker-compose.yaml

version: '3.4'
services:
    # ...
    shelly-plug:
        image: webdevops/shelly-plug-exporter:$VERSION
        restart: always
        network_mode: host
        read_only: true
        environment:
            - VERBOSE=1
            - SERVER_BIND=:8089
            - SHELLY_SERVICEDISCOVERY_TIMEOUT=10s
    # ...

prometheus config:

# ...
scrape_configs:
    # ...

    # general exporter metrics (eg memory & golang metrics)
    - job_name: 'shelly-plug-exporter'
      static_configs:
          - targets: ['host-addr:8089']

    # plugs metrics (mDNS servicediscovery)
    - job_name: 'shelly-plug-discovery'
      scrape_interval: 30s
      scrape_timeout: 29s
      static_configs:
          - targets: ['host-addr:8089']
      metrics_path: /probe/discovery

    # ...

HTTP Endpoints

Metrics