Green Monitoring Stack

Project Status: Active – The project has reached a stable, usable state and is being actively developed. License
Build For Better 2024 Winner

Table of contents

About the project

A monitoring stack with samples for collection and data exploration for sustainability purposes.

The data is collected from Network, DC (compute / storage) infrastructure, third-party devices and external sources to be able to understand the energy consumption and its relation to traffic and bandwidth, the cost and the carbon footprint of the environment at various levels of granularity.

KPIs

Element KPI
network device power
power supply load
power supply efficiency

traffic
bandwidth utilization
power consumption ratio (PCR) - reference

CO2-eq emissions (+ historical)
cost
server power
utilization
temperature

CO2-eq emissions
cost
pdu power
rack power
TBD: temperature

Technology stack

Architecture
Architecture

Captures data from:

  • IOS-XR routers
  • NX-OS switches
  • Meraki switches
  • UCS servers
  • ACI APIC
  • Raritan PDUs
  • Eaton PDUs

Stores data in:

  • InfluxDB v2

Exposes data in:

  • Grafana

Data Flow:

IOS-XR
NX-OS
Meraki
ACI APIC                   -> Telegraf     ->     InfluxDB     -> Grafana
UCS: REDFISH/CIMC/UCSM
Raritan PDUs
Eaton PDUs

Getting started

Prerequisites

Use these instructions.

Configuration

Use these instructions.

Installation

Use these instructions.

Usage

Access

Access the two following WebUIs by replacing the HOST_IP placeholder with the reachable IP address of the host that runs the stack:

  • Grafana - hosts custom visualizations.
  • Influx (credentials based on .env) - for exploration of raw data.

Dashboards

Overview power - Meraki - organization/switches
Overview power - Meraki - organization/switches

Overview power - DC - Nexus
Overview power - DC - Nexus

Overview CO2-eq emissions - DC - Nexus
Overview CO2-eq emissions - DC - Nexus

Overview power - NCS, ASR 9K, Cisco 8K
Overview power - NCS, ASR 9K, Cisco 8K

Overview CO2-eq emissions - NCS, ASR 9K, Cisco 8K
Overview CO2-eq emissions - NCS, ASR 9K, Cisco 8K

Historical overview of CO2-eq emissions - Fretta
Historical overview of CO2-eq emissions - Fretta

Power - DC - UCS
Power - DC - UCS

Temperature - DC - UCS
Temperature - DC - UCS

Utilization - DC - UCS
Utilization - DC - UCS

Rack view - DC - UCS 1/3
Rack view - DC - UCS 1/3

Rack view - DC - UCS 2/3
Rack view - DC - UCS 2/3

Rack view - DC - UCS 3/3
Rack view - DC - UCS 3/3

PDUs - Raritan
PDUs - Raritan

PDUs - Eaton
PDUs - Eaton

Cost - DC - Nexus and UCS
Cost - DC - Nexus and UCS

PCR (Power consumption ratio) versus Traffic
PCR versus traffic - Cisco 8201

PCR (Power consumption ratio) versus Bandwidth utilization - concept
PCR versus bandwidth utilization

PCR (Power consumption ratio) versus Bandwidth utilization - NCS
PCR versus bandwidth utilization

PCR (Power consumption ratio) versus Bandwidth utilization - ASR 9K and Cisco 8K
PCR versus bandwidth utilization

Bandwidth utilization and distribution per interface
PCR versus bandwidth utilization

Specifications

The collections available are documented in SPECS.md.

FAQ

See FAQ.md.

Contributing

Contributions are highly appreciated. Please follow the guidelines documented in CONTRIBUTING.md.

License

Distributed under the Apache License Version 2.0. See the LICENSE for more information.

Contact

Acknowledgements

View code on GitHub

Code Exchange Community

Get help, share code, and collaborate with other developers in the Code Exchange community.View Community
Disclaimer:
Cisco provides Code Exchange for convenience and informational purposes only, with no support of any kind. This page contains information and links from third-party websites that are governed by their own separate terms. Reference to a project or contributor on this page does not imply any affiliation with or endorsement by Cisco.