Network Monitoring with Telegraf / Influxdb / Grafana

Quick path to demo
Requiremetns & Installation
Commands and usage
- Grafana access
- Device List
Components
Contributors

Complete stack to monitor Juniper datacenter. it uses following components:

telegraf : Agent for collecting information from devices. It can be used in 2 different flavor: snmp and/or openconfig
influxdb : Time series database (TSN) to store all information sent by telegraf agents.
grafana : Time series analytics engine to build reports from Influxdb.

All the configuration is managed by templating for following components:

docker-compose file
telegraf configuration

Dashboards available:

Fabric Monitoring: information from generic SNMP based device running in an IP-Fabric environment (Interface counters / BGP status / BGP Update and state messages)
Fabric Reporting: information from all Junos SNMP based devices running in an IP-Fabric environment (Hw type / Serial number / Junos Version)

Quick path to demo

# Install python requirements
pip intall -r requirements.txt

# Edit data.yml to add your devices
vim data.yml

# Build and start stack
make build

# Stop and delete stack
make destroy

Open a browser to http://127.0.0.1:9081/ with super/juniper123

Requiremetns & Installation

As it is based on docker, you have to install docker first:

Then,, you have to install python requirements

pip install -r requirements.txt

Commands and usage

Define your targets by editing data.yml file:

Grafana access

Access to grafna can be managed in data.yml file with the following section:

grafana:
  web:
    port: "9081"
    username: "super"
    password: "juniper123"

If not set, access is configured to be like: http://127.0.0.1:9081/ with username/password set to super/juniper123

Device List

SNMP devices

---
telegraf:
  snmp:
    community: "public"
    hosts:
      172.25.90.67: 161
      172.25.90.68: 161

Junos Openconfig devices

---
telegraf:
  openconfig:
    username: 'ansible'
    password: 'juniper123'
    hosts:
      172.25.90.67: 32768
      172.25.90.68: 32768

Both snmp and openconfig definition can be configure in this data.yml

Some commands are available to manage repository

make build-telegraf-conf : Build telegraf configuration with template rendering
make build : Build telegraf config, build docker-compose stack, start stack
make destroy : Stop docker stack and remove containers
make start : start an already configured stack. (Must be done if stack were built previously)
make stop : stop running stack. Containers are not deleted and can be restarted with make start
make restart : stop and start stack
make rebuild : destroy and build stack
make {telegraf-snmp|telegraf-openconfig|influxdb|grafana}-cli : connect to containers

Components

Repository is based on docker containers and they are all managed with docker-compose:

telegraf:1.9.1 image for openconfig polling
inetsix/telegraf-snmp image for SNMP polling
influxdb:1.7.2
grafana:grafana/grafana:5.4.2

alexboorman / tig-network-monitoring