GitLab管理エリア

管理者エリアは、GitLabセルフマネージドインスタンスの機能を管理・設定するためのウェブUIを提供します。管理者であれば、Admin Areaにアクセスすることができます：

  • GitLab 16.1以降では、左サイドバーで[Search]または[go to]を選択し、[Admin Area]を選択します。
  • GitLab 16.0以前の場合：トップバーで、メインメニュー > 管理を選択します。
note
管理者だけが管理エリアにアクセスできます。

プロジェクトの管理

GitLab インスタンスのすべてのプロジェクトは、管理エリアの Projects ページから管理することができます。

Projects ページにアクセスするには：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > プロジェクトを選択します。
  4. すべて」、「非公開」、「内部」、または「公開」タブを選択して、その条件のプロジェクトのみをリストアップします。

デフォルトでは、すべてのプロジェクトが最終更新日の逆順で表示されます。各プロジェクトについて、以下の情報が表示されます：

  • 名前
  • 名前空間
  • 説明
  • サイズ、最大15分ごとに更新

プロジェクトの編集・削除が可能です。

プロジェクト名や説明を編集するには

  1. プロジェクトの概要で、編集したいプロジェクトの横にある「編集」を選択します。
  2. プロジェクト名またはプロジェクトの説明を編集します。
  3. 変更を保存を選択します。

プロジェクトを削除するには

  1. プロジェクトの概要で、削除したいプロジェクトの横にある「削除」を選択します。

プロジェクトのリストは、以下の方法で並べ替えることができます：

  • 更新日
  • 最終作成日
  • 名前
  • 最多スター数
  • 最も古い星
  • 更新日時
  • 最大のリポジトリ

ユーザーは、アーカイブされたプロジェクトをリストに表示するかどうかを選択できます。

Filter by nameフィールドに探したいプロジェクト名を入力すると、GitLab は入力したプロジェクト名をフィルタリングします。

その名前空間のプロジェクトだけをフィルタするには、Namespaceドロップダウンリストから選択します。

フィルタオプションを組み合わせることもできます。たとえば、名前にscore が含まれる公開プロジェクトのみをリストアップする場合などです：

  1. 公開タブを選択します。
  2. Filter by name… 入力ボックスにscore と入力します。

ユーザーの管理

GitLab インスタンスのすべてのユーザーを管理するには、管理エリアの Users ページから行います：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > ユーザーを選択します。

特定の条件に一致するユーザーを一覧表示するには、[ユーザー]ページの以下のタブのいずれかを選択します：

  • アクティブ
  • 管理者
  • 2FA有効
  • 2FA無効
  • 外部
  • ブロック
  • 無効
  • プロジェクトなし

各ユーザーについて、以下が表示されます：

  1. ユーザー名
  2. アドレス
  3. プロジェクト会員数
  4. グループメンバーシップ数(GitLab 13.12 で導入)
  5. アカウント作成日
  6. 最終アクティビティ日付

ユーザーを編集するには、そのユーザーの行で「編集」を選択します。ユーザーを削除、またはユーザーとその貢献者を削除するには、そのユーザーの行のコグドロップダウンリストを選択し、必要なオプションを選択します。

ソート順を変更するには

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

デフォルトでは、並べ替えドロップダウンリストには「名前」が表示されます。

ユーザーを検索するには、検索フィールドに条件を入力してください。ユーザー検索では大文字と小文字が区別されず、名前とユーザー名の部分一致が適用されます。メールアドレスを検索するには、完全なメールアドレスを入力する必要があります。

ユーザーのなりすまし

管理者は、他の管理者を含む他のユーザーに「なりすます」ことができます。これにより、管理者は「ユーザーが見ているものを見る」ことができ、ユーザーに代わってアクションを起こすことができます。以下の方法でユーザーになりすますことができます：

  • UIを通して：
    1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
    2. Admin Areaを選択します。
    3. 左側のサイドバーで、[概要] > [ユーザー]を選択します。
    4. ユーザーのリストから、ユーザーを選択します。
    5. Impersonateを選択します。
  • APIで、インパーソネーショントークンを使用します。

