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

tombokombo/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.keyfile  Key file 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

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)  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/lwlcom/cisco_exporter

Usage

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

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 99.2%
  • Dockerfile 0.8%