Awesome

<p align="center"> <img src="https://github.com/da-ekchajzer/cloud-scanner/blob/main/cloudscanner_color.svg" height="100"> </p> <h3 align="center"> Boavizta's Cloud-scanner returns <i>environmental impacts</i> of your AWS Instances (EC2) usage. </h3>

  graph LR;
      inventory[ Account inventory] 
      api[Impacts from BoaviztaAPI]
      metrics[Prometheus metrics]
      json[JSON output]
      inventory --> api
      api --> metrics
      api --> json

Cloud scanner combines real time inventory and usage data from your AWS account with Boavizta API to offer a view of your impacts on a given region.

multi criteria: Primary Energy consumption (PE), Abiotic resource depletion potential (ADP), and Global Warming Potential (GWP)
multi stage: separate impacts of resources Usage and Manufacture

This is similar to what you can get from Datavizta but with automated inventory.

Estimations can be filtered by tags. It eases attribution to a specific server, environment, application or service.

Cloud-scanner can be used:

from command line, to get an immediate view of your impacts 💻
as a metric server . You can use it to monitor and display real time impacts in a dashboard 📊

A example dashboard rendering cloud scanner metrics

How it works:

Cloud scanner follows Boavizta approach.

Thibault Simon, David Ekchajzer, Adrien Berthelot, Eric Fourboul, Samuel Rince, et al.. BoaviztAPI: a bottom-up model to assess the environmental impacts of cloud services. HotCarbon'24. Workshop on Sustainable Computer Systems, Jul 2024, Santa Cruz, United States. ⟨hal-04621947v1⟩

System in context diagram of cloud scanner

Usage and documentation

The complete documentation: Introduction - Boavizta cloud scanner 📡.

Getting started 🚀

Deployment as a serverless app (aws lambda) ⚡

Cloud scanner can also be deployed as a serverless application for aws.

Output formats

Cloud scanner returns data as json or Open Metrics (Prometheus) format.

See Output data - Boavizta cloud scanner 📡

⚠ Perimeter / scope and limits

Cloud scanner only estimates the impacts of your AWS EC2 instances and optionally block storage.

The limitations of cloud-scanner are documented in Limitations - Boavizta cloud scanner 📡