Skip to main content

审查组织的审核日志

审核日志允许组织管理员快速审查组织成员执行的操作。 其中包含操作执行人、操作内容和执行时间等详细信息。

访问审核日志

审核日志列出了由当前月份和前六个月内影响组织的活动触发的事件。 只有所有者才能访问组织的审核日志。

默认情况下,仅显示过去三个月的事件。 若要查看较旧的事件,必须使用 created 参数指定日期范围。 有关详细信息,请参阅“了解搜索语法”。

  1. 在 GitHub.com 的右上角,选择个人资料照片,然后单击 “你的组织”****。

    @octocat 的个人资料图片下的下拉菜单的屏幕截图。 “你的组织”以深橙色标出。

  2. 在组织旁边,单击“设置”。

  3. 在侧边栏的“存档”部分中,单击“ 日志”,然后单击“审核日志”。

搜索审核日志

每个审核日志条目的名称由事件类型组成,后跟操作类型。 例如,repo.create 条目是指对 repo 类别的 create 操作。

每个审核日志条目都显示有关事件的适用信息,例如:

  • 执行操作的组织
  • 执行操作的用户(参与者)
  • 受操作影响的用户
  • 执行操作的仓库
  • 执行的操作
  • 发生操作的国家/地区
  • 发生操作的日期和时间

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

基于操作搜索

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

  • 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 用户名,而不是个人的真实姓名。

基于执行的操作搜索

若要搜索特定事件,请在查询中使用 action 限定符。 审核日志中列出的操作分为不同类别。 有关每个类别中事件的完整列表,请参阅“组织的审核日志事件”。

