Skip to content

Boavizta/cloud-scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

162185e Β· Jan 17, 2024
Nov 15, 2023
Jan 15, 2024
Jan 17, 2024
Jan 17, 2024
Jan 9, 2024
Jan 8, 2024
Jun 10, 2022
Oct 18, 2022
May 25, 2023
Oct 18, 2022
Jan 15, 2024
Jan 17, 2024
Jan 17, 2024
Jul 26, 2023
Jan 12, 2024
Apr 15, 2022
Nov 14, 2023
Nov 14, 2023
Jan 17, 2024
May 25, 2023
Aug 16, 2022
Oct 8, 2023

Repository files navigation

Boavizta's Cloud-scanner returns environmental impacts of your AWS Instances (EC2) usage.


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

It 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 ressources 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:

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 CLI and serverless application 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.

The limitations of cloud-scanner are documented in Limitations - Boavizta cloud scanner πŸ“‘

Several significant aspects of the global impacts of cloud usage are excluded:

  • only measure compute instances (EC2 VM's)
  • do not account for the surrounding cloud infrastructure (network, control plan)
  • do not account for storage
  • do not take into account the overcommit (mutualization) or overprovisionning that cloud provider may apply to provide the service.
  • do not account managed services (like DB as a service or Containers as a service).
  • do not account serverless (lambda) compute.
  • supported regions (EU and US only for the time being)
  • unsupported instance types returns zero for their impacts.
  • we do not provide (yet) error margins Boavizta/boaviztapi#147
  • the manufacturing impacts are not amortized (i.e. values returned for manufacturing impacts do not consider usage duration).

This is work in progress, and development version may already implement theses functionalities. So have a look at the changelog and Issues Β· Boavizta/cloud-scanner on this repository or check the content of the dev branch.