GitLab管理者エリア

管理者エリアは、GitLab Self-Managedインスタンスの機能を管理および設定するためのWeb UIを提供します。管理者として管理者エリアにアクセスするには、次の手順に従います。

• GitLab 18.5以降:
  • 右上隅で、管理者を選択します。
  • トップバーで検索または移動先を選択し、次に管理者エリアを選択します。
• GitLab 17.3以降: 左側のサイドバーの下部にある管理者を選択します。
• GitLab 16.7以降: 左側のサイドバーの下部にある管理者エリアを選択します。
• GitLab 16.1以降: 左側のサイドバーで検索または移動先を選択し、次に管理者を選択します。
• GitLab 16.0以前: トップバーでメインメニュー > 管理者を選択します。

GitLabインスタンスで管理者モードを使用している場合、管理者を表示するには、セッションの管理者モードを有効にする必要があります。

プロジェクトを管理する

GitLabインスタンス内のすべてのプロジェクトを管理するには、次の手順に従います。

1. 右上隅で、管理者を選択します。

2. 概要 > プロジェクトを選択します。ページには、各プロジェクトの以下が表示されます。

   • 名前
   • 説明
   • 表示レベル
   • ロール
   • トピック
   • ステータス
   • ストレージサイズ
   • スターの数
   • フォーク数
   • マージリクエスト数
   • Issue数

3. オプション: タブを選択します。

   • 有効は、すべて有効なプロジェクトを表示します。
   • 無効は、アーカイブされているか、削除保留中のプロジェクトを表示します。

4. オプション: フィルターを組み合わせて、目的のプロジェクトを検索します。絞り込み条件は以下のとおりです。

   • 名前。3文字以上入力してください。
   • 表示レベル（パブリック、内部、またはプライベート）。
   • プログラミング言語。
   • グループまたはユーザーネームスペース。
   • オーナーロールを持つプロジェクト。

5. オプション: 並べ替え順を変更するには、並べ替えのドロップダウンリストを選択し、目的の順序を選択します。使用可能な並べ替えオプションは次のとおりです。

   • 名前
   • 作成日
   • 更新日
   • お気に入り
   • ストレージサイズ

プロジェクトを編集する

管理者エリアのプロジェクトページからプロジェクトの名前または説明を編集するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > プロジェクトを選択します。
3. 編集するプロジェクトを見つけ、アクション（ ）> 編集を選択します。
4. プロジェクト名またはプロジェクトの説明を編集します。
5. 変更を保存を選択します。

プロジェクトを削除する

プロジェクトを削除するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > プロジェクトを選択します。
3. 編集するプロジェクトを見つけ、アクション（ ）> 削除を選択します。
4. 確認ダイアログで、はい、プロジェクトを削除しますを選択します。

ユーザーを管理する

管理者エリアのユーザーページには、各ユーザーに関する次の情報が表示されます。

• ユーザー名
• メールアドレス
• プロジェクトメンバーシップ数
• グループメンバーシップ数
• アカウント作成日
• 最後のアクティビティの日付

管理者エリアのユーザーページからすべてのユーザーを管理するには、次の手順に従います。

1. 右上隅で、管理者を選択します。

2. 概要 > ユーザーを選択します。

3. オプション: 並べ替え順（デフォルトはユーザー名）を変更するには、次の手順に従います。

   1. 並べ替えのドロップダウンリストを選択します。
   2. 目的の順序を選択します。

4. オプション: ユーザー検索ボックスを使用して、次の条件でユーザーを検索およびフィルタリングします。

   • ユーザーのアクセスレベル。
   • 2要素認証が有効/無効。
   • ユーザーの状態。
   • ユーザーのタイプがプレースホルダーであるかどうか。

5. オプション: ユーザー検索ボックスにテキストを入力し、Enterキーを押します。この大文字と小文字を区別しないテキスト検索では、名前、ユーザー名、メールアドレスに部分一致が適用されます。