すべてのなりすましアクティビティは監査イベントでキャプチャされます。

デフォルトでは、なりすましは有効になっています。GitLabはなりすましを無効に設定することができます。

user impersonation button

ユーザーID

ユーザーの SCIM アイデンティティを見る機能は GitLab 15.3 で導入されました。

認証プロバイダを使う場合、管理者はユーザーのアイデンティティを見ることができます：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > ユーザーを選択します。
  4. ユーザーのリストから、ユーザーを選択します。
  5. アイデンティティを選択します。

このリストには、SCIM IDを含むユーザーのIDが表示されます。管理者はこの情報を使用して、SCIM 関連の問題のトラブルシューティングを行ったり、アカウントに使用されている ID を確認したりできます。

ユーザー権限のエクスポート

管理者は管理エリアのユーザーページから、GitLabインスタンスの全ユーザーの権限をエクスポートすることができます。エクスポートは、ユーザーがグループやプロジェクトで直接メンバーシップを持っていることを一覧表示します。

以下のデータがエクスポートに含まれます：

最初の10万件のユーザーアカウントのみがエクスポートされます。

user permission export button

ユーザー統計

ユーザ統計ページでは、ロール別のユーザアカウントの概要を見ることができます。これらの統計は毎日計算されるため、最終更新日以降のユーザー変更は反映されません。

以下の合計も含まれます：

  • 請求可能ユーザー
  • ブロックユーザー
  • 合計ユーザー数

GitLabの課金は以下のユーザー数に基づいて行われます。 請求可能ユーザー数.

ユーザーにEメールを追加

ユーザーに手動でメールを追加するには、管理者である必要があります：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > ユーザーを選択します。
  4. ユーザーを探し、選択します。
  5. 編集]を選択します。
  6. Emailに新しいメールアドレスを入力します。これで新しいメールアドレスがユーザーに追加され、以前のメールアドレスはセカンダリに設定されます。
  7. 変更を保存を選択します。

ユーザーコホート

コホ[ート]](user_cohorts.md)タブには、新規ユーザーの月別コホートとそのアクティビティが表示されます。

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

デフォルトでは、ユーザーはグループを作成できます。ユーザーがトップレベルのグループを作成できないようにするには、以下の手順に従います：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > ユーザーを選択します。
  4. ユーザーを探し、選択します。
  5. 編集]を選択します。
  6. グループを作成できる］チェックボックスをオフにします。
  7. 変更を保存を選択します。

グループ内でサブグループを作成できるロールを制限することも可能です。

グループの管理

GitLab インスタンスのすべてのグループは、管理エリアの Groups ページから管理することができます。

Groups ページにアクセスするには：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > グループを選択します。

各グループについて、名前、説明、サイズ、グループ内のプロジェクト数、メンバー数、非公開、内部、公開の別が表示されます。グループを編集するには、グループの行で［編集］を選択します。グループを削除するには、グループの行で削除を選択します。

並べ替えの順序を変更するには、並べ替えドロップダウンリストを選択し、希望の順序を選択します。デフォルトのソート順は「作成日順」です。

グループ名でグループを検索するには、検索フィールドに条件を入力します。グループ検索では大文字と小文字が区別されず、部分一致が適用されます。

新しいグループを作成するには、［新しいグループ］を選択します。

トピックの管理

トピックは似たようなプロジェクトを分類して見つけるために使われます。

すべてのトピックを表示

GitLab インスタンスのすべてのトピックを表示します：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要] > [トピック] を選択します。

トピックごとに、そのトピックの名前と、そのトピックのラベルが付いたプロジェクトの数が表示されます。

