GreenFrame CLI

Purpose:: Estimate the carbon footprint of a user scenario on a web application (full-stack) using Docker
Type:: #tool/dev

Website:: https://www.greenframe.io/
Docs:: https://docs.greenframe.io/commands
Source Code:: https://github.com/marmelab/greenframe-cli
License:: Elastic License
News:: https://marmelab.com/en/blog/#greenframe
Created by:: marmelab

Known by::

Description

Estimate the carbon footprint of a user scenario on a web application. Full-stack analysis (browser, screen, network, server).

Can be used standalone, in a CI/CD pipeline, and in conjunction with the greenframe.io service.

GreenFrame uses docker stats to collect system metrics (CPU, memory, network and disk I/O, scenario duration) every second from the browser and containers.

How does it work?

GreenFrame relies on a scientific model of the energy consumption of a digital system built in collaboration with computer scientists at Loria.

While running the scenario, GreenFrame uses docker stats to collect system metrics (CPU, memory, network and disk I/O, scenario duration) every second from the browser and containers.

It then uses the GreenFrame Model to convert each of these metrics into energy consumption in Watt hours. GreenFrame sums up the energy of all containers over time, taking into account a theoretical datacenter PUE (set to 1.4, and configurable) for server containers. This energy consumption is then converted into CO2 emissions using a configurable "carbon cost of energy" parameter (set to 442g/kWh by default).

GreenFrame repeats the scenario 3 times and computes the average energy consumption and CO2 emissions. It also computes the standard deviation of energy consumption and CO2 emissions to provide a confidence interval.

Model

Name: GreenFrame (in the past called "Argos")
Description: greenframe-cli/src/model

The GreenFrame model computes an energy consumption (Wh) from:

• collected metrics (cpu time, network traffic, etc.) on one or more usage scenarios.
• knowledge of the infrastructure (number of servers, network traffic), users (number of requests).

GreenFrame.io

GreenFrame.io is a web service to analyze public websites. It can be tried out for free for one month.
GreenFrame CLI is the core of GreenFrame.io (the collector and the model).

GreenFrame.io: What is the carbon footprint of a web page?

GreenFrame.io only estimates the impact of a simple visit (or rather, the average of 4 visits), and only accounts for the client and the network impact.

GreenFrame Enterprise

Purpose: Analyze full-stack applications (frontend, backend services and databases)