SalesforceLabs / Developer-Carbon-Dashboard

The Salesforce Developer Carbon Dashboard

This dashboard uses Event Monitoring and CRM Analytics to illustrate the estimated carbon emissions associated with an org’s usage of Salesforce App Server CPU time via specific features and products. The dashboard does not calculate the entire carbon emissions footprint of an org. The carbon emission coefficient for a given instance is subject to change based on several factors including the carbon intensity of the electrical grid the instance relies on and the App Server SKUs serving that instance. Information in this dashboard on carbon emissions is intended for informational purposes and should not be used in regulatory or financial statements. Salesforce maintains net zero residual emissions, seeking to reduce emissions in line with a 1.5°C future while compensating for remaining emissions by procuring high-quality renewable energy and carbon credits. Learn more about Salesforce’s commitment to sustainability here.

Methodology:

Carbon per mms of Core App Server time is derived from a PUE-adjusted carbon coefficient per data center for both AWS and Salesforce first party data centers. This figure is calculated as the emissions factor in grams per megawatt hour multiplied by the PUE per datacenter. The PUE-adjusted carbon coefficient is then scaled against each App Server SKU types’ daily megawatt hour and divided by the available processing seconds, in millions, for that specific App Server SKU to get to the estimated carbon per million milliseconds of compute time. These per-SKU, per-data center carbon coefficients are then combined with data on the App Server SKU types that serve each Salesforce instance to produce a single carbon coefficient per instance. Data on the App Server SKU types comprising Salesforce instances are current as of current as of June 2023.

Licence Requirements

This CRM Analytics templated app requires Event Monitoring and CRM Analytics Growth / Plus. Growth licences are preferred in order to store the large number of event logs. This app will not work with either Event Monitoring or CRM Analytics licences on their own.

Installation Instructions

Note: The app has a dependency on:

• The latest version of the Event Monitoring analytics app (Version 59.0) with the Append feature enabled. The Developer Carbon Dashboard analytics app setup will fail otherwise.
• If you currently have v58.0 or lower of the Event Monitoring Analytics App, it is recommended that you reconfigure the app, or delete and create a new one.
• Note that recreating the Event Monitoring app using the Append feature will your view of event log data to just the previous day which will increment daily to the 30 day window.
• Only one Event Monitoring analytics app created in the target org.
  • Multiple or subsequent Event Monitoring analytics apps creates metadata components with incremental names (e.g. ApexExecution2). Currently the Developer Carbon Dashboard will not use these subsequent apps and components. You may have to delete all existing Event Monitoring analytics apps and recreate a single app using v58.0 with the Append beta feature enabled.

Prerequisite: Setting Up The Log Ingestion process:

Easy Option: CRM Analytics Templated App

• (If the "Event Monitoring Analytics" CRM Analytics app is already running with the below-listed log types, you can skip to Package Deployment)
• Select a sandbox or production org
• Ensure Event Monitoring Analytics is enabled
• Assign permissions to users
• Create the analytics app using the Append option
  • Hard Requirement: you must select the following log types in the Event Monitoring analytics app wizard:
    • ApexExecution
    • ApexTrigger
    • ApexUnexpectedException
    • ApexSoap
    • ApexRestApi
    • RestApi
    • API
    • BulkApi
    • Dashboard
    • Report
    • URI
    • VisualforceRequest
• Ensure that the Event Monitoring dataflow is scheduled to run at some frequency in order for the Developer Carbon Dashboard to show updated data.

Harder Option: Set up a custom process to push Event Logs into CRM Analytics

Deploying Developer Carbon Dashboard

There are various options:

• Download from AppExchange and create the 'Developer Carbon Dashboard' app within the Analytics Studio.
• Deploy CRM Analytics Template Bundle via sfdx source or mdapi deployments
  • Deploy only the WaveTemplateBundle metadata type
  • In Analytics Studio:
    • Create -> App -> Developer Carbon Dashboard -> Select existing Event Monitoring app -> name app ("Developer Carbon Dashboard") -> Create

Solution Overview