Skip to main content

サイトアドミンのダッシュボード

サイト管理ダッシュボードを使って、GitHub Enterprise Server内で直接Enterpriseのユーザ、Organization、リポジトリを管理できます。

ダッシュボードにアクセスするには、任意のページの右上隅にある をクリックします。 サイト管理者設定にアクセスするための宇宙船のアイコン

ユーザーとリポジトリの検索、および監査ログのクエリを実行するには、サイト管理者ダッシュボードのこのセクションを参照してください。

[Management Console]

ここで、ドメインや認証、SSL などの仮想アプライアンスの設定を管理するための [Management Console]を起動することができます。

探索

GitHub のトレンド ページのデータは、リポジトリと開発者の両方において、日単位、週単位、月単位の期間で計算されます。 [探索] セクションで、このデータが最後にいつキャッシュされたのかの確認や、新しいトレンドの計算ジョブをキューに入れることができます。

監査ログ

GitHub Enterprise Server では、クエリで確認できる、監査されたアクションの実行ログが保持されます。

デフォルトでは、Audit log は、監査されたアクション全てを新しい順で表示します。 このリストをフィルター処理するには、「エンタープライズの監査ログの検索」で説明されているように、 [クエリ] テキスト ボックスにキーと値のペアを入力し、[検索] をクリックします。

一般的な監査ログの詳細については、「エンタープライズの監査ログについて」を参照してください。 監査されたアクションの完全なリストについては、「エンタープライズの監査ログ イベント」を参照してください。

Reports

your GitHub Enterprise Server instance にある、ユーザー、組織、リポジトリの情報が必要な場合、一般的には、GitHub API を使って、JSON データをフェッチします。 残念ながら、API は、必要なデータを提供しない可能性があり、使用するのには専門知識が必要です。 サイト管理者ダッシュボードには代替手段として [レポート] セクションが設けられ、ユーザー、組織、リポジトリに必要と思われるほぼすべての情報を含んだ CSV レポートを簡単にダウンロードできます。

具体的には、次の情報を含む CSV 報告をダウンロードできます。

  • 全ユーザ
  • すべてのアクティブなユーザー
  • すべての休眠ユーザー
  • 停止されている全ユーザ
  • 全ての Organization
  • 全ての リポジトリ

サイトアドミンのアカウントを用いて標準の HTTP 認証を使用すれば、これらのレポートにプログラムでアクセスすることもできます。 site_admin スコープで個人用アクセス トークンを使用する必要があります。 詳細については、個人アクセス トークンの作成に関する記事を参照してください。

たとえば、cURL を使用して "all users" レポートをダウンロードする方法は次のとおりです:

curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv

プログラムで他のレポートにアクセスするには、all_usersactive_usersdormant_userssuspended_usersall_organizations、または all_repositories に置き換えます。

注: キャッシュされたレポートがない場合、最初の curl 要求では 202 HTTP 応答が返され、レポートはバックグラウンドで生成されます。 もう一度リクエストを送れば、その報告をダウンロードすることができます。 パスワードを使用するか、パスワードの代わりに、site_admin スコープと併せて OAuth トークンを使用することができます。

ユーザ報告

Key説明
created_atユーザアカウントの作成時間(ISO 8601 のタイムスタンプ)
idユーザまたはOrganization のアカウント ID
loginアカウントのログイン名
emailアカウントのプライマリメールアドレス
roleアカウントがアドミンか一般ユーザか
suspended?アカウントが停止されているか
last_logged_ip最後にアカウントにログインしたときの IP アドレス
reposアカウントが所有しているリポジトリの数
ssh_keysアカウントに登録されているSSHキーの数
org_membershipsアカウントが所属している Organization の数
dormant?アカウントが休眠であるかどうか
last_activeアカウントが最後にアクティブだったとき(ISO 8601 のタイムスタンプ)
raw_login(JSON フォーマットでの)未処理のログイン情報
2fa_enabled?ユーザが二段階認証を有効にしているかどうか

Organization の報告

Key説明
id組織 ID
created_atOrganization の作成時間
loginOrganization のログイン名
emailOrganization のプライマリメールアドレス
ownersOrganizationのオーナーの数
membersOrganization のメンバーの数
teamsOrganization のチームの数
reposOrganization のリポジトリの数
2fa_required?Organization が二段階認証を有効にしているかどうか

リポジトリ の報告

Key説明
created_atリポジトリの作成時間
owner_idリポジトリのコードオーナーの ID
owner_typeリポジトリの所有者がユーザか Organization か
owner_nameリポジトリの所有者の名前
idリポジトリの ID
nameリポジトリ名です
visibilityリポジトリが公開かプライベートか
readable_size人間が読める形式のリポジトリのサイズ
raw_size数字でのリポジトリのサイズ
collaboratorsリポジトリのコラボレータの数
fork?リポジトリがフォークであるかどうか
deleted?リポジトリが削除されているかどうか

インデックス作成

GitHub の検索機能には、Elasticsearch が搭載されています。 サイトアドミンのダッシュボードのこのセクションには、Elasticsearch クラスターの現在の状態が表示され、検索とインデックス作成の動作を制御するためにツールがいくつか用意されています。

コード検索の詳細については、「GitHub での情報の検索」を参照してください。 Elasticsearch の詳細については、Elasticsearch の Web サイトをご覧ください。

: 通常の使用では、サイト管理者は新しいインデックスを作成したり、修復ジョブをスケジュールしたりする必要はありません。 トラブルシューティングやその他のサポート目的で、GitHub Support から修復ジョブの実行を指示される場合があります。

