Server Statistics の利点について
Server Statistics は、Organization のニーズを予測し、チームの活動状況を把握し、GitHub Enterprise Server から得られた価値を確認するのに役立ちます。
Server Statistics を有効にすると、特定の機能のインスタンスでの使用量に関する集計データが経時的に収集されます。 最終日のデータのみを返す他の Admin Stats API エンドポイントとは異なり、Server Statistics では、機能を有効にした日から収集されたすべての Server Statistics メトリックの履歴データが提供されます。 詳しくは、「自社でサーバー統計を有効にする」を参照してください。
Server Statistics を有効にすると、より優れた GitHub を構築できます。 提供される集計データにより、お客様に対する GitHub の価値についての分析情報が得られます。 この情報を利用することで、GitHub は製品に関していっそう適切な決定を情報に基づいて行うことができ、最終的にはお客様のメリットになります。
データのセキュリティについて
GitHub はお客様のデータを尊重します。 前もってお客様から許可をいただかない限り、お使いの GitHub Enterprise Server インスタンス からデータを送信することはありません。
GitHub は個人データを収集しません。 また、コード、issue、コメント、pull request の内容など、GitHub のいかなるコンテンツも収集しません。
データにアクセスできるのは、GitHub Enterprise Cloud 上の接続された Enterprise アカウントまたは Organization の所有者だけです。
リポジトリ、issue、pull request、その他の機能については、特定の集計メトリックのみが収集されます。 収集される集計メトリックの一覧については、「Server Statistics で収集されるデータ」をご覧ください。
収集されるメトリックは、GitHub Enterprise Server の今後の機能リリースで更新され、それについては GitHub Enterprise Server のリリース ノートで説明されます。 さらに、この記事もすべてのメトリックの更新に関して更新されます。
Server Statistics のデータの格納およびセキュリティ保護の方法について詳しくは、「GitHub のセキュリティ」をご覧ください。
データの保持と削除について
GitHub は、お客様の GitHub Enterprise Server ライセンスがアクティブで、Server Statistics 機能が有効になっている場合にのみ、Server Statistics のデータを収集します。
お客様がデータの削除を望まれる場合は、GitHub サポート、お客様の GitHub アカウント担当者、または担当のカスタマー サクセス マネージャーにご連絡ください。 一般に、データの削除は、プライバシーに関する声明で指定されている期間に行われます。 詳しくは、GitHub.com のドキュメントの「GitHub のプライバシーについての声明」をご覧ください。
データの移植性について
GitHub Enterprise Cloud の Organization 所有者または Enterprise 所有者は、CSV または JSON ファイルにデータをエクスポートすることで、または Server Statistics REST API を使って、Server Statistics のデータにアクセスできます。 詳細については、「REST API を使用したサーバー統計の要求」または「Server Statistics をエクスポートする」を参照してください。
データ収集の無効化について
Server Statistics の機能はいつでも無効にできます。 詳しくは、「自社でサーバー統計を有効にする」を参照してください。
Server Statistics で収集されるデータ
Server Statistics を有効にすると、お使いの GitHub Enterprise Server インスタンス で実行される日次ジョブを通じてメトリックが収集されます。 集計メトリックは、GitHub Enterprise Cloud の組織またはエンタープライズ アカウントに格納され、お使いの GitHub Enterprise Server インスタンス には格納されません。
次の集計メトリックは、毎日収集および送信され、その日の合計カウントを表します。
| CSV 列 | Name | 説明 |
|---|---|---|
| A | github_connect.features_enabled | インスタンスに対して有効になっている GitHub Connect 機能の配列 (「GitHub Connect について」を参照) |
| B | host_name | インスタンスのホスト名 |
| C | dormant_users.dormancy_threshold | ユーザーが休眠と見なされるまでに非アクティブである必要がある時間の長さ |
| D | dormant_users.total_dormant_users | 休眠ユーザー アカウントの数 |
| E | ghes_version | インスタンスが実行されている GitHub Enterprise Server のバージョン |
| F | server_id | インスタンスに対して生成された UUID |
| G | collection_date | メトリックが収集された日付 |
| H | schema_version | このデータの格納に使用されるデータベース スキーマのバージョン |
| I | ghe_stats.comments.total_commit_comments | コミットに対するコメントの数 |
| J | ghe_stats.comments.total_gist_comments | gist に対するコメントの数 |
| K | ghe_stats.comments.total_issue_comments | イシューに対するコメントの数 |
| L | ghe_stats.comments.total_pull_request_comments | pull request に対するコメントの数 |
| M | ghe_stats.gists.total_gists | gists の数 (シークレットとパブリックの両方) |
| N | ghe_stats.gists.private_gists | シークレット gist の数 |
| O | ghe_stats.gists.public_gists | パブリック gist の数 |
| P | ghe_stats.hooks.total_hooks | pre-receive フックの数 (アクティブと非アクティブの両方) |
| Q | ghe_stats.hooks.active_hooks | アクティブな pre-receive フックの数 |
| R | ghe_stats.hooks.inactive_hooks | 非アクティブな pre-receive フックの数 |
| S | ghe_stats.issues.total_issues | イシューの数 (オープンとクローズの両方) |
| T | ghe_stats.issues.open_issues | オープンのイシューの数 |
| U | ghe_stats.issues.closed_issues | クローズされたイシューの数 |
| V | ghe_stats.milestones.total_milestones | マイルストーンの数 (オープンとクローズの両方) |
| W | ghe_stats.milestones.open_milestones | オープンのマイルストーンの数 |
| X | ghe_stats.milestones.closed_milestones | クローズされたマイルストーンの数 |
| Y | ghe_stats.orgs.total_orgs | 組織の数 (有効と無効の両方) |
| Z | ghe_stats.orgs.disabled_orgs | 無効な組織の数 |
| AA | ghe_stats.orgs.total_teams | チームの数 |
| AB | ghe_stats.orgs.total_team_members | チーム メンバーの数 |
| AC | ghe_stats.pages.total_pages | GitHub Pages サイトの数 |
| AD | ghe_stats.pulls.total_pulls | pull request の数 |
| AE | ghe_stats.pulls.merged_pulls | マージされた pull request の数 |
| AF | ghe_stats.pulls.mergeable_pulls | 現在マージ可能な pull request の数 |
| AG | ghe_stats.pulls.unmergeable_pulls | 現在マージ不可能な pull request の数 |
| AH | ghe_stats.repos.total_repos | リポジトリの数 (アップストリーム リポジトリとフォークの両方) |
| AI | ghe_stats.repos.root_repos | アップストリーム リポジトリの数 |
| AJ | ghe_stats.repos.fork_repos | フォークの数 |
| AK | ghe_stats.repos.org_repos | 組織が所有しているリポジトリの数 |
| AL | ghe_stats.repos.total_pushes | リポジトリへのプッシュの数 |
| AM | ghe_stats.repos.total_wikis | wiki の数 |
| AN | ghe_stats.users.total_users | ユーザー アカウントの数 |
| AO | ghe_stats.users.admin_users | サイト管理者であるユーザー アカウントの数 |
| AP | ghe_stats.users.suspended_users | 一時停止されているユーザー アカウントの数 |
必要に応じて、GitHub Actions に関する追加データを含めることができます。 詳しくは、「サーバー統計に GitHub Actions に関するデータを含める」を参照してください。
Server Statistics データの例
Server Statistics の CSV エクスポートに含まれる見出しの例を確認するには、Server Statistics CSV の例をダウンロードしてください。
Server Statistics API の応答ペイロードの例については、「REST API を使用したサーバー統計の要求」をご覧ください。