正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

管理者向けRunnerフリートダッシュボード

  • プラン: Ultimate
  • 提供形態: GitLab Self-Managed

GitLab管理者は、Runnerフリートダッシュボードを使用して、インスタンスRunnerのヘルス状態を評価できます。Runnerフリートダッシュボードには、以下が表示されます:

  • Runnerインフラストラクチャによって引き起こされた最近のCIエラー
  • 最もビジーなRunnerで実行されている同時ジョブの数
  • インスタンスRunnerで使用されるコンピューティング時間
  • ジョブキュー時間(ClickHouseを使用する場合のみ利用可能)

Runnerフリートダッシュボード

ダッシュボードのメトリクス

次のメトリクスは、Runnerフリートダッシュボードで使用できます:

メトリック説明
オンラインインスタンス全体でオンラインになっているRunnerの数。
オフライン現在オフラインになっているRunnerの数。登録されたものの、GitLabに接続されたことのないRunnerは、この数には含まれていません。
アクティブなRunner現在アクティブなRunnerの総数。
Runnerの使用率(前月)ClickHouseが必要: 前月の各プロジェクトまたはグループRunnerで使用された合計コンピューティング時間。このデータは、コスト分析のためにCSVファイルとしてエクスポートできます。
ジョブを選択するまでの待機時間ClickHouseが必要: Runnerがジョブをピックアップするまで、ジョブがキューで待機する平均時間。このメトリクスは、組織の目標サービスレベル目標(SLO)で、RunnerがCI/CDジョブキューを処理できるかどうかについてのインサイトを提供します。このデータは24時間ごとに更新されます。

ClickHouseを設定しない場合、フリートダッシュボードページには、ClickHouseバックエンドに依存するウィジェットは入力されたされません。

Runnerフリートダッシュボードを表示する

前提要件:

  • 管理者である必要があります。

Runnerフリートダッシュボードを表示するには:

  1. 左側のサイドバーの下部で、管理者を選択します。
  2. Runnersを選択します。
  3. フリートダッシュボードを選択します。

ほとんどのダッシュボードは追加のアクションなしで動作しますが、ジョブを選択するまでの待機時間のチャートと、エピック11183で提案されている機能は例外です。これらの機能を使用するには、追加のインフラストラクチャをセットアップする必要があります。

インスタンスRunnerで使用されるコンピューティング時間をエクスポートする

前提要件:

Runnerの使用状況を分析するには、ジョブの数と実行されたRunner時間を含むCSVファイルをエクスポートします。CSVファイルには、各プロジェクトのRunnerタイプとジョブステータスが表示されます。CSVは、エクスポートが完了するとメールで送信されます。

インスタンスRunnerで使用されるコンピューティング時間をエクスポートするには:

  1. 左側のサイドバーの下部で、管理者を選択します。
  2. Runnersを選択します。
  3. フリートダッシュボードを選択します。
  4. Export CSV(CSVをエクスポート)を選択します。

ClickHouseでCI分析機能をさらに有効にする

  • プラン: Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed
  • ステータス: ベータ

この機能はベータ版であり、予告なく変更される場合があります。詳細については、エピック11180を参照してください。

CI分析の追加機能を有効にするには、ClickHouseのインテグレーションを構成します。

概要については、ClickHouseを使用したRunnerフリートダッシュボードの設定を参照してください。

フィードバック

Runnerフリートダッシュボードの改善にご協力いただくため、イシュー421737でフィードバックをお寄せください。特に:

  • ダッシュボードを機能させるためのGitLabの設定がどれほど簡単か難しかったか。
  • ダッシュボードがどれほど役に立ったか。
  • そのダッシュボードに他にどのような情報を表示したいか。
  • その他の関連する考えやアイデア。