Skip to content

Exporter for metrics from devices running Cisco (NX-OS/IOS XE/IOS) to use with https://prometheus.io/

License

Notifications You must be signed in to change notification settings

a83r/cisco_exporter

 
 

Repository files navigation

cisco_exporter

Exporter for metrics from devices running Cisco (NX-OS/IOS XE/IOS) (via SSH) https://prometheus.io/

The basic structure is based on https://github.com/czerwonk/junos_exporter

flags

Name Description Default
version  Print version information.
web.listen-address  Address on which to expose metrics and web interface. :9362
web.telemetry-path Path under which to expose metrics.  /metrics
ssh.targets Comma seperated list of hosts to scrape
ssh.user Username to use for SSH connection cisco_exporter
ssh.timeout  Timeout in seconds to use for SSH connection 5
ssh.batch-size  The SSH response batch size 10000
debug  Show verbose debug output false
legacy.ciphers Allow insecure legacy ciphers: aes128-cbc 3des-cbc aes192-cbc aes256-cbc false

this version uses a file /etc/prometheus/ciscoexporter_secrets to store the SSH password. The flag ssh.keyfile is removed, the path is not changeable at the moment.

metrics

All metrics are enabled by default. To disable something pass a flag --<name>.enabled=false, where <name> is the name of the metric.

Name Description OS
bgp BGP (message count, prefix counts per peer, session state) IOS XE/NX-OS
environment Environment (temperatures, state of power supply, power usage)  NX-OS/IOS XE/IOS
facts System informations (OS Version, memory: total/used/free, cpu: 5s/1m/5m/interrupts) IOS XE/IOS
interface Interfaces (transmitted/received: bytes/errors/drops, admin/oper state)  NX-OS (*_drops is always 0)/IOS XE/IOS
optics Optical signals (tx/rx)  NX-OS/IOS XE/IOS

Install

go get -u github.com/a83r/cisco_exporter

Usage

./cisco_exporter -ssh.targets="host1.example.com,host2.example.com:2233,172.16.0.1" 

Third Party Components

This software uses components of the following projects

License

(c) Martin Poppen, 2018. Licensed under MIT license.

Prometheus

see https://prometheus.io/

About

Exporter for metrics from devices running Cisco (NX-OS/IOS XE/IOS) to use with https://prometheus.io/

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 100.0%