{"id":18338284,"url":"https://github.com/boavizta/cloud-scanner","last_synced_at":"2025-06-17T18:34:33.898Z","repository":{"id":37467723,"uuid":"481544006","full_name":"Boavizta/cloud-scanner","owner":"Boavizta","description":"📡 Get Boavizta impact data for your AWS usage.","archived":false,"fork":false,"pushed_at":"2025-06-13T18:52:28.000Z","size":5246,"stargazers_count":40,"open_issues_count":67,"forks_count":9,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-17T14:06:44.835Z","etag":null,"topics":["aws","cli","ec2","emissions-co2","grafana-dashboard","greenops","greensoftware","serverless","sustainability"],"latest_commit_sha":null,"homepage":"https://boavizta.github.io/cloud-scanner/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Boavizta.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-04-14T09:27:16.000Z","updated_at":"2025-04-29T14:57:15.000Z","dependencies_parsed_at":"2023-12-27T08:39:13.940Z","dependency_job_id":"434ff034-4671-4a2b-841a-03a705a4b810","html_url":"https://github.com/Boavizta/cloud-scanner","commit_stats":{"total_commits":440,"total_committers":12,"mean_commits":"36.666666666666664","dds":"0.12045454545454548","last_synced_commit":"cc621ad6080b535715f6dce4aeeffbbec54ca245"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/Boavizta/cloud-scanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boavizta%2Fcloud-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boavizta%2Fcloud-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boavizta%2Fcloud-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boavizta%2Fcloud-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Boavizta","download_url":"https://codeload.github.com/Boavizta/cloud-scanner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Boavizta%2Fcloud-scanner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260419397,"owners_count":23006269,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cli","ec2","emissions-co2","grafana-dashboard","greenops","greensoftware","serverless","sustainability"],"created_at":"2024-11-05T20:13:38.095Z","updated_at":"2025-06-17T18:34:33.845Z","avatar_url":"https://github.com/Boavizta.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/da-ekchajzer/cloud-scanner/blob/main/cloudscanner_color.svg\" height=\"100\"\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Boavizta's Cloud-scanner returns \u003ci\u003eenvironmental impacts\u003c/i\u003e of your AWS Instances (EC2) usage.\n\u003c/h3\u003e\n\n---\n\n\n```mermaid\n  graph LR;\n      inventory[ Account inventory] \n      api[Impacts from BoaviztaAPI]\n      metrics[Prometheus metrics]\n      json[JSON output]\n      inventory --\u003e api\n      api --\u003e metrics\n      api --\u003e json \n```\n\nCloud scanner combines real time _inventory_ and _usage_ data from your AWS account with [Boavizta API](https://github.com/Boavizta/boaviztapi/) to offer a  view of your impacts on a given region.\n\n- multi criteria: Primary Energy consumption (PE), Abiotic resource depletion potential (ADP), and Global Warming Potential (GWP)\n- multi stage: separate impacts of resources Usage and Manufacture\n\nThis is similar to what you can get from [Datavizta](http://datavizta.boavizta.org/cloudimpact) but with automated inventory.\n\nEstimations can be filtered by tags. It eases attribution to a specific server, environment, application or service.\n\nCloud-scanner can be used:\n\n- from command line, to get an immediate view of your impacts 💻\n- as a metric server . You can use it to monitor and display real time impacts in a dashboard 📊\n\n![A example dashboard rendering cloud scanner metrics](docs/src/images/cloud-scanner-dashboard-clear.png \"A example dashboard rendering cloud scanner metrics in Grafana\")\n\nHow it works:\n\nCloud scanner follows Boavizta approach.\n\n\u003e 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⟩](https://hal.science/hal-04621947v1)\n\n![System in context diagram of cloud scanner](docs/src/images/cloud-scanner-system-in-context.png \"System in context diagram of cloud scanner\")\n\n## Usage and documentation\n\nThe complete documentation: [Introduction - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/).\n\n## Getting started 🚀\n\n- [Quickstart - dashboard using docker 🐳 - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/tutorials/quickstart-dashboard-docker.html)\n- [Quickstart - using CLI docker 🐳 - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/tutorials/quickstart-docker.html)\n\n## Deployment  as a serverless app (aws lambda) ⚡\n\nCloud scanner can also be deployed as a serverless application for aws.\n\n- [Quickstart as serverless ⚡ - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/tutorials/quickstart-serverless.html)\n- [Serverless design - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/reference/serverless-design.html)\n\n## Output formats\n\nCloud scanner returns data as _json_ or _Open Metrics_ (Prometheus) format.\n\nSee [Output data - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/reference/output-data.html)\n\n## ⚠  Perimeter / scope and limits\n\nCloud scanner _only_ estimates the impacts of your AWS EC2  instances and optionally block storage.\n\nThe limitations of cloud-scanner are documented in [Limitations - Boavizta cloud scanner 📡](https://boavizta.github.io/cloud-scanner/reference/limits.html)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboavizta%2Fcloud-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboavizta%2Fcloud-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboavizta%2Fcloud-scanner/lists"}