トピックの検索

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要] > [トピック] を選択します。
  4. 検索ボックスに検索条件を入力します。トピックの検索では、大文字と小文字は区別されず、部分一致が適用されます。

トピックの作成

トピックを作成するには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要] > [トピック] を選択します。
  4. 新しいトピック] を選択します。
  5. トピックのスラッグ (名前)とトピックのタイトルを入力します。
  6. オプション。説明] を入力し、トピックのアバターを追加します。
  7. 変更を保存を選択します。

作成された Pages が [トピックの探索] ページに表示されます。

note
割り当てられたトピックはプロジェクトにアクセスできる人だけが見ることができますが、GitLabインスタンスに存在するトピックは誰でも見ることができます。トピックの名前に機密情報を含めないでください。

トピックの編集

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

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要] > [トピック] を選択します。
  4. トピックの行で [編集] を選択します。
  5. トピックのスラッグ（名前）、タイトル、説明、またはアバターを編集します。
  6. 変更を保存を選択します。

トピックの削除

トピックが不要になった場合は、そのトピックを永久的に削除できます。トピックを削除するには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要] > [トピック] を選択します。
  4. トピックを削除するには、そのトピックの行で [削除] を選択します。

トピックのマージ

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

トピックをマージするには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要] > [トピック] を選択します。
  4. トピックのマージ] を選択します。
  5. ソース トピックドロップダウン リストから、マージして削除するトピックを選択します。
  6. ターゲット トピックドロップダウン リストから、ソース トピックにマージするトピックを選択しま す。
  7. マージ] を選択します。

Gitalyサーバーの管理

管理エリアのGitaly Serversページから、GitLabインスタンス内のすべてのGitalyサーバーを一覧できます。詳しくはGitalyをご覧ください。

Gitaly Serversページにアクセスするには：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > Gitalyサーバー]を選択します。

各 Gitaly サーバーについて、以下の詳細が表示されます：

項目説明
ストレージリポジトリのストレージ
アドレスGitalyサーバーがリッスンしているネットワークアドレス
サーバーのバージョンGitalyバージョン
GitバージョンGitalyサーバーにインストールされているGitのバージョン。
最新情報Gitalyサーバーのバージョンが最新かどうかを示します。緑の点は、サーバーが最新であることを示します。

CI/CDセクション

ランナーの管理

GitLab 15.8で概要 > ランナーから CI/CD > ランナーに移動しました。

GitLab インスタンスのすべてのランナーは、管理エリアのランナーページから管理できます。詳しくはGitLab Runnerをご覧ください。

Runnersページにアクセスするには：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > ランナーを選択します。

ランナーの検索と絞り込み

ランナーの説明を検索します：

  1. 結果の検索またはフィルタ…フィールドに、検索したいランナーの説明を入力します。
  2. Enterを押します。

ランナーをステータス、タイプ、タグでフィルタリングすることもできます。フィルタするには

  1. タブを選択するか、「結果を検索またはフィルタ…」フィールドを選択します。
  2. 任意のタイプを選択するか、ステータスまたはタグでフィルタリングします。
  3. 検索条件を選択または入力してください。

Attributes of a runner, with the **Search or filter results...** field active

ランナーの一括削除

複数のランナーを同時に削除することができます。

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 概要 > ランナーを選択します。
  4. 削除したいランナーの左側にあるチェックボックスを選択します。ページ上のすべてのランナーを選択するには、リストの上にあるチェックボックスを選択します。
  5. 選択したランナーを削除を選択します。

ランナー属性

各ランナーについて、以下の属性が表示されます：

属性説明
ステータスランナーのステータス。GitLab 15.1以降の Ultimate階層では、アップグレードステータスが利用できます。
ランナーの詳細パーシャルトークンやランナーが登録されたコンピュータの詳細など、ランナーに関する情報。
バージョンGitLab Runnerのバージョンです。
ジョブRunnerが実行したジョブの総数。
タグランナーに関連するタグ。
最後のコンタクトRunner が最後に GitLab インスタンスにコンタクトした日時を示すタイムスタンプ。

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

