Skip Navigation
Show nav
Heroku Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
View categories

Categories

  • Heroku Architecture
    • Dynos (app containers)
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Command Line
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery
    • Continuous Integration
  • Language Support
    • Node.js
    • Ruby
      • Working with Bundler
      • Rails Support
    • Python
      • Background Jobs in Python
      • Working with Django
    • Java
      • Working with Maven
      • Java Database Operations
      • Working with the Play Framework
      • Working with Spring Boot
      • Java Advanced Topics
    • PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
    • Heroku Data For Redis
    • Apache Kafka on Heroku
    • Other Data Stores
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
    • Compliance
  • Heroku Enterprise
    • Private Spaces
      • Infrastructure Networking
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
    • Single Sign-on (SSO)
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Heroku Enterprise
  • Enterprise Accounts
  • Enterprise Accounts Usage

Enterprise Accounts Usage

English — 日本語に切り替える

Last updated January 27, 2022

Table of Contents

  • Export via Heroku Dashboard
  • Export via the Heroku CLI

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.

Enterprise Accounts usage breakdown

Enterprise Accounts usage graph

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.

Enterprise Accounts Create

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

Keep reading

  • Enterprise Accounts

Feedback

Log in to submit feedback.

Managing Teams in Enterprise Accounts Invite a Team Member to Manage a New Enterprise Account

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Podcasts
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing

Subscribe to our monthly newsletter

Your email address:

  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Heroku Podcasts
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Facebook
  • Instagram
  • Github
  • LinkedIn
  • YouTube
Heroku is acompany

 © Salesforce.com

  • heroku.com
  • Terms of Service
  • Privacy
  • Cookies
  • Cookie Preferences