Skip to content

Tracks an open-source stack of services that monitor the energy and CO2-eq emissions of IOS-XR, NX-OS devices, Meraki switches, UCSs, ACI APIC nodes, Eaton and Raritan PDUs.

License

Notifications You must be signed in to change notification settings

cisco-open/green-monitoring

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

About

Tracks an open-source stack of services that monitor the energy and CO2-eq emissions of IOS-XR, NX-OS devices, Meraki switches, UCSs, ACI APIC nodes, Eaton and Raritan PDUs.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks