最終更新日 2022年01月27日(木)

Enterprise Account の Billing​ アクセス許可を持っている場合は、その Enterprise Account に関する使用状況にアクセスできます。さらに、Enterprise Team の Admin​ ロールを持っている場合は、その Enterprise Team に関する使用状況にアクセスできます。アクセスできる場合は、Heroku Dashboard または Enterprise CLI を使用して使用状況レポートをダウンロードできます。

CSV としてのエクスポート

毎月または毎日の使用状況を CSV 形式でエクスポートできます。エクスポートされた CSV ファイルには、その期間中に使用状況が存在するチームとアプリに関するデータが含まれています。たとえば、毎日の使用状況のエクスポートでは、要求された日付ごとの行が各アプリに存在します。Enterprise Team にその期間中の Private Space​ の使用状況が存在する場合は、要求された日付ごとのそのチームの行も表示されます。

毎月の使用状況と毎日の使用状況はどちらも、次の情報を提供します。

• dyno ユニット
• アドオンクレジットでのサードパーティーアドオンの使用状況
• アドオンクレジットでのデータアドオンの使用状況
• Spaces クレジットでの (チームレベルでの) Private Spaces の使用状況

毎月の使用状況には、次のものも含まれています。

• 同期された Connect 行

ダウンロード可能なレポートに加えて、Enterprise Account の Usage​ (使用状況) タブには、会社全体でのリソース消費をより簡単かつ視覚的に追跡する方法を提供するための使用状況の内訳チャートおよびグラフも表示されます。

これらの使用状況の種類についての詳細は、Heroku Enterprise Dev Center の記事​を参照してください。

毎日の使用状況の制限

• 最大過去 6 か月間のデータを要求できる
• 同時に最大 31 日間のデータを取得できる

毎月の使用状況の制限

• 最大過去 12 か月間のデータを要求できる

Heroku Dashboard 経由のエクスポート

Enterprise Account に関する使用状況レポート (これは、そのアカウントの下のすべての Enterprise Team に関する使用状況を表示する) に加えて、Heroku Dashboard を使用して次の 2 つの方法で Enterprise Team の使用状況を表示できます。

• Enterprise Account の Usage​ (使用状況) タブにアクセスし、Enterprise Team の横にある View Usage​ (使用状況の表示) をクリックします。
• Enterprise Team に移動し、Usage​ (使用状況) タブを選択します。

Heroku CLI 経由のエクスポート

Heroku CLI は、Heroku を使用するための不可欠な部分です。標準の CLI インストールを拡張するために使用できる CLI プラグインが存在します。これらの役立つプラグインの 1 つが Enterprise プラグインです。これは、CLI から Enterprise Account を管理したり、使用状況レポートを含む使用可能なすべてのレポートをダウンロードしたりできるようにします。

Enterprise Accounts CLI プラグイン​の記事にアクセスして Heroku CLI か Enterprise Accounts CLI プラグイン、またはその両方をインストールしてから、次のガイドラインを参照して使用状況レポートをエクスポートしてください。

毎月の使用状況

$ heroku enterprise:usage:monthly

オプション

-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)

例

$ 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

毎日の使用状況

$ heroku enterprise:usage:daily

オプション

-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)

例

$ 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