ユーザーを編集するには、ユーザーの行を見つけて編集を選択します。

ユーザーを削除する

管理者エリアのユーザーページから、ユーザーを削除するか、ユーザーとそのコントリビュートを削除するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > ユーザーを選択します。
3. 削除するユーザーを見つけます。行で、ユーザー管理（ ）を選択し、目的のオプションを選択します。

ユーザーの代理

管理者は、他の管理者を含む他のユーザーの代理となることができます。これにより、GitLabでユーザーに表示される内容を確認し、ユーザーに代わってアクションを実行できます。

ユーザーの代理となるには、次の手順に従います。

• UIを使用する場合は、以下のとおりです。
  1. 右上隅で、管理者を選択します。
  2. 左側のサイドバーで、概要 > ユーザーを選択します。
  3. ユーザーのリストからユーザーを選択します。
  4. 右上にあるなりすましを選択します。
  5. なりすましを停止するには、上部の左側のサイドバーで代理を停止（ ）を選択します。
• APIを使用する場合は、代理トークンを使用します。

すべての代理アクティビティは、監査イベントとしてキャプチャされます。デフォルトでは、代理は有効になっています。GitLabの設定で代理を無効にすることもできます。

ユーザーアイデンティティ

認証プロバイダーを使用している場合、管理者はユーザーのアイデンティティを確認できます。このページでは、SCIMアイデンティティを含むユーザーのアイデンティティが表示されます。この情報を使用して、SCIM関連の問題を解決したり、アカウントに使用されているアイデンティティを確認したりできます。

これを行うには、次の手順を実行します:

1. 右上隅で、管理者を選択します。
2. 概要 > ユーザーを選択します。
3. ユーザーのリストからユーザーを選択します。
4. 識別子を選択します。

ユーザー権限をエクスポートする

ユーザー権限をエクスポートすると、エクスポートされた情報には、ユーザーがグループやプロジェクトに対して持つ直接的なメンバーシップが表示されます。これには次のデータが含まれます。ただし、最初の100,000人のユーザーに制限されています。

• ユーザー名
• メール
• 種類
• パス
• アクセスレベル（プロジェクトおよびグループ）
• 最後のアクティビティの日付。この列に入力されるアクティビティのリストについては、Users APIのドキュメントを参照してください。

GitLabインスタンスにおけるすべてのアクティブユーザーのユーザー権限をエクスポートするには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > ユーザーを選択します。
3. 右上にあるExport permissions as CSV（ ）を選択します。

ユーザー統計

ユーザー統計ページには、ロールごとのユーザーアカウントの概要が表示されます。この統計は毎日計算されます。最後の更新以降に行われたユーザーの変更は反映されません。以下の合計も含まれます。

• 請求対象ユーザー
• ブロックされたユーザー
• 総ユーザー数

GitLabの請求は、請求対象ユーザーの数に基づいています。

ユーザーにメールアドレスを追加する

メールアドレスをユーザーアカウントに手動で追加するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > ユーザーを選択します。
3. ユーザーを見つけて選択します。
4. 編集を選択します。
5. メールに、新しいメールアドレスを入力します。これにより、新しいメールアドレスがユーザーに追加され、以前のメールアドレスがセカンダリに設定されます。
6. 変更を保存を選択します。

ユーザーコホート

コホートタブには、新しいユーザーの月別のコホートとその経時的なアクティビティが表示されます。

ユーザーがトップレベルグループを作成できないようにする

管理者は、特定のユーザーがトップレベルグループを作成できないようにすることができます。これらのユーザーは、既存の組織構造でサブグループを作成し、コラボレーションできます。

ユーザーがトップレベルグループを作成できないようにするには:

1. 右上隅で、管理者を選択します。
2. 概要 > ユーザーを選択します。
3. ユーザーを見つけて選択します。
4. 編集を選択します。
5. トップレベルグループを作成できるチェックボックスをオフにします。
6. 変更を保存を選択します。

