Skip to main content

Prometheus metrics exporter for NETGEAR switches of the Smart Managed Plus series.

Project description

prosafe_exporter_python

GitHub sourcecode GitHub release (latest by date) GitHub GitHub issues PyPI - Python Version Donate at PayPal

Prometheus metrics exporter for NETGEAR switches of the Smart Managed Plus series.

Exported Metrics

metric description labels
prosafe_switch_info Information about the switch exposed as labels hostname, product_name, switch_name, serial_number, mac_adresse, bootloader_version, firmware_version, dhcp_mode, ip_adresse, subnetmask, gateway_adresse
prosafe_receive_bytes_total Incoming transfer in bytes hostname, port
prosafe_transmit_bytes_total Outgoing transfer in bytes hostname, port
prosafe_error_packets_total Transfer error in packets hostname, port
prosafe_link_speed Link speed in Mbps hostname, port
prosafe_max_mtu* Maximum MTU hostname, port

* not available in all firmware versions

Usage

Setup a config.yml

global: 
  retrieve_interval: 20.0
  retries: 10
  host: "0.0.0.0"
  port: 9493
switches: 
  - hostname: "192.168.0.100"
    password: "password123"
  - hostname: "192.168.0.200"
    password: "password123"

Run with:

prosafe_exporter path/to/your/config.yml

In prometheus configure a scrape job, e.g. like this:

scrape_configs:
 - job_name: 'prosafe_switches'
    static_configs:
      - targets:
        - "prosafe_exporter:9493"
    metrics_path: /probe
    scrape_interval: 60s

Query Example

Outgoing data rate of port 1 on 192.168.0.123 is below.

rate(prosafe_transmit_bytes_total{instance="192.168.0.123", port="1"}[1m])

Tested Switches

  • GS108Ev3
  • GS108PEv3

Tested Firmware

  • V2.06.14GR
  • V2.06.14EN
  • V2.06.03EN

Known Issues

  • May not work with older firmware, not all firmware versions are tested
  • Does not work with Japanese firmware

Credits

Inspired by dalance/prosafe_exporter that is providing the same functionality using the ProSAFE Plus utility instead of the switches webinterface

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

prosafe_exporter-0.4.1.tar.gz (9.6 kB view hashes)

Uploaded Source

Built Distribution

prosafe_exporter-0.4.1-py3-none-any.whl (8.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page