| 类别名称 | 说明 |------------------|------------------- | account | 包含与组织帐户相关的所有活动。 | advisory_credit | 包含与 GitHub Advisory Database 中安全公告的贡献者积分相关的所有活动。 有关详细信息,请参阅“About repository security advisories”。 | auto_approve_personal_access_token_requests | 包含与组织的 fine-grained personal access token 审批策略相关的活动。 有关详细信息,请参阅“为组织设置个人访问令牌策略”。 | billing | 包含与组织计费相关的所有活动。 | business | 包含与企业的业务设置相关的活动。 | | codespaces | 包含与组织的 codespace 相关的活动。 | | copilot |包含与 GitHub Copilot Business 订阅相关的所有活动。 | dependabot_alerts | 包含现有存储库中 Dependabot alerts 的组织级配置活动。 有关详细信息,请参阅“关于 Dependabot 警报”。 | dependabot_alerts_new_repos | 包含在组织中创建的新存储库中 Dependabot alerts 的组织级配置活动。 | dependabot_security_updates | 包含现有存储库中 Dependabot security updates 的组织级配置活动。 有关详细信息,请参阅“配置 Dependabot 安全更新”。 | dependabot_security_updates_new_repos | 包含在组织中创建的新存储库的 Dependabot security updates 的组织级配置活动。 | dependency_graph | 包含存储库的依赖项关系图的组织级配置活动。 有关详细信息,请参阅“关于依赖关系图”。 | dependency_graph_new_repos | 包含在组织中创建的新存储库的组织级配置活动。 | discussion_post | 包含与发布到团队页面的讨论相关的所有活动。 | discussion_post_reply | 包含与回复发布到团队页面的讨论相关的所有活动。 | enterprise | 包含与企业设置相关的活动。 | | hook | 包含与 Webhook 相关的所有活动。 | integration_installation | 包含与帐户中安装的集成相关的活动。 | | integration_installation_request | 包含与组织成员请求所有者批准用于组织的集成相关的所有活动。 | | issue | 包含与删除问题相关的活动。 | marketplace_agreement_signature | 包含与签署 GitHub Marketplace 开发者协议相关的所有活动。 | marketplace_listing | 包含与在 GitHub Marketplace 中列出应用相关的所有活动。 | members_can_create_pages | 包含与管理组织中存储库的 GitHub Pages 站点的发布相关的所有活动。 有关详细信息,请参阅“管理组织的 GitHub Pages 站点发布”。 | | org | 包含与组织成员资格相关的活动。 | org_secret_scanning_automatic_validity_checks | 包含与 secret scanning 自动有效性检查启用和禁用相关的组织级活动。 有关详细信息,请参阅“管理组织的安全和分析设置”。 | organization_default_label | 包含与组织中存储库的默认标签相关的所有活动。 | oauth_application | 包含与 OAuth apps 相关的所有活动。 | packages | 包含与 GitHub Packages 相关的所有活动。 | payment_method | 包含与组织如何支付 GitHub 费用相关的所有活动。 | personal_access_token | 包含与组织中的 fine-grained personal access token 相关的活动。 有关详细信息,请参阅“管理个人访问令牌”。 | profile_picture| 包含与组织的头像相关的所有活动。 | project | 包含与项目板相关的所有活动。 | protected_branch | 包含与受保护分支相关的所有活动。 | repo | 包含与组织拥有的存储库相关的活动。 | repository_advisory | 包含与 GitHub Advisory Database 中的安全通知相关的存储库级活动。 有关详细信息,请参阅“About repository security advisories”。 | repository_content_analysis | 包含与为专用存储库启用或禁用数据使用相关的所有活动。 有关详细信息,请参阅“管理存储库的安全和分析设置”。 | repository_dependency_graph | 包含与为专用存储库启用或禁用依赖项关系图相关的存储库级活动。 有关详细信息,请参阅“关于依赖关系图”。 | repository_secret_scanning_automatic_validity_checks |包含与 secret scanning 自动有效性检查启用和禁用相关的存储库级活动。 有关详细信息,请参阅“管理存储库的安全和分析设置”。 | repository_vulnerability_alert | 包含与 Dependabot alerts 相关的所有活动。 | repository_vulnerability_alerts | 包含 Dependabot alerts 的存储库级配置活动。 | restore_member | 当组织所有者恢复成员时触发。 有关详细信息,请参阅“Reinstating a former member of your organization(恢复组织前成员的身份)”。| | sponsors| 包含与“赞助”按钮相关的所有事件(请参阅“在仓库中显示赞助者按钮”) | team | 包含与组织中的团队相关的所有活动。 | workflows | 包含与 GitHub Actions 工作流相关的活动。

您可以使用这些词搜索特定的操作集。 例如:

  • action:team 查找分组在团队类别中的所有事件。
  • -action:hook 排除 Webhook 类别中的所有事件。

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

  • action:team.create 查找创建团队的所有事件。
  • -action:hook.events_changed 排除已更改 Webhook 上事件的所有事件。

基于操作时间搜索

使用 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" 查找全发生在美国的事件。

导出审核日志

使用“导出”下拉菜单,可以将日志导出为 JSON 数据或逗号分隔值 (CSV) 文件****。

若要筛选导出结果,请在使用“导出”下拉菜单之前使用一个或多个支持的限定符进行搜索。

限定符示例值
actionteam.create
actoroctocat
usercodertocat
orgocto-org
repoocto-org/documentation
created2019-06-01

导出日志后,你将在生成的文件中看到以下键和值。

密钥示例值
actionteam.create
actoroctocat
usercodertocat
actor_location.country_codeUS
orgocto-org
repoocto-org/documentation
created_at1429548104000 (Timestamp shows the time since Epoch with milliseconds.)
data.emailoctocat@nowhere.com
data.hook_id245
data.events["issues", "issue_comment", "pull_request", "pull_request_review_comment"]
data.events_were["push", "pull_request", "issues"]
data.target_loginoctocat
data.old_userhubot
data.teamocto-org/engineering

使用审核日志 API

使用 GitHub Enterprise Cloud 的组织可以使用 GraphQL API 和 REST API 与审核日志进行交互。 有关详细信息,请参阅 GitHub Enterprise Cloud 文档

延伸阅读