この設定をオフにした後:

• ユーザーはトップレベルグループを作成できません。
• ユーザーは、グループのサブグループ作成権限に応じて、メンテナーまたはオーナーロールを持つグループにサブグループを作成できます。

グループを管理する

GitLabインスタンス内のすべてのグループを管理するには、次の手順に従います。

1. 右上隅で、管理者を選択します。

2. 概要 > グループを選択します。ページには、各グループの以下が表示されます。

   • 名前
   • 説明
   • 表示レベル
   • ロール
   • ステータス
   • ストレージサイズ
   • サブグループ数
   • プロジェクト数
   • メンバー数

3. オプション: タブを選択します。

   • 有効は、すべて有効なグループを表示します。
   • 無効は、削除保留中のグループを表示します。

4. オプション: 並べ替え順を変更するには、並べ替えのドロップダウンリストを選択し、目的の順序を選択します。使用可能な並べ替えオプションは次のとおりです。

   • 名前
   • 作成日
   • 更新日
   • ストレージサイズ

5. オプション: グループを名前でフィルターするには、検索ボックスに3文字以上入力します。

6. オプション: 新しいグループを作成するには、新しいグループを選択します。

グループの編集

管理者エリアのグループページからグループの名前または説明を編集するには、次の手順を実行します。

1. 右上隅で、管理者を選択します。
2. 概要 > グループを選択します。
3. 編集するグループを見つけ、アクション（ ）> 編集を選択します。
4. グループ名またはGroup descriptionを編集します。
5. 変更を保存を選択します。

グループを削除する

グループを削除するには、次の手順を実行します。

1. 右上隅で、管理者を選択します。
2. 概要 > グループを選択します。
3. 編集するグループを見つけ、アクション（ ）> 削除を選択します。
4. 確認ダイアログで、確認を選択します。

トピックを管理する

トピックを使用して、プロジェクトを分類し、類似のプロジェクトを見つけることができます。

すべてのトピックを表示する

GitLabインスタンス内のすべてのトピックを表示するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > トピックを選択します。

このページにはトピックごとに、トピック名と、そのトピックでラベル付けされたプロジェクトの数が表示されます。

トピックを検索する

1. 右上隅で、管理者を選択します。
2. 概要 > トピックを選択します。
3. 検索ボックスに検索条件を入力します。トピック検索では大文字と小文字は区別されず、部分一致が適用されます。

トピックを作成する

トピックを作成するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > トピックを選択します。
3. 新規トピックを選択します。
4. トピックslug（名前）とトピックタイトルを入力します。
5. オプション: 説明を入力し、トピックのアバターを追加します。
6. 変更を保存を選択します。

作成されたトピックが、トピックを見るページに表示されます。

割り当てられたトピックは、そのプロジェクトにアクセスできるユーザーのみに表示されますが、GitLabインスタンスに存在するトピックは誰でも確認できます。トピック名に機密情報を含めないでください。

トピックを編集する

トピックの名前、タイトル、説明、アバターはいつでも編集できます。トピックを編集するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > トピックを選択します。
3. そのトピックの行で編集を選択します。
4. トピックslug（名前）、タイトル、説明、またはアバターを編集します。
5. 変更を保存を選択します。

トピックを削除する

トピックが不要になった場合は、完全に削除できます。トピックを削除するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > トピックを選択します。
3. トピックを削除するには、そのトピックの行で削除を選択します。

トピックをマージする

あるトピックに割り当てられているすべてのプロジェクトを、別のトピックに移動できます。その後、移動元のトピックは完全に削除されます。マージ済みトピックが削除された後、復元することはできません。

トピックをマージするには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > トピックを選択します。
3. マージトピックを選択します。
4. ソーストピックドロップダウンリストから、マージして削除するトピックを選択します。
5. ターゲットトピックドロップダウンリストから、ソーストピックのマージ先となるトピックを選択します。
6. マージを選択します。

