GitLab管理エリア
管理エリアは、GitLabセルフマネージドインスタンスのいくつかの機能を管理するためのウェブUIを提供します。
管理者エリアにアクセスするには
- 管理エリアアイコン({admin})をクリックします。
- セルフマネージドインスタンスの
/admin
にアクセスしてください。
管理エリアセクション
管理エリアは以下のセクションで構成されています:
セクション | 説明 |
---|---|
概要 概要 | GitLabダッシュボードを表示し、プロジェクト、ユーザー、グループ、ジョブ、Runner、Gitalyサーバーを管理します。 |
{モニター}モニタリング | GitLabシステム情報、バックグラウンドジョブ、ログ、ヘルスチェック、リクエストプロファイル、監査ログに関する情報を表示します。 |
{メッセージ}メッセージ | ユーザーのためにブロードキャストメッセージを送信し、管理します。 |
{フック}システムフック | 多くのイベントに対してシステムフックを設定します。 |
{アプリケーション | 他のサービスとのインテグレーション用のシステムOAuthアプリケーションを作成します。 |
{いたずらレポーター | ユーザーから提出された不正使用のレポーターを管理します。 |
{ライセンス}ライセンス | ライセンスのアップロード、表示、削除。 |
{クラウドギア}Kubernetes | インスタンスレベルのKubernetesクラスタの作成と管理。 |
プッシュルール | あらかじめ定義された Gitプッシュルールをプロジェクトに対して設定します。 また、マージリクエストの承認者ルールも設定します。 |
{ロケーション・ドット}Geo | Geoノードの設定とメンテナー。 |
{キー}デプロイキー | インスタンス全体のSSHデプロイキーを作成します。 |
{ロック}認証情報 | インスタンスへのアクセスに使用できる認証情報を表示します。 |
{テンプレート}サービステンプレート | プロジェクト用のサービステンプレートを作成します。 |
{ラベル}ラベル | GitLabインスタンスのラベルを作成し、メンテナーします。 |
{外観}外観 | GitLabの外観をカスタマイズします。 |
{設定}設定 | GitLabインスタンスの設定を変更します。 |
管理者ダッシュボード
ダッシュボードは GitLab インスタンスに関する統計やシステム情報を提供します。
ダッシュボードにアクセスするには
- 管理エリアアイコン({admin})をクリックします。
- セルフマネージドインスタンスの
/admin
にアクセスしてください。
ダッシュボードは管理エリアのデフォルトビューで、以下のセクションで構成されています:
セクション | 説明 |
---|---|
プロジェクト | プロジェクトの総数、最新プロジェクトの最大10件、新規プロジェクトの作成オプション。 |
ユーザー | 総ユーザー数、最新ユーザー数(最大10人)、新規ユーザー作成オプション、以下のリンクがあります。 ユーザー統計. |
グループ | グループの総数、最新のグループの最大10、および新しいグループを作成するオプション。 |
統計 | GitLabインスタンスの全要素の合計。 |
特徴 | GitLabインスタンスで利用可能なすべての機能。 有効な機能は緑色の丸いアイコンで、無効な機能は電源アイコンで表示されます。 |
コンポーネント | GitLabの主なコンポーネントとそれぞれのバージョン番号。 Gitalyサーバーへのリンクも含まれています。 |
概要
以下のトピックでは、管理エリアの{ 概要 }セクションについて説明します。
プロジェクトの管理
GitLab インスタンスのすべてのプロジェクトは、管理エリアの Projects ページから管理することができます。
プロジェクトページにアクセスするには、 Admin Area > Overview > Projectsに進みます。
すべて」、「非公開」、「内部」、「公開」タブをクリックすると、その条件のプロジェクトだけがリストアップされます。
デフォルトでは、すべてのプロジェクトが最終更新日の逆順で表示されます。 各プロジェクトについて、以下の情報が表示されます:
- 名前
- 名前空間。
- 説明
- 最大15分ごとに更新されるサイズ。
プロジェクトの編集や削除が可能です。
プロジェクトのリストは、以下の方法で並べ替えることができます:
- 名前
- 最終作成日
- 最も古く作られました。
- 最終更新日
- 最古の更新。
- オーナーです。
ユーザーは、アーカイブされたプロジェクトをリストに表示するかどうかを選択できます。
Filter by nameフィールドに探したいプロジェクト名を入力すると、GitLabが入力した通りにフィルタリングします。
Namespaceドロップダウンから選択すると、そのネームスペースのプロジェクトのみをフィルタリングできます。
例えば、プロジェクト名にscore
が含まれる公開プロジェクトのみをリストアップするように、フィルターオプションを組み合わせることができます:
- 公開」タブをクリックします。
-
Filter by name…」入力ボックスに「
score
」と入力します。
ユーザーの管理
GitLab インスタンスの全ユーザーを、管理エリアの Users ページから管理することができます。
ユーザ] ページにアクセスするには、 [管理エリア] > {概要}[ユーザ] に進みます。
特定の条件に一致するユーザを一覧表示するには、[ユーザ]ページの以下のタブのいずれかをクリックします:
各ユーザーのユーザー名、メールアドレス、アカウント作成日、最終アクティビティ日が表示されます。 ユーザーを編集するには、そのユーザーの行の編集ボタンをクリックします。 ユーザーを削除、またはユーザーと貢献者を削除するには、そのユーザーの行のコグドロップダウンをクリックし、必要なオプションを選択します。
ソート順を変更するには
- ソートのドロップダウンをクリックします。
- ご希望の順序を選択してください。
デフォルトでは、ソートのドロップダウンには「名前」が表示されます。
ユーザーを検索するには、検索フィールドに条件を入力してください。 ユーザー検索では、大文字と小文字が区別されず、名前とユーザー名の部分一致が適用されます。 メールアドレスを検索するには、完全なメールアドレスを入力する必要があります。
ユーザー統計
ユーザ統計ページでは、最高ロールの_メンテナーを_持つユーザなど、ロール別のユーザアカウントの概要を見ることができます。
以下の合計も含まれています:
- アクティブユーザー
- ブロックされたユーザー
- 総ユーザー数
GitLabの課金は、総ユーザー数 -ブロックされたユーザー数で計算されるアクティブユーザー数に基づいています。 アクティブユーザーの詳細については、ユーザー数の選択を参照してください。
グループの管理
GitLab インスタンスのすべてのグループは、管理エリアの Groups ページから管理できます。
グループページにアクセスするには、 Admin Area > Overview > Groupsに進みます。
各グループについて、名前、説明、サイズ、グループ内のプロジェクト数、メンバー数、非公開、内部、公開の別が表示されます。 グループを編集するには、グループの行にある「編集」ボタンをクリックします。 グループを削除するには、グループの行にある「削除」ボタンをクリックします。
並べ替え順を変更するには、並べ替えドロップダウンをクリックし、希望の並べ替え順を選択します。 デフォルトの並べ替え順は「作成日順」です。
グループ名でグループを検索するには、検索フィールドに条件を入力します。 グループ検索では、大文字と小文字が区別されず、部分一致が適用されます。
新規グループを作成するには、「新規グループ」をクリックします。
ジョブの管理
GitLab インスタンスのすべてのジョブは、管理エリアのジョブページから管理することができます。
ジョブページにアクセスするには、 Admin Area > Overview > Jobsにアクセスしてください。
すべてのジョブがジョブIDの降順で表示されます。
すべてのジョブを一覧表示するには、[All]タブをクリックします。 そのステータスのジョブのみを一覧表示するには、[Pending]、[Running]、または [Finished] タブをクリックします。
各ジョブについて、以下の詳細が記載されています:
項目 | 説明 |
---|---|
ステータス | 合格、スキップ、失敗のいずれかのジョブステータス。 |
ジョブ | ジョブ、ブランチ、ジョブを開始したコミットへのリンクが含まれます。 |
パイプライン | 特定のパイプラインへのリンク。 |
プロジェクト | ジョブが所属するプロジェクト名と組織名。 |
Runner | ジョブの実行に割り当てられた CI runner の名前。 |
ステージ |
.gitlab-ci.yml ファイルでジョブが宣言されているステージ。
|
名称 |
.gitlab-ci.yml ファイルで指定されたジョブの名前。
|
タイミング | ジョブの期間、ジョブが完了した時間。 |
適用範囲 | テストカバレッジの割合。 |
ランナーの管理
GitLab インスタンスのすべての Runner を管理するには、管理エリアのRunnersページから行います。 Runner 自体の詳細についてはGitLab Runnerを参照してください。
Runnersページにアクセスするには、 管理エリア > {概要} 概要 > Runnersに進みます。
Runnerのページには特徴があります:
- Runnerとその状態について。
- Runnerのインストール方法。
- 登録ランナーのリスト。
デフォルトでは、ランナーは作成された日付の降順で表示されます。 検索フィールドの横にあるドロップダウンから、ソート順を「最後に連絡のあった順」に変更することができます。
Runnerの説明を検索するには:
- 結果の検索またはフィルタ…フィールドに、検索したいランナーの説明を入力します。
- Enterを押してください。
ステータス、タイプ、タグでランナーをフィルタリングすることもできます。 フィルタリングするには:
- 検索またはフィルタ結果…フィールドをクリックします。
- status:、type:、tag:を選択します。
- 検索条件を選択または入力してください。
各ランナーについて、以下の属性が記載されています:
属性 | 説明 |
---|---|
タイプ | 共有、グループ、特定、ロック、一時停止のうち1つ以上の状態 |
ランナートークン | Runner を識別するために使用され、Runner が GitLab インスタンスと通信するために使用するトークン。 |
説明 | ランナー作成時の説明 |
バージョン | GitLab Runnerバージョン |
IPアドレス | ランナーが登録されているホストのIPアドレス |
プロジェクト | Runnerが担当するプロジェクト |
ジョブ | Runnerが実行したジョブの総数 |
タグ | ランナー」関連タグ |
最後のコンタクト | GitLab インスタンスが最後に Runner にコンタクトした日時を示すタイムスタンプ。 |
それぞれのRunnerを編集、一時停止、削除することもできます。
Gitalyサーバーの管理
管理エリアのGitalyServersページから、GitLabインスタンス内のすべてのGitalyサーバーを一覧できます。 詳細はGitalyをご覧ください。
Gitaly Serversページにアクセスするには、 Admin Area > Overview >Gitaly Serversにアクセスしてください。
各Gitalyサーバーについて、以下の詳細が記載されています:
項目 | 説明 |
---|---|
ストレージ | リポジトリのストレージ |
住所 | Gitalyサーバーがリッスンしているネットワークアドレス |
サーバーバージョン | Gitalyバージョン |
gitバージョン | Gitalyサーバーにインストールされているgitのバージョン |
最新情報 | Gitalyサーバーのバージョンが最新かどうかを示します。 緑の点はサーバーが最新であることを示します。 |
モニタリング部門
以下のトピックでは、管理エリアの 監視セクションについて説明します。
システム情報
システム情報」ページには、以下の統計情報が表示されます:
項目 | 説明 |
---|---|
中央演算処理装置 | 使用可能なCPUコア数 |
メモリ使用量 | 使用中のメモリと使用可能なメモリの合計 |
ディスク使用量 | 使用中のディスク容量と使用可能なディスク容量の合計 |
アップタイム | GitLabインスタンスのおおよその稼働時間 |
これらの統計ページは、システム情報ページに移動したとき、またはブラウザでページを更新したときにのみ更新されます。
バックグラウンド・ジョブ
Background JobsページにはSidekiqダッシュボードが表示されます。 SidekiqはGitLabがバックグラウンドで処理を実行するために使用します。
Sidekiqダッシュボードは以下の要素で構成されています:
- ジョブのステータスごとのタブ。
- バックグラウンドのジョブ統計の内訳。
- 処理済みジョブおよび失敗したジョブのライブグラフで、ポーリング間隔を選択できます。
- 処理済みジョブおよび失敗したジョブの履歴グラフ。
- Redisの統計情報:
- バージョン番号
- 稼働時間(日単位
- 接続数
- 現在のメモリ使用量(単位:MB
- ピークメモリ使用量(単位:MB
過去ログ
Pagesページでは、以下のログファイルにアクセスできます:
ログファイル | 内容 |
---|---|
application.log
| GitLabユーザーのアクティビティ |
git_json.log
| GitLab と Git リポジトリとのインタラクションの失敗 |
production.log
| Unicornから受け取ったリクエストと、そのリクエストに対応するために取ったアクション |
sidekiq.log
| バックグラウンド・ジョブ |
repocheck.log
| リポジトリアクティビティ |
integrations_json.log
| GitLabとインテグレーションシステム間のアクティビティ |
kubernetes.log
| Kubernetesアクティビティ |
これらのログファイルの内容は、問題のトラブルシューティングの際に役立ちます。 GitLabの管理者は、ログファイルに直接アクセスすることなく、アクセスすることができます。
これらのログファイルとその内容の詳細については、ログシステムを参照してください。
各ログファイルの内容は、時系列順に表示されます。 パフォーマンスのイシューを最小限に抑えるため、各ログファイルの最大2000行が表示されます。
リクエスト プロフィール
Requests Profilesページには、プロファイリングに必要なトークンが含まれています。 詳細は、Request Profilingを参照してください。
監査ログ
Audit Logページは GitLab サーバー内で行われた変更を一覧表示します。 この情報を使って、すべての変更を管理、分析、追跡することができます。