文章版本: Enterprise Server 2.17
站点管理员仪表板
站点管理员仪表板提供了多种工具,这些工具可以帮助您管理 您的 GitHub Enterprise Server 实例。
要访问仪表板,请在任意页面的右上角中单击 。
许可信息与搜索
请参照站点管理员仪表板的此部分检查您当前的 GitHub Enterprise 许可;搜索用户和仓库;查询审核日志。
管理控制台
您可以在此处启动 管理控制台,以管理域、身份验证和 SSL 等虚拟设备设置。
探索
GitHub 趋势页面中的数据按每天、每周和每月的时间跨度为仓库和开发者计算。 在 Explore 部分中,您可以看到此数据的最后缓存时间,并将新的趋势计算作业加入队列。
审核日志
GitHub Enterprise 会实时记录您可以查询的审核操作。
默认情况下,审核日志会按时间倒序显示所有已审核操作的列表。 要对此列表进行筛选,您可以在 Query 文本框中输入键值对,然后单击 Search,如“搜索审核日志”所述。
更多关于审核日志的信息,请参阅“审核日志”。有关审核操作的完整列表,请参阅“审核的操作”。
报告
如果您需要获取关于 您的 GitHub Enterprise Server 实例 中用户、组织和仓库的信息,正常些情况下,您将通过 GitHub API 提取 JSON 数据。 但遗憾的是,此 API 可能无法提供您需要的所有数据,并且需要一定的专业技术知识才能使用。 因此,站点管理员仪表板提供 Reports 部分代替 API 方法,您可以通过仪表板轻松下载 CSV 报告,其中包含大部分您有可能需要的用户、组织和仓库信息。
具体来讲,您可以下载列出以下信息的 CSV 报告:
- 所有用户
- 在上个月内曾处于活动状态的所有用户
- 一个月或更长时间未活动的所有用户
- 曾被挂起的所有用户
- 所有组织
- 所有仓库
您还可以通过向站点管理员帐户进行标准 HTTP 身份验证,以编程方式访问这些报告。 You must use a personal access token with the site_admin
scope. 更多信息请参阅“创建命令行的个人访问令牌”。
下面是如何使用 cURL 下载“所有用户”报告的示例:
curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv
要以编程方式访问其他报告,请将 all_users
替换为 active_users
、dormant_users
、suspended_users
、all_organizations
或 all_repositories
。
注:如果没有可用的缓存报告,最初的 curl
请求会返回 202 HTTP 响应;将在后台生成报告。 您可以发送另一个请求来下载报告。 您可以使用具有 site_admin
作用域的密码或 OAuth 令牌代替密码。
用户报告
键 | 描述 |
---|---|
created_at | 用户帐户的创建时间(ISO 8601 时间戳形式) |
id | 用户或组织的帐户 ID |
login | 帐户的登录名称 |
电子邮件 | 帐户的主电子邮件地址 |
角色 | 帐户属于管理员还是普通用户 |
suspended? | 帐户是否已挂起 |
last_logged_ip | 最近登录帐户的 IP 地址 |
repos | 帐户拥有的仓库数量 |
ssh_keys | 注册到帐户的 SSH 密钥数量 |
org_memberships | 帐户所属的组织数量 |
dormant? | 帐户是否休眠 |
last_active | 帐户上次活动时间(ISO 8601 时间戳形式) |
raw_login | 原始登录信息(JSON 格式) |
2fa_enabled? | 用户是否已启用双重身份验证 |
组织报告
键 | Description |
---|---|
id | 组织 ID |
created_at | 组织创建时间 |
login | 组织的登录名称 |
电子邮件 | 组织的主电子邮件地址 |
owners | 组织所有者数量 |
members | 组织成员数量 |
团队 | 组织团队数量 |
repos | 组织仓库数量 |
2fa_required? | 组织是否需要双重身份验证 |
仓库报告
键 | 描述 |
---|---|
created_at | 仓库创建时间 |
owner_id | 仓库所有者的 ID |
owner_type | 仓库由用户所有还是由组织所有 |
owner_name | 仓库所有者的名称 |
id | 仓库 ID |
name | 仓库名称 |
可见性 | 仓库是公共还是私有 |
readable_size | 以人类可读格式表示的仓库大小 |
raw_size | 以数字形式表示的仓库大小 |
collaborators | 仓库协作者数量 |
fork? | 仓库是否为分叉 |
deleted? | 仓库是否已删除 |
索引
GitHub 的代码搜索功能由 ElasticSearch 提供支持。 站点管理员仪表板的这一部分会显示 ElasticSearch 集群的当前状态,并提供多种工具来控制搜索和索引行为。 这些工具分为以下三类。
代码搜索
此类允许您启用或禁用对源代码进行的搜索和索引操作。
代码搜索索引修复
此类控制着代码搜索索引的修复方式。 您可以
- 启用或禁用索引修复作业
- 开始新的索引修复作业
- 重置所有索引修复状态
GitHub Enterprise 使用修复作业协调搜索索引的状态与数据库中存储的数据(问题、拉取请求、仓库和用户)以及 Git 仓库中存储的数据(源代码)。 以下情况下会进行此操作:
- 创建新的搜索索引;
- 需要重新填入缺失的数据;或者
- 需要更新旧的搜索数据。
也就是说,修复作业是根据需要启动的,并在后台运行,而不是站点管理员通过任何方式排定的。
此外,修复作业还使用“修复偏移”实现并行化。 偏移是指协调的记录在数据库表中的偏移。 多个后台作业可以基于此偏移同步工作。
进度条会在所有后台工作进程中显示修复作业的当前状态。 此值是修复偏移与数据中最高记录 ID 的百分比差异。 不用担心修复作业完成后在进度条中显示的值:因为它表示的是修复偏移与数据库中最高记录 ID 之差,随着更多的仓库添加到 您的 GitHub Enterprise Server 实例 中,即使这些仓库实际上已编制索引,此值也会减小。
您可以随时启动新的代码搜索索引修复作业。 在协调搜索索引与数据库和 Git 仓库数据时,它将使用单个 CPU。 为了最大限度地减小对 I/O 性能的影响并减小操作超时的几率,请先尝试在非高峰期运行修复作业。 使用 top
等实用程序监视系统的平均负载和 CPU 利用率;如果您没有注意到任何显著的变化,那么在高峰期运行索引修复作业也应当是安全的。
问题索引修复
此类控制着问题索引的修复方式。 您可以
- 启用或禁用索引修复作业
- 开始新的索引修复作业
- 重置所有索引修复状态
仓库
这是 您的 GitHub Enterprise Server 实例 上的仓库列表。 您可以单击仓库名称,然后访问各项功能,对仓库进行管理。
所有用户
您可以在此查看 您的 GitHub Enterprise Server 实例 上的所有用户,并发起 SSH 密钥审核。
站点管理员
您可以在此查看 您的 GitHub Enterprise Server 实例 上的所有管理员,并发起 SSH 密钥审核。
休眠用户
您可以在此查看并挂起 您的 GitHub Enterprise Server 实例 上的所有非活动用户。 以下情况下,会认定用户帐户处于非活动状态(“休眠”):
- 存在时间长于为 您的 GitHub Enterprise Server 实例 设置的休眠阈值。
- 在该时间段内没有发生任何活动。
- 不是站点管理员。
休眠阈值是指用户必须多久不活动才被视为休眠。 默认休眠阈值是 90 天,但您可以自定义 您的 GitHub Enterprise Server 实例 的休眠阈值。 更多信息请参阅“管理休眠用户”。
已挂起的用户
您可以在此查看 您的 GitHub Enterprise Server 实例 上所有已被挂起的用户,并发起 SSH 密钥审核。