Enterprise Accounts Usage
Last updated January 27, 2022
Table of Contents
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
Starting August 27th 2019, monthly usage report has a few small changes: Date column is now called month and is in YYYY-MM format.
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 clickView 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