A Prometheus exporter for Netgear consumer routers. This exporter consumes the data obtained by netgear_client and is based on the node_exporter and cf_exporter projects.
Download the already existing binaries for your platform:
$ ./netgear_exporter <flags>Using the standard go install (you must have Go already installed in your local machine):
$ go install github.com/DRuggeri/netgear_exporter
$ netgear_exporter <flags>An official scratch-based Docker image is built with every tag and pushed to DockerHub and ghcr. Additionally, PRs will be tested by GitHubs actions.
The following images are available for use:
The exporter can be deployed to an already existing Cloud Foundry environment if, for some reason, that lives on a network with your Netgear consumer router.
$ git clone https://github.com/DRuggeri/netgear_exporter.git
$ cd cf_exporterModify the included application manifest file to include your router properties. Then you can push the exporter to your Cloud Foundry environment:
$ cf pushSeveral flags are available to customize how the exporter works. Note that none of them are strictly required in a "default" installation, but several should probably be set. This mostly depends on your home network and how it is configured. For example, the url and insecure parameters go hand-in-hand when pointing to a specific IP address. This is required in my setup because I run a custom DNS service which does not intercept queries for www.routerlogin.com.
NOTE: This exporter MUST have the password set in the NETGEAR_EXPORTER_PASSWORD environment variable. If it is not set, it will fail to start with a warning message.
Flags:
-h, --help Show context-sensitive help (also try --help-long and --help-man).
--url="https://www.routerlogin.com"
URL of the Netgear router. Defaults to 'https://www.routerlogin.com' ($NETGEAR_EXPORTER_URL)
--username="admin" Username to use. Defaults to 'admin' ($NETGEAR_EXPORTER_USERNAME)
--insecure Disable TLS validation of the router. This is needed if you are connecting by IP or a custom host name. Default: false ($NETGEAR_EXPORTER_INSECURE)
--timeout=2 Timeout in seconds for communication with the router. On LAN networks, this should be very small. Default: 2 ($NETGEAR_EXPORTER_TIMEOUT)
--clientdebug Print requests and responses on STDOUT. ($NETGEAR_EXPORTER_CLIENT_DEBUG)
--filter.collectors="" Comma separated collectors to filter (Client,SystemInfo,Traffic) ($NETGEAR_EXPORTER_FILTER_COLLECTORS)
--metrics.namespace="netgear"
Metrics Namespace ($NETGEAR_EXPORTER_METRICS_NAMESPACE)
--web.listen-address=":9192"
Address to listen on for web interface and telemetry ($NETGEAR_EXPORTER_WEB_LISTEN_ADDRESS)
--web.telemetry-path="/metrics"
Path under which to expose Prometheus metrics ($NETGEAR_EXPORTER_WEB_TELEMETRY_PATH)
--web.auth.username=WEB.AUTH.USERNAME
Username for web interface basic auth ($NETGEAR_EXPORTER_WEB_AUTH_USERNAME). The password must be set in the environment variable NETGEAR_EXPORTER_WEB_AUTH_PASSWORD
--web.tls.cert_file=WEB.TLS.CERT_FILE
Path to a file that contains the TLS certificate (PEM format). If the certificate is signed by a certificate authority, the file should be the concatenation of the server's
certificate, any intermediates, and the CA's certificate ($NETGEAR_EXPORTER_WEB_TLS_CERTFILE)
--web.tls.key_file=WEB.TLS.KEY_FILE
Path to a file that contains the TLS private key (PEM format) ($NETGEAR_EXPORTER_WEB_TLS_KEYFILE)
--printMetrics Print the metrics this exporter exposes and exits. Default: false ($NETGEAR_EXPORTER_PRINT_METRICS)
--log.level="info" Only log messages with the given severity or above. Valid levels: [debug, info, warn, error, fatal]
--log.format="logger:stderr"
Set the log target and format. Example: "logger:syslog?appname=bob&local=7" or "logger:stdout?json=true"
--version Show application version.
On systemd based systems, the following /etc/systemd/system/netgearexporter.service configuration works well:
[Unit]
Description=Start and run the netgear monitor
After=network.target
[Service]
EnvironmentFile=/root/.routercreds
ExecStart=/usr/local/bin/netgear_exporter --url=https://192.168.0.1 --insecure --timeout=10 --filter.collectors=Traffic
Restart=on-failure
RestartSec=60s
[Install]
WantedBy=default.target
This will read the password (containing NETGEAR_EXPORTER_PASSWORD) from a root-owned file. Should the exporter crash, it will restart after 60 seconds.
This collector gathers the raw traffic data from the router. The time metrics are converted from hh:mm format to number of seconds.
IMPORTANT NOTE: Netgear implements these statistics as incrementing counters that reset after their prescribed duration (day, week, month). As such, these metrics should mostly show "sawtooth" style data when graphed.
netgear_traffic_todayconnectiontime - Value of the 'TodayConnectionTime' traffic metric from the router
netgear_traffic_todaydownload - Value of the 'TodayDownload' traffic metric from the router
netgear_traffic_todayupload - Value of the 'TodayUpload' traffic metric from the router
netgear_traffic_yesterdayconnectiontime - Value of the 'YesterdayConnectionTime' traffic metric from the router
netgear_traffic_yesterdaydownload - Value of the 'YesterdayDownload' traffic metric from the router
netgear_traffic_yesterdayupload - Value of the 'YesterdayUpload' traffic metric from the router
netgear_traffic_weekconnectiontime - Value of the 'WeekConnectionTime' traffic metric from the router
netgear_traffic_weekdownload - Value of the 'WeekDownload' traffic metric from the router
netgear_traffic_weekdownloadaverage - Value of the 'WeekDownloadAverage' traffic metric from the router
netgear_traffic_weekupload - Value of the 'WeekUpload' traffic metric from the router
netgear_traffic_weekuploadaverage - Value of the 'WeekUploadAverage' traffic metric from the router
netgear_traffic_monthconnectiontime - Value of the 'MonthConnectionTime' traffic metric from the router
netgear_traffic_monthdownload - Value of the 'MonthDownload' traffic metric from the router
netgear_traffic_monthdownloadaverage - Value of the 'MonthDownloadAverage' traffic metric from the router
netgear_traffic_monthupload - Value of the 'MonthUpload' traffic metric from the router
netgear_traffic_monthuploadaverage - Value of the 'MonthUploadAverage' traffic metric from the router
netgear_traffic_lastmonthconnectiontime - Value of the 'LastMonthConnectionTime' traffic metric from the router
netgear_traffic_lastmonthdownload - Value of the 'LastMonthDownload' traffic metric from the router
netgear_traffic_lastmonthdownloadaverage - Value of the 'LastMonthDownloadAverage' traffic metric from the router
netgear_traffic_lastmonthupload - Value of the 'LastMonthUpload' traffic metric from the router
netgear_traffic_lastmonthuploadaverage - Value of the 'LastMonthUploadAverage' traffic metric from the router
netgear_traffic_scrapes_total - Total number of scrapes for Netgear traffic stats.
netgear_traffic_scrape_errors_total - Total number of scrapes errors for Netgear traffic stats.
netgear_last_traffic_scrape_error - Whether the last scrape of Netgear traffic stats resulted in an error (1 for error, 0 for success).
netgear_last_traffic_scrape_timestamp - Number of seconds since 1970 since last scrape of Netgear traffic metrics.
Refer to the contributing guidelines.
Apache License 2.0, see LICENSE.