Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
GitHub AE 目前是有限发行版。请联系我们的销售团队以了解更多信息。

搜索企业的审核日志

您可以搜索企业中已审核操作的广泛列表。

Enterprise owners can search the audit log.

关于搜索企业审核日志

通过使用 Filters(筛选器)下拉列表或键入搜索查询,可以直接从用户界面搜索企业审核日志。

搜索查询

有关查看企业审核日志的更多信息,请参阅“访问企业的审核日志”。

还可以使用 API 检索审核日志事件。 更多信息请参阅“使用企业的审核日志 API”。

请注意,无法使用文本搜索条目。 但是,您可以使用各种过滤器构建搜索查询。 查询日志时使用的许多运算符,如 -><,与在 GitHub AE 上搜索时的格式相同。 更多信息请参阅“在 GitHub 上搜索”。

:The audit log lists events triggered by activities that affect your enterprise. Audit logs for GitHub AE are retained indefinitely.

By default, only events from the past three months are displayed. To view older events, you must specify a date range with the created parameter. 更多信息请参阅“了解搜索语法”。

搜索查询筛选器

过滤,过滤器描述
昨日活动过去一天创建的所有操作。
企业帐户管理business 类别中的所有操作。
组织成员资格邀请新用户加入组织时的所有操作。
团队管理与团队管理相关的所有操作。
- 在团队中添加或删除用户帐户或存储库时
- 当团队维护者被提升或降级时
- 当团队被删除时
存储库管理存储库管理的所有操作。
- 创建或删除存储库的时间
- 更改存储库可见性
- 在存储库中添加或删除团队的时间
挂钩活动Web 挂钩和预接收挂钩的所有操作。
安全管理有关 SSH 密钥、部署密钥、安全密钥、2FA 和 SAML 单点登录凭据授权以及存储库漏洞警报的所有操作。

搜索查询语法

您可以从一个或多个 key:value 对(由 AND/OR 逻辑运算符分隔)编写搜索查询。 例如,要查看自 2017 年初开始影响仓库 octocat/Spoon-Knife 的所有操作:

repo:"octocat/Spoon-Knife" AND created:>=2017-01-01

可在搜索查询中使用的 key:value 对包括:

actor_id发起操作的用户帐户的 ID
actor发起操作的用户帐户的名称
oauth_app_id与操作相关联的 OAuth 应用程序的 ID
action已审核操作的名称
user_id受操作影响的用户的 ID
用户受操作影响的用户的名称
repo_id受操作影响的仓库的 ID(若适用)
repo受操作影响的仓库的名称(若适用)
actor_ip发起操作的 IP 地址
created操作发生的时间
from发起操作的视图
note事件特定的其他信息(采用纯文本或 JSON 格式)
org受操作影响的组织的名称(若适用)
org_id受操作影响的组织的 ID(若适用)
business受操作影响的企业的名称(若适用)
business_id受操作影响的企业的 ID(若适用)

若要查看按类别分组的操作,还可以将操作限定符用作 key:value 对。 更多信息请参阅“根据执行的操作进行搜索”。

有关企业审核日志中操作的完整列表,请参阅“企业的审核日志操作”。

搜索审核日志

基于操作搜索

使用操作限定符将操作限于特定类型的操作。 例如:

  • operation:access 查找其中资源被访问过的所有事件。
  • operation:authentication 查找其中执行了身份验证事件的所有事件。
  • operation:create 查找在其中创建了资源的所有事件。
  • operation:modify 查找在其中修改了现有资源的所有事件。
  • operation:remove 查找在其中删除的现有资源的所有事件。
  • operation:restore 查找在其中恢复了现有资源的所有事件。
  • operation:transfer 查找在其中转移了现有资源的所有事件。

基于仓库搜索

使用 repo 限定符将操作限于特定仓库。 例如:

  • repo:my-org/our-repo 会找到在 my-org 组织的 our-repo 仓库中发生的所有事件。
  • repo:my-org/our-repo repo:my-org/another-repo 会找到在 my-org 组织的 our-repoanother-repo 仓库中发生的所有事件。
  • -repo:my-org/not-this-repo 会排除在 my-org 组织的 not-this-repo 仓库中发生的所有事件。

请注意,您必须在 repo 限定符中包含帐户名称;仅搜索 repo:our-repo 将不起作用。

基于用户搜索

