GitLabクレジットダッシュボード

GitLabクレジットダッシュボードには、GitLabクレジットの使用状況に関する情報が表示されます。このダッシュボードを使用して、クレジットの消費状況を監視し、トレンドを追跡し、使用パターンを特定できます。

クレジットの消費を管理できるように、GitLabは、請求アカウントにリンクされているカスタマーポータルのユーザーに以下の情報をメールで送信します:

• クレジットの月間使用状況の概要
• クレジット使用量が50％、80％、100％のしきい値に達したときの通知

ダッシュボードには、カスタマーポータルとGitLabからアクセスできます。GitLab Dedicatedでは、ダッシュボードはカスタマーポータルおよびインスタンス管理者が利用できます。グループレベルおよび個人のクレジット使用状況ビューは、GitLab.comでのみ利用できます。

カスタマーポータル

カスタマーポータルのGitLabクレジットダッシュボードでは、使用状況とコストを最も詳細に確認できます。

ダッシュボード上の使用済みクレジットは、利用可能なクレジット残高から消費された量を表します。超過分（オンデマンドGitLabクレジット）については、使用量課金の利用規約に同意している場合、使用済みクレジットは後日請求されるオンデマンド利用分を表します。

ダッシュボードには、主要なメトリクスの概要を示すカードが表示されます:

• 当月の使用量: 当月中に使用したGitLabクレジットの合計（月間コミットメントがある場合）
• プランに含まれるクレジット: サブスクリプションに含まれるクレジットの合計（月間コミットメントがある場合）
• コミット済みクレジット: 月間コミットメントプールから消費したクレジット（該当する場合）
• 月間免除: 免除によって残っているクレジット（該当する場合）
• オンデマンド使用量: プランに含まれるクレジットおよびコミット済みクレジットを超えて消費されたクレジット。すべてのオンデマンドクレジットを相殺するのに十分な免除クレジットがある場合、GitLabクレジットダッシュボードではオンデマンドカードは表示されず、代わりに月間免除カードが表示されます。
• 使用量制御のステータス: 個々のユーザーが、ユーザーごとのクレジット上限に達したためにAgent Platformへのアクセスをブロックされているかどうか。

GitLab

GitLab内のGitLabクレジットダッシュボードでは、組織内のクレジットの使用状況を運用面から可視化します。ダッシュボードを使用して、どのユーザー、グループ、またはプロジェクトがクレジット使用の主な要因になっているかを把握し、リソース割り当てについて十分な情報に基づいた意思決定を行えます。

このダッシュボードには、次の情報が表示されます:

• 組織の使用量: GitLabインスタンスまたはグループ全体の合計クレジット使用量、アクティブユーザー数、1日の平均クレジット使用量、ピーク日の使用量
• クレジットの合計使用量: すべての製品にわたる日次クレジット使用量。棒チャートとして表示されます
• ユーザー別の使用量: 各ユーザーが使用したクレジット数
• ユーザー詳細ビュー: 各ユーザーの個々の使用状況イベント。各クレジットベース機能のセッション詳細へのリンク付き。
• 製品ごとの使用状況: クレジットベース機能で消費されたクレジット数と総クレジットに占める割合

GitLabクレジットダッシュボードを表示する

デフォルトでは、GitLabクレジットダッシュボードに個々のユーザーデータは表示されません。表示するには、グループまたはインスタンスでこの設定を有効にする必要があります。

人間以外の主体の使用量

クレジット使用量は、人間のユーザーまたは人間以外の主体（たとえば、SAST誤検出判定フローのようなAI機能）のいずれかによってトリガーされることがあります。

クレジットがどこで消費されているかを特定しやすくするため、GitLabクレジットダッシュボードのユーザー別使用量タブには、人間以外の主体を表す行の横に自動フローバッジが表示されます。このバッジがない行は、人間のユーザーを表します。

自動フローバッジの表示は、グループとインスタンスで利用できるGitLabクレジットのユーザーデータを表示する設定によって制御されます。

使用量上限

予期しない超過料金を防ぐために、サブスクリプションおよびユーザーレベルで月ごとのGitLabクレジット上限を設定できます。クレジット消費が設定された上限に達すると、クレジットベース機能へのアクセスは、次の請求期間が始まるまで、または管理者が上限を調整または無効にするまで、自動的に停止されます。

次の使用量上限タイプを使用できます:

現在の請求期間のオンデマンド使用量が設定された上限に達するか超えると、そのサブスクリプションまたはインスタンスのすべてのユーザーに対してすべてのクレジットベース機能が停止され、GitLabは請求アカウントマネージャーにメール通知を送信します。ユーザーレベルの上限では、その上限に達した個々のユーザーのみが停止されます。

フラットユーザーキャップとユーザーごとの上書きキャップは、ユーザーの含まれる割り当てを超える使用量に適用されます。ユーザーにまだ含まれるクレジットがある場合、使用量が上限に達した後でも、含まれるクレジットを消費し続けることができます。上限は、ユーザーの含まれるクレジットが使い果たされた後にのみ適用されます。

上限に達したユーザーは、上限が引き上げられるか、次の請求期間が開始されるまで、Agent Platform機能にアクセスできません。

使用量カウンターは、各請求期間の開始時に自動的にリセットされます。上限値は、変更されない限り、請求期間をまたいで保持されます。

上限は、利用可能な最新の使用量データに基づいて適用されます。データはリアルタイムではないため、適用が有効になる前に、限定的な追加のGitLabクレジット使用量が発生する可能性があります。

上限は、ユーザーが割り当てられたGitLabクレジットを消費するのを停止しません。適用はユーザーごとに開始され、そのユーザーの含まれる割り当てが使い果たされた後にのみ行われます。それまでは、ユーザーは上限値に関係なく、0の上限を含め、GitLab Duo Agent Platformへのフルアクセスを保持します。

含まれる残高に関係なく、すべてのGitLabクレジットの消費を直ちに停止するには、対象ユーザーまたはネームスペースでGitLab Duoを無効にしてください。

上限値の適用方法は、上限の種類によって異なります:

• A サブスクリプションレベルのキャップは、オンデマンドの使用量にのみ適用されます。この上限は、各ユーザーの含まれるクレジットに加えて、サブスクリプション全体で許可されるオンデマンド使用量です。
• A ユーザーごとの上限は、含まれるクレジットを含むユーザーの総使用量に適用されます。したがって、ユーザーは、含まれる割り当てと上限のいずれか大きい方まで消費できます。

例

サブスクリプションレベルのキャップの場合、10人のユーザーがそれぞれ100のGitLabクレジットを含むサブスクリプションを検討します。請求アカウントマネージャーは、サブスクリプションレベルのオンデマンド上限を0に設定します。

• 既に含まれるクレジット100すべてを使い果たしたユーザーは、それ以上の使用がオンデマンドになるため、Agent Platform機能から直ちにブロックされます（次回の適用チェック時）。
• 含まれるクレジットのうち40しか使用していないユーザーは、引き続きAgent Platform機能を使用し、残りの60の含まれるクレジットを消費できます。0の上限はまだ適用されません。

ユーザーごとの上限の場合、24のGitLabクレジットが含まれるユーザーを検討します。

• 50のユーザーごとの上限では、ユーザーは合計50クレジット（含まれる割り当てを超えて26クレジット）を使用した後にブロックされます。
• 10のユーザーごとの上限では、ユーザーは24クレジット（含まれる割り当てが使い果たされたとき）を使用した後にブロックされます。

サブスクリプションレベルの使用量上限を設定する

前提条件:

• 請求先アカウントマネージャーである必要があります。

1. カスタマーポータルにサインインします。
2. サブスクリプションカードで、GitLabクレジットダッシュボードを選択します。
3. 利用制御を選択します。
4. オンデマンドクレジットキャップパネルで、オンデマンドクレジットキャップを設定トグルをオンにします。
5. 請求期間ごとに許可するオンデマンドGitLabクレジットの最大数を入力します。
6. 変更を保存を選択します。

上限が、現在の請求期間について現時点で報告されているオンデマンド使用量の合計を下回る値に設定された場合、次回の適用チェック時に直ちに上限に達したものと見なされます。

キャップを無効にするには、オンデマンドクレジットキャップを設定トグルをオフにします。無効にすると、サブスクリプションレベルのオンデマンドGitLabクレジット上限は適用されず、既存の請求動作に戻ります。

