cumulus-exporter is a Prometheus exporter, that exposes metrics from switching and routing platforms running on Cumulus Linux based hosts alongside the node_exporter.
Do not yet use the ASIC collector, as there is a known bug in current cumulus releases.
It provides the following metrics:
- Transceiver statistics (RX / TX power, voltage, temperature, ...) by including the transceiver-exporter
- MSTPD statistics (port (forwarding) states)
- ASIC statistics as exposed in
/cumulus/switchd - HWMON statistics (needs configuration)
Usage of cumulus-exporter:
-collecotrs.transceiver.exclude-interfaces string
Comma seperated list of interfaces to exclude from scrape
-collectors.asic
Enable ASIC collector
-collectors.hwmon
Enable hwmon collector
-collectors.hwmon.config string
hwmon collector config file (default "hwmon.yml")
-collectors.mstpd
Enable mstpd collector
-collectors.mstpd.mstpctl-path string
mstpctl binary path (default "/sbin/mstpctl")
-collectors.transceiver
Enable transceiver collector (rx / tx power, temperatures, etc.)
-collectors.transceiver.interface-features
Collect interface features (results in many time series
-version
Print version and exit
-web.listen-address string
Address to listen on (default "[::]:9457")
-web.telemetry-path string
Path under which to expose metrics (default "/metrics")
The kernel's hwmon interface provides no means of enumerating sensors, so you have to provide some information
You can figure out some sensors by running smonctl --json.
Supply the following format:
sensors:
- description: "Asic Temp Sensor"
driver_path: "/sys/class/hwmon/hwmon8"
driver_hwmon: temp1
type: temp
- description: "Main Board Ambient Sensor"
driver_path: "/sys/class/hwmon/hwmon5"
driver_hwmon: temp1
type: temp
- description: "Port Ambient Sensor"
driver_path: "/sys/class/hwmon/hwmon4"
driver_hwmon: temp1
type: tempIf you wish to export the (floating point) content from a single file, use
- description: "Fan Tray 2 OK"
driver_path: "/sys/bus/i2c/devices/0-0060/fan2_ok"
type: raw