actor 限定符可将事件范围限于执行操作的人员。 例如:

  • actor:octocat 会找到 octocat 执行的所有事件。
  • actor:octocat actor:hubot 会找到 octocathubot 执行的所有事件。
  • -actor:hubot 会排除 hubot 执行的所有事件。

请注意,只能使用 GitHub AE 用户名,而不是个人的真实姓名。

基于执行的操作搜索

要搜索特定事件,请在查询中使用 action 限定符。 例如:

  • action:team 会找到团队类别中的所有事件。
  • -action:hook 会排除 web 挂钩类别中的所有事件。

每个类别都有一组可进行过滤的关联操作。 例如:

  • action:team.create 会找到团队创建处的所有事件。
  • -action:hook.events_changed 会排除 web 挂钩上事件已经改动的所有事件。

可在企业审核日志中找到的操作分为以下几类:

类别名称描述
artifactContains activities related to GitHub Actions workflow run artifacts.
businessContains activities related to business settings for an enterprise.
businessContains activities related to business settings for an enterprise.
checksContains activities related to check suites and runs.
commit_commentContains activities related to updating or deleting commit comments.
dependabot_alertsContains organization-level configuration activities for Dependabot 警报 in existing repositories. 更多信息请参阅“关于 Dependabot 警报 警报”。
dependency_graphContains organization-level configuration activities for dependency graphs for repositories. 更多信息请参阅“关于依赖关系图”。
external_groupContains activities related to Okta groups.
gistContains activities related to Gists.
ip_allow_listContains activities related to enabling or disabling the IP allow list for an organization.
issueContains activities related to pinning, transferring, or deleting an issue in a repository.
members_can_create_pagesContains activities related to managing the publication of GitHub Pages sites for repositories in the organization. 更多信息请参阅“管理组织的 GitHub Pages 站点发布”。
members_can_delete_reposContains activities related to enabling or disabling repository creation for an organization.
oauth_accessContains activities related to OAuth access tokens.
orgContains activities related to organization membership.
org_credential_authorizationContains activities related to authorizing credentials for use with SAML single sign-on.
organization_default_labelContains activities related to default labels for repositories in an organization.
packagesContains activities related to GitHub Packages.
private_repository_forkingContains activities related to allowing forks of private and internal repositories, for a repository, organization or enterprise.
projectContains activities related to project boards.
pull_requestContains activities related to pull requests.
repoContains activities related to the repositories owned by an organization.
repository_imageContains activities related to images for a repository.
repository_secret_scanningContains repository-level activities related to secret scanning. 更多信息请参阅“关于密钥扫描”。
repository_vulnerability_alertContains activities related to Dependabot 警报.
secret_scanningContains organization-level configuration activities for secret scanning in existing repositories. 更多信息请参阅“关于密钥扫描”。
security_keyContains activities related to security keys registration and removal.
ssh_certificate_authorityContains activities related to a SSH certificate authority in an organization or enterprise.
staffContains activities related to a site admin performing an action.
userContains activities related to users in an enterprise or organization.
workflowsContains activities related to GitHub Actions workflows.

基于操作时间搜索

使用 created 限定符在审核日志中根据事件发生的时间过滤事件。

日期格式必须遵循 ISO8601标准,即 YYYY-MM-DD(年-月-日)。 您也可以在日期后添加可选的时间信息 THH:MM:SS+00:00,以便按小时、分钟和秒进行搜索。 这是 T,随后是 HH:MM:SS(时-分-秒)和 UTC 偏移 (+00:00)。

搜索日期时,可以使用大于、小于和范围限定符来进一步筛选结果。 更多信息请参阅“了解搜索语法”。

例如:

  • created:2014-07-08 会找到在 2014 年 7 月 8 日发生的所有事件。
  • created:>=2014-07-08 查找在 2014 年 7 月 8 日或之后发生的所有事件。
  • created:<=2014-07-08 查找在 2014 年 7 月 8 日或之前发生的所有事件。
  • created:2014-07-01..2014-07-31 会找到在 2014 年 7 月发生的所有事件。

基于位置搜索

使用限定符 country,您可以在审核日志中根据发生事件的国家/地区过滤事件。 您可以使用国家/地区的两字母短代码或完整名称。 名称中包含空格的国家/地区需要用引号括起来。 例如:

  • country:de 会找到在德国发生的所有事件。
  • country:Mexico 会找到在墨西哥发生的所有事件。
  • country:"United States" 会找到在美国发生的所有事件。