Enterprise Accounts Usage

Last updated 10 October 2019

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

Export as CSV

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. 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:

• Connect rows synced

In addition to downloadable reports, the Usage tab of the Enterprise Account also shows a usage break down chart and graph to provide an easier and more visual way of tracking resource consumption across the company.

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 Heroku Dashboard

In addition to the usage reports for Enterprise Accounts, which shows usage for all Enterprise Teams underneath that account, you can view Enterprise Team usage with the Heroku Dashboard in two ways:

• Visiting the Usage tab of the Enterprise Account and click View Usage next to the Enterprise Team.
• Navigating to the Enterprise Team and select the Usage tab.

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.

Please 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