最終更新日 2025年03月18日(火)

Heroku Enterprise Usage ダッシュボードでは、アカウントのライセンスや使用状況に関する詳細なデータが提供されるため、データに基づいてビジネス上の意思決定を行うことができます。パーソナライズされたダッシュボードのインサイトにアクセスするには、アカウントが Enterprise プランであり、ユーザーに Billing​ 権限​が付与されている必要があります。

Heroku Dashboard での使用状況の確認

Heroku Enterprise Usage ダッシュボードには 4 つのセクションがあります。

• プラン
• ダウンロード可能な使用状況
• 現在の使用状況
• 使用履歴

プラン

Plan (プラン) セクションには、アカウントの現在のライセンス情報に関する重要な詳細が表示されます。この情報には、ライセンスを保有している Heroku 製品とその数量、有効な契約の開始日と終了日が含まれます。

ダウンロード可能な使用状況

Downloadable Usage (ダウンロード可能な使用状況) セクションでは、Heroku チームとアプリケーション名ごとに詳細な使用状況情報をエクスポートできます。ドロップダウンメニューから過去 12 か月間の任意の月を選択し、Download as CSV​ をクリックします。

過去 6 か月以内の最大31日間の特定の日付における 1 日の使用状況データを取得するには、Daily usage over a custom time period (up to 31 days)​ ボックスをオンにし、月の途中の使用状況に応じて希望の日付範囲を選択します。

.csv ファイルには、次の Heroku 製品の使用状況情報が含まれます。

• dyno ユニット
• Heroku Connect 行​ (月次レポートのみ)
• サードパーティのアドオン
• データアドオン
• Private Space
• Shield Private Space

一般的なアドオンクレジットの使用状況

一般的なアドオンクレジット​は、Heroku サービスとプレミアム機能全体に適用できるクレジットです。お客様は契約を変更することなく、必要に応じてリソースの割り当てを調整できます。

一般的なアドオンクレジットは次の順序で適用されます。

1. Heroku 以外のデータアドオン: ​Elements Marketplace​ のアドオンサービス用
2. データアドオン: ​Heroku Postgres​、Heroku Key-Value Store​、Apache Kafka on Heroku​ などの Heroku Data Services 用
3. Private Space
4. Shield Private Space

これらの製品で発生したオンデマンド使用分​は、利用可能な一般アドオンクレジットを使用して支払われます。

Private Space クレジット

.csv ファイルには、Private Space と Shield Private Space の消費が 2 つの方法で表示されます。

• 使用された Private Space と Shield Private Space の数
• 使用された Private Space クレジットと Shield Private Space クレジットの数

1 つの Private Space のライセンスは 1,000 Private Space クレジットに相当し、1 つの Shield Private Space のライセンスは 3,000 Shield Private Space クレジットに相当します。スペースの使用状況をクレジットで表示する理由は、一般的なアドオンクレジットを使用して Private Space と Shield Private Space の消費をカバーできるためです。

たとえば、1 つの Private Space を半月実行した場合、0.5 Private Space を消費し、これは 500 Private Space クレジットに相当します。

.csv ファイルの Spaces​ フィールドは、その月に使用された Private Space と Shield Private Space の合計数を示します。

現在の使用状況

Current Usage (現在の使用状況) セクションでは、当月の使用量がライセンス量と比較して表示されます。テーブルの各行は使用中の製品を表し、[使用量​] 列にはライセンス量に対する使用量が表示されます。有効なライセンスがない場合、この列には使用された製品の数量のみが表示されます。

[契約​] 列と [オンデマンド使用分​] 列には、製品の使用量の内訳が視覚的に示されます。これにより、ライセンス量、一般的なアドオンクレジットでカバーされる使用量、契約を超過した使用量がわかります。このデータは 24 時間ごとに更新されます。

Heroku がオンデマンド使用分に対して請求する方法については、「制限されたアドオンのオンデマンド使用分​」を参照してください。

使用履歴

Usage History (使用履歴) セクションには、過去 12 か月間の Heroku の使用状況が表示されます。各縦棒は特定の月の合計使用量を表し、リソースの割り当てと残りのクレジットがわかりやすく色分けされています。この視覚化により、毎月のリソース消費を把握しやすくなります。

• ライトパープル: 未使用のライセンス量
• ダークパープル: ライセンス量でカバーされる使用量
• イエロー: ​一般的なアドオンクレジット​でカバーされる使用量
• レッド: ライセンス量を超過した使用量

Heroku CLI 経由のエクスポート

Heroku CLI は、Heroku を効果的に使用するために不可欠なツールです。標準の CLI インストール機能を拡張するさまざまな CLI プラグインをサポートしています。Enterprise プラグインは、特に役立つプラグインの 1 つです。これは、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