ジョブの管理

GitLab 15.8で概要 > ジョブから CI/CD > ジョブに移動しました。

GitLab インスタンスのすべてのジョブを管理エリアのジョブページから管理することができます。

ジョブページにアクセスするには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. CI/CD > ジョブを選択します。ジョブIDの降順ですべてのジョブが表示されます。
  4. すべてのジョブを一覧表示するにはAllタブを選択します。Pending、Running、Finishedタブを選択すると、そのステータスのジョブのみがリストアップされます。

各ジョブについて、以下の詳細が表示されます：

項目説明
ステータス 合格、スキップ、失敗のいずれかのジョブステータス。
ジョブジョブ、ブランチ、ジョブを開始したコミットへのリンクを含みます。
パイプライン特定のパイプラインへのリンクを含みます。
プロジェクトジョブが所属するプロジェクト名と組織名。
Runnerジョブの実行に割り当てられた CI Runner の名前。
ステージジョブが.gitlab-ci.yml ファイルで宣言されているステージ。
名前 .gitlab-ci.yml ファイルで指定されたジョブの名前。
タイミングジョブの期間と、ジョブが完了した時間。
カバレッジテストカバレッジの割合。

モニタリングセクション

以下のトピックでは、管理エリアの監視セクションについて説明します。

システム情報

GitLab 15.2で導入された相対時間のサポート。”Uptime “統計は “System started “に名称変更。

システム情報(System Info)ページは以下の統計情報を提供します：

項目説明
CPU使用可能なCPUコア数
メモリ使用量使用中のメモリと使用可能なメモリの合計
ディスク使用状況使用中のディスク容量と使用可能なディスク容量の合計
システム起動GitLabをホストしているシステムがいつ起動したか。GitLab 15.1以前では、これは稼働時間の統計でした。

これらの統計は、System Infoページに移動した時か、ブラウザでページを更新した時のみ更新されます。

バックグラウンド・ジョブ

Background JobsページはSidekiqダッシュボードを表示します。SidekiqはGitLabがバックグラウンドで処理を行うために使用します。

Sidekiqダッシュボードは以下の要素で構成されています：

  • ジョブのステータスごとのタブ。
  • バックグラウンドジョブの統計の内訳。
  • 処理済みジョブおよび失敗したジョブのライブグラフ。
  • 処理済みジョブおよび失敗したジョブの履歴グラフ。
  • Redisの統計情報：
    • バージョン番号
    • 稼働時間（日単位
    • 接続数
    • 現在のメモリ使用量（単位：MB
    • ピークメモリ使用量（単位：MB

ログ

GitLab 13.0以降、ログ表示は管理者エリアのダッシュボードから削除されました。なぜなら、ログ表示は複数ノードのセットアップでは機能せず、部分的な情報を表示することで管理者を混乱させる可能性があるからです。

マルチノードシステムでは、ElasticsearchやSplunkのようなサービスにログを取り込むことをお勧めします。

ログファイル目次
application_json.logGitLabユーザーのアクティビティ
git_json.logGitLab と Git リポジトリとのインタラクションの失敗
production.logPumaから受け取ったリクエストと、そのリクエストに対応するためのアクション
sidekiq.logバックグラウンドジョブ
repocheck.logリポジトリアクティビティ
integrations_json.logGitLabとインテグレーションシステム間のアクティビティ
kubernetes.logKubernetesアクティビティ

これらのログファイルの内容は、問題のトラブルシューティング時に役立ちます。

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

各ログファイルの内容は、時系列順に表示されます。パフォーマンスのイシューを最小限に抑えるため、各ログファイルは最大2000行まで表示されます。

監査イベント

Audit EventsページはGitLabサーバー内で行われた変更を一覧表示します。この情報を使って、全ての変更を管理、分析、追跡することができます。