GraphQL APIを使用して、使用量上限を表示したり、一律のユーザーレベル上限またはユーザーごとのオーバーライド上限を設定したりできます。

クレジットキャップを管理する

クレジットキャップを管理するには:

クレジットキャパシティページでは、以下を設定できます:

• フラットユーザーキャップ: サブスクリプションのすべてのユーザーに適用されるデフォルトのクレジットキャップ。
• ユーザーごとのキャップ上書き: フラットユーザーキャップを上書きする、個々のユーザーに対する特定の上限。

フラットユーザーキャップを設定する

すべてのユーザーにデフォルトで適用されるフラットユーザーキャップを設定するには:

1. ユーザーが請求期間ごとに消費できるGitLabクレジットの最大数を入力します。
2. 適用を有効にするには、トグルをオンにします。
3. 保存を選択します。

ユーザーごとのキャップ上書きを設定する

個々のユーザーのキャップ上書きを追加、更新、無効にできます。

上書きを追加するには:

1. 上書きを追加を選択します。
2. 1人以上のユーザーを選択します。
3. キャップ値を設定し、有効トグルをオンまたはオフにします。
4. 保存を選択します。

上書きを更新するには:

1. ユーザーごとのキャップ上書きの下で、ユーザーのキャップ値を調整し、有効トグルをオンまたはオフにします。
2. 保存を選択します。

上書きをオフにするには:

1. ユーザーごとのキャップ上書きの下で、ユーザーの有効トグルをオフにします。
2. 保存を選択します。

使用量制御のステータス

ユーザーごとのクレジット上限が有効になっている場合、GitLabクレジットダッシュボードのユーザー別使用量タブには、使用量制御のステータス列が表示されます。この列は、各ユーザーがクレジットベース機能にアクセスできるか、クレジットキャップに達したためにブロックされているかを示します。

利用制御ステータス列は、GitLabがユーザーに対してキャップを適用した場合にのみ、利用ブロック中のステータスを表示します。GitLabは、ユーザーの含まれるクレジットが使い果たされた後にキャップを適用します。キャップに達してもまだ含まれるクレジットがあるユーザーは、含まれるクレジットを消費し続けることができるため、通常利用のステータスになります。

この列には、次のいずれかのステータスが表示されます:

ダッシュボードには、どの種類のキャップがユーザーをブロックしたかは表示されません。キャップの種類を決定するには、GraphQL APIを使用します。

利用制御ステータス列には、ユーザーごとのキャップのみが表示されます。サブスクリプションレベルのオンデマンドキャップは、個々のユーザーではなくサブスクリプション全体に適用され、この列には表示されません。

クレジット上限に達したユーザーのブロックを解除する

ユーザーごとのオーバーライドGraphQL APIを使用して、ブロックされたユーザーのアクセスを復元できます。

ユーザーのブロックを解除するには、次のいずれかの操作を行います:

• 上限を引き上げる: ユーザーごとのオーバーライド上限をより高い値に設定し、そのユーザーの使用量が新しい上限を下回るようにします。
• 上限を削除する: ユーザーごとのオーバーライドを削除し、そのユーザーが個別の上限の対象にならないようにします。

キャップを更新すると、ユーザーのステータスが通常利用に変更され、クレジットベース機能を再度使用できるようになります。

ユーザーのクレジット使用量の詳細を表示する

ユーザーの個別の使用イベントを詳細ビューで表示するには:

1. GitLabクレジットダッシュボードで、ユーザー別使用量タブを選択します。
2. ユーザー列で、表示したいユーザーを選択します。
3. セッションの詳細を表示するには、アクション列で、表示したいアクションを選択します。

使用量データをエクスポートする

サブスクリプションのクレジット使用量データをカスタマーポータルでCSVファイルとしてエクスポートできます。CSVファイルには、当月の各日に使用された使用イベントとクレジットが一覧表示されます。

前提条件:

• 請求先アカウントマネージャーである必要があります。

1. カスタマーポータルにサインインします。
2. サブスクリプションカードで、GitLabクレジットダッシュボードを選択します。
3. 使用期間ドロップダウンリストから、データをエクスポートする期間を選択します。
4. 使用量データをエクスポートを選択します。