Gitalyサーバーを管理する

管理者エリアのGitalyサーバーページから、GitLabインスタンス内のすべてのGitalyサーバーを一覧表示できます。詳細については、Gitalyを参照してください。

Gitalyサーバーページにアクセスするには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > Gitalyサーバーを選択します。

このページには、各Gitalyサーバーに関する次の情報が含まれています。

組織を管理する

管理者エリアの組織ページには、デフォルトですべてのプロジェクトが、最終更新日時の降順に表示されます。各プロジェクトの次の情報が表示されます。

• 名前
• ネームスペース
• 説明
• サイズ（最大15分ごとに更新）

このページからGitLabインスタンス内のすべての組織を管理するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > 組織を選択します。

CI/CDセクション

Runnerを管理する

GitLabインスタンス内のすべてのRunnerを管理するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. CI/CD > Runnersを選択します。

各Runnerの次の情報が表示されます。

各Runnerを編集、一時停止、削除することもできます。

詳細については、GitLab Runnerを参照してください。

Runnerを検索およびフィルタリングする

Runnerの説明を検索するには、次の手順に従います。

1. 結果を検索またはフィルタするテキストボックスに、検索するRunnerの説明を入力します。
2. Enterキーを押します。

ステータス、タイプ、タグでRunnerをフィルタリングするには、次の手順に従います。

1. タブを選択するか、結果を検索またはフィルタするテキストボックスを選択します。
2. タイプを選択するか、状態またはタグでフィルタリングします。
3. 検索条件を選択または入力します。

Runnerを一括削除する

複数のRunnerを同時に削除するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. 概要 > Runnersを選択します。
3. 削除するRunnerの左側にあるチェックボックスをオンにします。ページ上のすべてのRunnerを選択するには、リストの上にあるチェックボックスをオンにします。
4. 一括削除を選択します。

ジョブを管理する

GitLabインスタンス内のすべてのジョブを管理するには、次の手順に従います。

1. 右上隅で、管理者を選択します。
2. CI/CD > ジョブを選択します。すべてのジョブが、ジョブIDの降順で一覧表示されます。
3. すべてのジョブを一覧表示するには、すべてタブを選択します。特定のステータスのジョブのみを一覧表示するには、保留中、実行中、または完了タブを選択します。

各ジョブの次の詳細が表示されます。

モニタリングセクション

次のトピックでは、管理者エリアのモニタリングセクションについて説明します。

システム情報

システム情報ページには、次の統計が表示されます。

これらの統計は、システム情報ページに移動するか、ブラウザでページを更新した場合にのみ更新されます。

バックグラウンドジョブ

バックグラウンドジョブページには、Sidekiqダッシュボードが表示されます。Sidekiqは、GitLabがバックグラウンドプロセスを実行するために使用します。

Sidekiqダッシュボードには、以下の情報が含まれています。

• 各ジョブのライフサイクル状態のタブ。
• バックグラウンドジョブの統計の内訳。
• 処理済みジョブと失敗したジョブのライブグラフ（ポーリングの間隔を選択可能）。
• 処理済みジョブと失敗したジョブの履歴グラフ（時間範囲を選択可能）。
• Redisの統計。以下の情報が含まれています。
  • バージョン番号
  • アップタイム（日単位）
  • 接続数
  • 現在のメモリ使用量（MB単位）
  • ピークメモリ使用量（MB単位）

データ管理

データ管理ページでは、Geoプライマリサイト上のすべてのコンポーネントにわたる検証ステータスを表示および管理するための包括的なインターフェースが提供されます。コンポーネントには、Geoでサポートされているすべてのデータ型が含まれます。

このページを使用して、以下を行います:

