hyperoslo / heroku-billing

Generates a billing overview including dyno and add-on costs per application.

Heroku Billing

Generates a billing overview including dyno and add-on costs per application.

Supported Node versions: 8 or higher

Licensed under the MIT license, see LICENSE for more information.

Installation

This is a Heroku client plugin and requires the Heroku CLI to be installed.

Install heroku-billing as a plugin from npm:

heroku plugins:install @hyperoslo/heroku-billing

Usage

Scope

By default, the generated billing overview includes all applications.

heroku billing

Personal applications only:

heroku billing --personal

Team applications only:

heroku billing --team hyperoslo

A single application:

heroku billing -a hyper-rocks
heroku billing -r production

Filter applications matching given pattern:

heroku billing --pattern foobar

Inactive dynos & shared add-ons

Inactive dynos – fully scaled down processes – are not included in the overview by default as they generate a lot of clutter.

To include all inactive dynos, shown in gray:

heroku billing --include-inactive-dynos

Add-ons shared between applications are always shown in gray.

Formats

By default, the generated billing overview uses Heroku's human-readable table format.

Generate the billing overview in JSON format:

heroku billing --json

Generate the billing overview in CSV format:

heroku billing --csv

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create pull request

Credits

Hyper made this. We're a digital communications agency with a passion for good code, and if you're using this plugin we probably want to hire you.

heroku-billing's Issues

README images

Placeholder issues for images used in the README.

Support app prefix / pattern matching

To further filter included apps, we should consider supporting pattern matching:

heroku billing -p 'foobar-*'