インデックスの管理

GitHub Enterprise Server では、検索インデックスの状態をインスタンス上のデータと自動的かつ定期的に照合して調整します。

  • データベース内の問題、プル要求、リポジトリ、およびユーザー
  • ディスク上の Git リポジトリ (ソース コード)

ご利用のインスタンスでは修復ジョブを使用してデータを調整し、次のイベントが発生した場合にバックグラウンドで修復ジョブをスケジュールします。

  • 新規検索インデックスが作成される。
  • 欠損データを埋め戻ししなければいけない場合。
  • 古い検索データを更新しなければいけない場合。

新しいインデックスを作成することも、リスト内の既存のインデックスをクリックしてインデックスを管理することもできます。 インデックスに対して次の操作を実行できます。

  • インデックスを検索可能にする。
  • インデックスを書き込み可能にする。
  • インデックスを更新する。
  • インデックスを削除する
  • インデックスの修復状態をリセットする。
  • 新規インデックス修理ジョブを開始する。
  • インデックスの修理ジョブを有効または無効にする。

プログレス バーには、背景 worker にまたがる修理ジョブの現在の状態が表示されます。 このバーは、データベースの中の最高レコード ID と修理オフセットでのパーセント差を示します。 修復ジョブが完了したら、プログレス バーに表示される値は無視できます。 プログレス バーには、修復オフセットとデータベース内の最大レコード ID の差が示されます。その値は、たとえリポジトリが実際にインデックス付けされていても、your GitHub Enterprise Server instance にリポジトリが追加されるにつれて減少します。

I/O パフォーマンスに与える影響を最小限にするため、および、オペレーションがタイムアウトする可能性を低く抑えるために、混雑していない時間帯に修理ジョブを実行してください。 ジョブによって検索インデックスをデータベースおよび Git リポジトリ データと照合して調整する場合、使用される CPU は 1 つです。 top のようなユーティリティを使用して、システムの負荷平均と CPU 使用率を監視します。 リソース消費の大幅な増加が示されていない場合は、ピーク時間帯にインデックス修復ジョブを実行しても問題ありません。

修理ジョブでは、並列化のために "修理オフセット" が使用されます。 これは照合されているレコードのデータベーステーブルへのオフセットです。 このオフセットによって、複数の背景ジョブの作業を同期化できます。

これによって、ソースコードに対する検索とインデックスの作業を有効または無効にすることができます。

予約済みログイン

特定の単語は、your GitHub Enterprise Server instance の内部使用のために予約されています。つまり、これらの単語をユーザー名として使用することはできません。

たとえば、次の単語は予約されています。

  • admin
  • enterprise
  • login
  • staff
  • support

完全なリストまたは予約語について確認するには、サイト管理者ダッシュボードの [予約済みログイン] に移動します。

Advanced Security コミッター

GitHub Advanced Security のシートを現在使用しているアクティブなコミッターの数を確認できます。また、他の組織やリポジトリに対して GitHub Advanced Security を有効にした場合に使用される追加のシート数を計算できます。

[現在のアクティブなコミッター数] では、GitHub Advanced Security が有効になっているリポジトリのアクティブなコミッターの数を確認できます。 これは、現在使用されているライセンス シートの数です。

[インスタンス全体の最大コミッター数] では、エンタープライズ内のすべてのリポジトリのアクティブなコミッターの数を確認できます。 これは、エンタープライズ内のすべてのリポジトリに対して GitHub Advanced Security を有効にした場合に使用されるシートの数です。

[追加の高度なコミッターの計算] では、特定の組織とリポジトリに対して GitHub Advanced Security を有効にした場合に使用される追加のシートの数を計算できます。 [組織とリポジトリ] で、1 行に 1 つの組織またはリポジトリを含む組織とリポジトリのリストを入力または貼り付けます。

example-org
octo-org/octo-repo

その結果、それらの組織とリポジトリに対して GitHub Advanced Security を有効にした場合に使用される追加のシートの数が得られます。

Advanced Security の課金について詳しくは、「Advanced Security の課金について」を参照してください。

全ユーザ

組織、ユーザー、ポリシー、設定を管理するには、サイト管理者ダッシュボードのこのセクションを参照してください。

リポジトリ

これは your GitHub Enterprise Server instance 上のリポジトリのリストです。 リポジトリ名をクリックしてリポジトリを管理するための機能にアクセスできます。

すべてのユーザー

ここでは、your GitHub Enterprise Server instance 上のすべてのユーザーの確認と、SSH キー監査を開始することができます。

サイトアドミン

ここでは、your GitHub Enterprise Server instance 上のすべての管理者の確認と、SSH キー監査を開始することができます。

休眠ユーザ

ここでは、your GitHub Enterprise Server instance 上のすべての非アクティブなユーザーを確認でき、一時停止させることができます。 ユーザー アカウントは、次の場合において、非アクティブ ("休眠") と見なされます。

  • your GitHub Enterprise Server instance で設定されている休眠しきい値よりも長く存在している。
  • その期間内にどのアクティビティも生成していない。
  • サイト管理人ではない

休眠の閾値は、休眠と見なされるまでにユーザがアクティブであってはならない期間です。 既定の休眠のしきい値は 90 日ですが、your GitHub Enterprise Server instance の休止のしきい値をカスタマイズできます。 詳細については、「休眠ユーザーの管理」を参照してください。

停止されたユーザ

ここでは、your GitHub Enterprise Server instance 上の一時停止されたすべてのユーザーの確認と、SSH キー監査を開始することができます。