• Railsコンソールアクセスを必要とせずに、検証の失敗につながる孤立したファイルまたはデータベースレコードを特定します。
• 詳細なエラー情報を表示し、UIから直接修正措置を講じます。
• すべてのコンポーネントにわたる検証ステータスを追跡し、失敗のパターンを特定します。
• すべてのオブジェクトのチェックサム計算を一度にトリガーします。

リストビューには、選択したコンポーネントの検証ステータスが表示されます。

1. ドロップダウンリストからコンポーネントを選択して、さまざまな検証モデル（プロジェクト、アップロードなど）を切り替えます。リストビューから、次のことができます:

   • チェックサムステータス（失敗、保留中、成功）でオブジェクトをフィルター処理します。
   • 大きな結果セットをナビゲートします。
   • 各オブジェクトの最後のチェックサム時間、最後の失敗時間、および失敗の理由を表示します。
   • 個々のオブジェクトのチェックサム計算をトリガーします。

2. リストビューから個々のモデルを選択して、特定のオブジェクトの検証ステータスに関する包括的な情報を確認します。次に例を示します:

   • 検証されたオブジェクトに関する詳細。
   • 現在のチェックサムステータスと履歴。
   • 検証が失敗した場合の詳細な失敗理由。
   • オブジェクトのチェックサムを再計算するためのオプション。

データベース診断

データベース診断ページは、データベースの一般的な問題を検出するための多数のチェックで構成されています。

• PostgreSQL照合順序の変更によって引き起こされたインデックスの破損
• スキーマの不一致

各チェックを実行するには、チェックの実行ボタンを選択します。実行ボタンを選択すると、チェックからの情報をページにレポートするバックグラウンドジョブがスケジュールされます。

照合ヘルスチェック

照合ヘルスチェックは、破損したインデックスを引き起こすPostgreSQLの問題を検出します。これは通常、PostgreSQLを実行している以前のオペレーティングシステムが、glibcバージョン2.28より以前のバージョンを使用している場合に発生します。詳細については、PostgreSQLのオペレーティングシステムのアップグレードに関するドキュメントを参照してください。

問題はCorrupted Indexesセクションにリストされています。問題がある場合は、破損したインデックスを修復できます。

照合ヘルスチェックは、一般的に影響を受けるテーブルの重複を検出します。

• ci_refs
• ci_resource_groups
• environments
• merge_request_diff_commit_users
• sbom_components
• tags
• topics

詳細については、イシュー505982を参照してください。

ダッシュボードには、gitlab:db:collation_checker Rakeタスクに表示される同一の情報がリストされます。

スキーマヘルスチェック

スキーマヘルスチェックは、データベースの状態をターゲットスキーマと比較し、検出された不一致をリストします。自動スキーマ修復ツールは利用できません。

誤検出に気付いた場合、またはチェックの結果について質問がある場合は、フィードバックイシューを参照してください。

ログ

以下のログファイルの内容は、問題を解決するために役立ちます。各ログファイルの内容は、時系列順に表示されます。パフォーマンスの問題を最小限に抑えるため、各ログファイルの最大2,000行が表示されます。

これらのログファイルとその内容の詳細については、ログシステムを参照してください。

マルチノードシステムの管理者の混乱を防ぐため、管理者エリアのダッシュボードからログビューが削除されました。このビューには、マルチノードセットアップの部分的な情報しか表示されません。マルチノードシステムの場合は、ElasticsearchやSplunkなどのサービスにログをインジェストしてください。

監査イベント

監査イベントページには、GitLabサーバーに加えられた変更が一覧表示されます。この情報を使用して、すべての変更を制御、分析、追跡できます。

統計

ダッシュボードのインスタンスの概要セクションには、GitLabインスタンスの現在の統計が一覧表示されます。アプリケーション統計APIを使用して、この情報を取得します。

これらの統計は、10,000未満の値については正確な数を示しています。値が10,000以上の場合は、TablesampleCountStrategyおよびReltuplesCountStrategyの戦略に基づいて計算され、おおよそのデータを示しています。