Kubernetes Carbon Intensity Exporter

Provides a data exporter by which Kubernetes operators can leverage the carbon intensity data from 3rd party for carbon-aware workload scheduling.
https://github.com/azure/kubernetes-carbon-intensity-exporter

Category: Emissions
Sub Category: Carbon Intensity and Accounting

Keywords

carbon-intensity kubernetes sustainable

Keywords from Contributors

measur transforms observation web-mapping 3d-map conversion archiving simulator optimize orchestration

Last synced: about 24 hours ago
JSON representation

Repository metadata

Kubernetes Carbon Intensity Exporter

• Host: GitHub
• URL: https://github.com/azure/kubernetes-carbon-intensity-exporter
• Owner: Azure
• License: mit
• Created: 2023-03-23T23:10:40.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-18T23:02:33.000Z (about 1 month ago)
• Last Synced: 2025-04-09T10:12:03.050Z (18 days ago)
• Topics: carbon-intensity, kubernetes, sustainable
• Language: Go
• Homepage:
• Size: 178 KB
• Stars: 36
• Watchers: 66
• Forks: 10
• Open Issues: 11
• Releases: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: CODEOWNERS
  • Security: SECURITY.md
  • Support: SUPPORT.md

README.md

export WT_USERNAME=XXXX   # WattTime auth info.
export WT_PASSWORD=YYYY
export REGION=westus     # The region where the AKS cluster locates.

helm del carbon-intensity-exporter
helm install carbon-intensity-exporter \
   --set carbonDataExporter.region=$REGION \
   --set wattTime.username=$WT_USERNAME \
   --set wattTime.password=$WT_PASSWORD \
   ./charts/carbon-intensity-exporter

export EM_API_TOKEN=XXXX   # Electricity Maps API token.
export EM_API_TOKEN_HEADER=auth-token   # Electricity Maps API token HTTP header.
export EM_BASE_URL=https://api.electricitymap.org/v3/
export PROVIDER=ElectricityMaps
export REGION=westus     # The region where the AKS cluster locates.

helm del carbon-intensity-exporter
helm install carbon-intensity-exporter \
   --set carbonDataExporter.region=$REGION \
   --set providerName=$PROVIDER \
   --set electricityMaps.apiToken=$EM_API_TOKEN \
   --set electricityMaps.apiTokenHeader=$EM_API_TOKEN_HEADER \
   --set electricityMaps.baseURL=$EM_BASE_URL \
   ./charts/carbon-intensity-exporter

$ kubectl get pod -n kube-system | grep carbon-intensity-exporter
$ carbon-intensity-exporter-XXXXXXX-XXXXX   2/2     Running   0          3m25s

$ kubectl get configmap -n kube-system | grep carbon-intensity
$ carbon-intensity                        7      3m25s

apiVersion: v1
kind: ConfigMap
metadata:
  name: carbonintensity
  namespace: kube-system
immutable: true
data:
  lastHeartbeatTime: # The latest time that the data exporter controller sends the data. 
  message: # Additional information for user notification, if any. 
  numOfRecords: # The number can be any value between 0 (no records for the current location) and 24 * 12. 
  forecastDateTime: # The time when the raw data was generated.
  minForecast: # min forecast in the data.
  maxForecast: # max forecast in the data.
binarydata: 
  data: # json marshal of the EmissionsData array.

Owner metadata

• Name: Microsoft Azure
• Login: Azure
• Email:
• Kind: organization
• Description: APIs, SDKs and open source projects from Microsoft Azure
• Website: https://docs.microsoft.com/en-us/azure/
• Location: United States of America
• Twitter: Azure
• Company:
• Icon url: https://avatars.githubusercontent.com/u/6844498?v=4
• Repositories: 2270
• Last ynced at: 2025-04-25T21:02:11.366Z
• Profile URL: https://github.com/Azure

GitHub Events

Total

• Create event: 1
• Release event: 1
• Issues event: 3
• Watch event: 2
• Issue comment event: 2
• Member event: 2
• Push event: 2
• Pull request review event: 1
• Pull request event: 3
• Fork event: 1

Last Year

• Create event: 1
• Release event: 1
• Issues event: 3
• Watch event: 2
• Issue comment event: 2
• Member event: 2
• Push event: 2
• Pull request review event: 1
• Pull request event: 3
• Fork event: 1

Committers metadata

Last synced: 7 days ago

Committer domains:

• microsoft.com: 1

Issue and Pull Request metadata

Last synced: 2 days ago

Package metadata

• Total packages: 2
• Total downloads: unknown
• Total docker downloads: 59
• Total dependent packages: 0 (may contain duplicates)
• Total dependent repositories: 0 (may contain duplicates)
• Total versions: 6

Dependencies

Score: 10.141716741268379