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