Last updated September 27, 2024

You can access usage on an Enterprise Account when you have the Billing permission for that Enterprise Account. With access, you can view and download usage reports using the Heroku Dashboard or Enterprise CLI.

View Usage on the Heroku Dashboard

The Usage tab of the Enterprise Account shows a usage breakdown chart and graph to provide an easier and more visual way of tracking resource consumption across the company. You can see the account’s licenses, current usage for the month and the account’s historical usage for the past year.

Export via Heroku Dashboard

In addition to the usage dashboard, you can export monthly or daily usage in CSV format. Exported CSV files contain data for teams and apps that have usage during that time period. For example: in the daily usage export, each app has a row for each date requested. The CSV file shows all usage across the account, broken down by team. If an Enterprise Team has Private Space usage for that period, you also see a row for that team for each date requested.

Both monthly and daily usage provide the following information:

• Dyno units
• Third-party add-on usage in add-on credits
• Data add-on usage in add-on credits
• Private Spaces usage in spaces credits (at team level)

Monthly usage also includes:

• Max connect rows synced

For more information about these usage types, see the Heroku Enterprise Dev Center article.

Daily Usage Limitations

• Data can be requested for up to six months in the past
• Data can be retrieved for up to 31 days at a time

Monthly Usage Limitations

• Data can be requested for up to 12 months in the past

Export via the Heroku CLI

The Heroku CLI is an essential part of using Heroku. There are CLI plugins that enable you to extend the standard CLI installation. One of these useful plugins is the Enterprise plugin, which makes it possible to manage Enterprise Accounts from the CLI and download all available reports including the usage reports.

Visit the Enterprise Accounts CLI Plugin article to install the Heroku CLI and/or the Enterprise Accounts CLI Plugin, then refer to the following guidelines to export the usage reports.

Monthly Usage

$ heroku enterprise:usage:monthly

Options

-e, --enterprise-account=enterprise-account  enterprise account name
-t, --team=team                              team name
--columns=columns                            only show provided columns (comma-separated)
--csv                                        output is csv format
--end-date=end-date                          end date of the usage period, inclusive (YYYY-MM)
--filter=filter                              filter property by partial string matching, ex: name=foo
--no-header                                  hide table header from output
--no-truncate                                do not truncate output to fit screen
--sort=sort                                  property to sort by (prepend '-' for descending)
--start-date=start-date                      start date of the usage period, defaults to current month if not provided (YYYY-MM)

Examples

$ heroku enterprise:usage:monthly --enterprise-account=account-name
$ heroku enterprise:usage:monthly --enterprise-account=account-name --columns='team,app,dyno,data'
$ heroku enterprise:usage:monthly --enterprise-account=account-name --columns='team,app,dyno,data' --sort='-data,app'
$ heroku enterprise:usage:monthly --enterprise-account=account-name --columns='team,app,dyno,data' --filter='app=myapp'
$ heroku enterprise:usage:monthly --enterprise-account=account-name --csv
$ heroku enterprise:usage:monthly --team=team-name --start-date 2019-01
$ heroku enterprise:usage:monthly --team=team-name --start-date 2019-01 --end-date 2019-03
$ heroku enterprise:usage:monthly --team=team-name --columns='app,dyno,data' --sort='-data,app'
$ heroku enterprise:usage:monthly --team=team-name --csv

Daily Usage

$ heroku enterprise:usage:daily

Options

-e, --enterprise-account=enterprise-account  enterprise account name
-t, --team=team                              team name
--columns=columns                            only show provided columns (comma-separated)
--csv                                        output is csv format
--end-date=end-date                          (required) end date of the usage period, inclusive, cannot be more than 31 days after the start date (YYYY-MM-DD)
--filter=filter                              filter property by partial string matching, ex: name=foo
--no-header                                  hide table header from output
--no-truncate                                do not truncate output to fit screen
--sort=sort                                  property to sort by (prepend '-' for descending)
--start-date=start-date                      (required) start date of the usage period, cannot be more than 6 months prior to today (YYYY-MM-DD)

Examples

$ heroku enterprise:usage:daily --enterprise-account=account-name --start-date=2019-01-01 --end-date=2019-01-15
$ heroku enterprise:usage:daily --enterprise-account=account-name --start-date=2019-01-01 --end-date=2019-01-15 --columns='team,app,dyno,data'
$ heroku enterprise:usage:daily --enterprise-account=account-name --start-date=2019-01-01 --end-date=2019-01-15 --columns='team,app,dyno,data' --sort='-data,app'
$ heroku enterprise:usage:daily --enterprise-account=account-name --start-date=2019-01-01 --end-date=2019-01-15 --columns='team,app,dyno,data' --filter='app=myapp'
$ heroku enterprise:usage:daily --enterprise-account=account-name --start-date=2019-01-01 --end-date=2019-01-15 --csv
$ heroku enterprise:usage:daily --team=team-name --start-date=2019-01-01 --end-date=2019-01-15
$ heroku enterprise:usage:daily --team=team-name --start-date=2019-01-01 --end-date=2019-01-15 --columns='app,dyno,data' --sort='-data,app'
$ heroku enterprise:usage:daily --team=team-name --start-date=2019-01-01 --end-date=2019-01-15 --csv