ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2020-11-12. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

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

You can use the site admin dashboard to manage users, organizations, and repositories in your enterprise directly in GitHub Enterprise Server.

ここには以下の内容があります:

ダッシュボードへアクセスするには、ページ右上の隅にある をクリックしてください。 サイトアドミン設定にアクセスするための宇宙船のアイコン

ライセンスの情報と検索

現在の GitHub Enterprise のライセンスを確認する、ユーザとリポジトリを検索する、そして Audit log を照会するには、サイトアドミンのダッシュボードのこのセクションを参照してください。

Management Console

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

Explorer

GitHub の 流行ページ のためのデータは、リポジトリとデベロッパーの両方において、日ごと、週ごと、月ごとの期間で計算されます。 Explore のセクションで、このデータが最後にいつキャッシュされたのかの確認や、新規流行計算ジョブをキューに挿入することができます。

Audit log

GitHub Enterpriseは、クエリで確認できる、監査されたアクションのログを保持しています。

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

一般的な監査ログの詳細については、「監査ログ」を参照してください。 監査済みのアクションの全リストについては、「監査済みのアクション」を参照してください。

報告

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

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

  • 全ユーザ
  • 過去一ケ月の間、アクティブだった全ユーザ
  • 過去一ケ月、アクティブでなかった全ユーザ
  • 停止されている全ユーザ
  • 全ての Organization
  • 全ての リポジトリ

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

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

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

他の報告にプログラムでアクセスするには、 all_usersactive_usersや、 dormant_userssuspended_usersall_organizationsall_repositories に置き換えてください。

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

ユーザ報告

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

Organization の報告

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

リポジトリ の報告

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

インデックス化

GitHub のコード検索フィーチャは、Elasticsearch に駆動されています。 サイトアドミンのダッシュボードのこのセクションには、ElasticSearch クラスターの現在のステータスが表示され、検索とインデックス作成の動作を制御するためのいくつかのツールが用意されています。 このツールは、次の3つのカテゴリーに分類されています。

コード検索

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

コード検索インデックスの修復

これはコード検索インデックスがどのように修復されるかを制御します。 次のことができます:

  • インデックスの修理ジョブを有効または無効にする
  • 新規インデックス修理ジョブを開始する
  • インデックス修理状態を全てリセットする

GitHub Enterpriseは、修理ジョブを使って、検索インデックスの状態をデータベースで保存されているデータ(Issueやプルリクエスト、リポジトリ、ユーザ)と Git リポジトリに保存されているデータ(ソースコード)を照合することができます。 これは次の場合に使用されます。

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

すなわち、修理ジョブは、必要に応じて開始され、背景で作動しています。サイトアドミンが修理ジョブの開始時間を決めるわけではありません。

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

プログレスバーは、全ての背景ワーカープロセスによる、現在の修理ステータスを表示します。 それは、データベースの中の最高レコード ID と修理オフセットでのパーセント差です。 修復ジョブが完了した後にプログレスバーに表示される値については心配しないでください。それは修復オフセットとデータベース内の最大レコード ID の差を示すものであるため、たとえリポジトリが実際にインデックス付けされていても、your GitHub Enterprise Server instance にリポジトリが追加されるにつれて値は減少します。

いつでも新規コード検索インデックスの修理ジョブを開始できます。 1つの CPU を使って、検索インデックスをデータベース及びGitのリポジトリデータと照合します。 I/O パフォーマンスに与える影響を最小限にするため、および、オペレーションがタイムアウトする可能性を減少するために混雑していない時間帯に修理ジョブを実行してみてください。 top のようなユーティリティで、システム負荷と CPU 使用率の平均を監視しましょう。大差がない場合は、混雑している時間帯にもインデックスの修理ジョブを実行しても安全なはずです。

Issue インデックスの修復

これは Issues インデックスがどのように修復されるかを制御します。 次のことができます:

  • インデックスの修理ジョブを有効または無効にする
  • 新規インデックス修理ジョブを開始する
  • インデックス修理状態を全てリセットする

リポジトリ

これは 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 キー監査を開始することができます。