Cloud scanner logo

About cloud-scanner

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

  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

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

Cloud-scanner is an Open Source application maintained here:

How it works

System in context diagram of cloud scanner

Cloud scanner relies on cloud providers APIs to perform an inventory of your cloud resources. It collects information about usage (instance types, tags, CPU load or volume size).

This inventory is used to query Boavizta API which returns impact data.

Results are exposed as JSON or metrics.


Cloud scanner is stable, but with limited functionality.

Development versions may already provide new functionalities that have not yet be included to a release. So have a look at the changelog and Issues on this repository.

And most importantly, do not hesitate to ask questions or share your feedback by opening an Issue or discussion on GitHub.