Cloudflare Audit Logs 基于账户。所有由用户发起的操作都会在 Cloudflare API 和仪表板中自动记录。系统发起的日志也会被捕获,以反映 Cloudflare 系统自动执行的操作,例如配置更新、后台进程或内部策略执行。
当由用户发起的操作触发额外的自动化行为时,将生成相应的系统发起日志。在某些情况下,由用户发起的日志包含额外的丰富信息,提供更多关于变更内容的上下文,从而更深入地了解操作的完整生命周期。
当操作发生时,它会通过 Cloudflare 的审计日志管道进行流式传输并存储。这确保了在所有产品中都能一致地查看活动。
有关用户发起的操作如何自动记录的更多详细信息,请参阅 Cloudflare 博客 ↗。
Audit Logs(版本 2)提供了一个统一且标准化的系统,用于跟踪和记录 Cloudflare 产品中的操作。该系统通过提供对 Cloudflare 环境中由用户发起和由系统发起的活动的全面洞察,增强了透明度和问责制。
- 标准化日志记录:审计日志以一致的格式在所有 Cloudflare 服务中自动生成,确保统一性并消除不一致性。
- 扩展的产品覆盖范围:Audit Logs 覆盖约 95% 的 Cloudflare 产品,捕获来自关键端点的操作,例如
/accounts、/zones、/organizations、/user和/membershipsAPI。 - 精细筛选:统一格式的日志允许按操作、执行者、方法和资源进行精确筛选,便于高效调查。
- 增强的上下文和透明度:每条日志条目都包含详细的上下文,例如使用的身份验证方法、执行操作的界面(API 或仪表板),以及与 Cloudflare Ray ID 的映射,以提高可追溯性。
- 全面的活动捕获:Audit Logs 记录上述相同端点的创建、更新、删除和查看操作,仅排除少量端点。
-
审计日志保留 18 个月后删除。无需额外设置。
-
在 Audit Logs v2 UI 中,出于性能原因,查询限制为最近 90 天。要访问完整的 18 个月数据,请使用 API 或 Logpush。
-
Enterprise 客户可以使用 Logpush 将审计日志存储超过 18 个月。
您可以使用 Cloudflare 仪表板、API 或 Logpush 检索审计日志。
Audit Logs 可通过 Cloudflare API 获取。要检索审计日志,请使用以下端点:
https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/audit以下是一个检索特定时间段审计日志的示例请求及其相应响应。请将 URL 中的示例值替换为您的实际值:
account_id:您的 Cloudflare 账户标识符。since(必填):审计日志检索的开始日期。接受yyyy-mm-dd(解释为 UTC)或 RFC3339 时间戳(yyyy-mm-ddTHH:MM:SSZ)。before(必填):审计日志检索的结束日期。格式与since相同。
GET https://api.cloudflare.com/client/v4/accounts/1234567890abcdef/logs/audit?since=2025-03-01T00:00:00Z&before=2025-03-26T23:59:59Z{
"result": [
{
"action": "zone.settings.change",
"actor": {
"email": "[email protected]",
"id": "0987654321abcdef"
},
"ip": "192.0.2.1",
"method": "PUT",
"interface": "dashboard",
"resources": [
{
"resource_id": "zone123",
"resource_type": "zone"
}
],
"timestamp": "2025-03-15T14:25:37Z"
}
// Additional log entries
],
"success": true,
"errors": [],
"messages": []
}有关更多信息,请参阅 API 文档 ↗。
要在 Cloudflare 仪表板中访问审计日志,请前往 Manage Account(管理账户) > Audit Logs(审计日志)。
前往 Audit logs(审核日志) ↗默认情况下,Audit Logs v2 仪表板会排除 view 操作以减少干扰。此默认筛选器(Action type(操作类型) 不是 view)同时适用于账户级和组织级审计日志。要包含 view 操作,请移除此筛选器。要仅显示 view 操作,将 Action type(操作类型) 设为 view。
无论仪表板筛选如何,view 操作始终可通过 API 和 Logpush 获取。
账户级 Audit Logs v2 仪表板包含所选时间范围内的分析。Actions over time(一段时间内的操作) 图表会区分成功和失败的操作。摘要卡片显示 Total actions(总操作数)、Unique actors(独立执行者)、Products impacted(受影响产品) 和 Failure rate(失败率)。
选择摘要卡片可查看更多详情:
- Total actions(总操作数):操作类型和身份验证方法
- Unique actors(独立执行者):操作次数最多的执行者
- Products impacted(受影响产品):操作次数最多的产品
- Failure rate(失败率):失败操作及其 HTTP 状态码
要从详情面板将分析和审计日志表聚焦到某个值,请选择 Filter(筛选) 或 Exclude(排除)。分析、表格、筛选器和时间范围会保持同步。
要创建 Logpush 作业:
-
在 Cloudflare 仪表板中,前往 Logpush(日志推送) 页面。
前往 Logpush ↗ -
选择 Create a Logpush job(创建 Logpush 作业)。
-
在 Select a destination(选择目标) 中,选择您所需的目标并添加目标详细信息。
-
在数据集部分,选择 Audit Logs v2 数据集。Audit Logs v2 是基于账户的数据集。
-
完成 Logpush 作业配置后,选择 Submit(提交)。
Resource History 显示 Audit Logs 捕获的每次配置修改中发生了什么变更。对于任意审计日志条目,您可以查看同一资源的先前变更序列,并并排对比被修改的内容。
Resource History 可在 Cloudflare 仪表板和 Audit Logs API 中使用。它使用您已有的审计日志条目。无需额外配置,无需后端重新捕获,也不会改变审计日志的生成方式。
对于任意审计日志条目,Resource History 会按时间顺序检索同一资源的所有其他审计日志条目。然后您可以从该历史中选择更早的条目,查看两者之间具体哪些字段发生了变更。
- 前往 Manage Account(管理账户) > Audit Logs(审计日志)。
- 打开任意审计日志条目。
- 选择 History(历史) 选项卡,查看该条目所描述资源的完整历史。
- 在历史视图中,选择任意更早的条目,并排查看它与当前条目之间发生变化的字段。
当 Resource History 无法识别底层资源时(例如某些由系统发起的事件),仪表板会显示空状态,表明该条目没有可用的变更历史。
您可以使用 History 端点检索任意审计日志条目的变更历史。给定源审计日志条目的 id,该端点会从该条目推导标识筛选条件,并返回您指定日期窗口内的匹配审计日志条目。
对于账户范围的审计日志,使用:
GET https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/audit/{id}/history对于组织范围的审计日志,使用:
GET https://api.cloudflare.com/client/v4/organizations/{organization_id}/logs/audit/{id}/history路径参数 {id} 是要检索资源历史的源审计日志条目的 id。
该端点需要三个查询参数:
action_time(必填):源审计日志条目操作时间的 RFC3339 时间戳。提供由{id}标识的审计日志中的action.time值。这会缩小源条目的查找窗口。since(必填):将返回结果限制为晚于此日期的条目。接受日期字符串(2024-10-30,解释为 UTC)或 RFC3339 时间戳。before(必填):将返回结果限制为早于此日期的条目。格式与since相同。
可选查询参数:
direction:desc(默认)或asc。limit:每页返回的条目数。默认100。cursor:来自先前响应result_info.cursor的分页游标。
Required API token permissions
At least one of the following token permissions is required:Account Settings WriteAccount Settings Read
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/logs/audit/$ID/history" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"result 中的每条条目形状与 Audit Logs 列表端点返回的条目相同。结果使用 result_info 中的 cursor 值分页。
result_info.history_status 字段表示用于构建历史的资源识别质量:
exact:源条目包含资源 URI,因此历史基于精确资源匹配构建。approximate:源条目不包含资源 URI,因此历史基于近似匹配(同一产品和类型的其他资源)构建。仪表板会以警告横幅提示此状态。unavailable:源条目没有足够信息来识别资源。result为空。某些由系统发起的事件可能出现此情况。
Resource History 反映 Audit Logs v2 当前保留的审计日志条目(请参阅保留期限)。超过保留窗口的条目不会返回。Resource History 是查询时能力,不会作为额外字段暴露在 audit_logs_v2 Logpush 数据集中。
Cloudflare 的审计日志通过捕获操作的来源及其发生的上下文,提供环境中活动的详细视图。这些日志按发起操作的主体(用户或系统)以及活动是在特定账户内发生还是跨同一用户配置文件下的多个账户发生进行分类。这种结构支持灵活的筛选、调查和合规监控。
审计日志可以由用户或系统发起。了解所涉及执行者的类型有助于识别操作的来源和意图。
跟踪用户通过 Cloudflare 界面(包括仪表板和 API)发起的操作。这些日志记录谁或什么执行了操作,以及何时发生、影响了哪些资源。由用户发起的操作可以有四种执行者类型:
actor_type="user":操作由个人用户执行。actor_type="cloudflare_admin":操作由 Cloudflare 执行。actor_type="account":操作使用账户 API token 执行。有关更多信息,请参阅账户 API token文档。actor_type="delegated_service":操作由代表用户执行的 Cloudflare 服务完成。日志不会标识发起该操作的用户。
记录 Cloudflare 系统自动进行的更改,无需直接的用户输入。这些日志提供对内部流程、自动化任务和安全事件的可见性。某些条目可能包含关联的用户上下文以提高可追溯性(actor_type="system")。
包含限定在单个 Cloudflare 账户范围内的事件。这些日志可按 account ID 筛选,仅反映该账户内的操作。您可以使用 resource_scope 字段进一步筛选事件,该字段指定资源是与用户、账户还是 zone 关联(resource_scope ="user"、resource_scope ="accounts" 或 resource_scope ="zones")。
反映与用户登录(电子邮件)关联的跨多个账户的操作。这些日志支持跨账户跟踪,可按 user ID 或 email 筛选。它们在用户当时有权访问的任何账户上可见。用户配置文件活动日志可以使用 resource_scope ="user" 进行筛选。
GET /memberships 端点支持跨账户访问。要查询 memberships,请使用参数 resource_scope=memberships。
包含限定在特定 Cloudflare Organizations 范围内的事件。这些日志捕获 Org Admin 通过组织级 API 执行的由用户发起的操作。
您可以使用 API 或 Cloudflare 仪表板检索 Organization 审计日志。
可通过 Audit Logs v2 API 检索:
GET https://api.cloudflare.com/client/v4/organizations/{organization_id}/logs/audit要在 Cloudflare 仪表板中访问 Organization 审计日志,请前往 Organizations(组织) > (选择您的 Organization) > Manage Organization(管理组织) > Audit Logs(审计日志)。
如果您正在查看账户级审计日志,且该账户属于您担任 Organization Super Administrator 的 Organization,可以选择 View Organization Audit Logs(查看组织审计日志) 前往父 Organization 的审计日志。
使用以下示例获取 Cloudflare 账户的审计日志列表。
Required API token permissions
At least one of the following token permissions is required:Account Settings WriteAccount Settings Read
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/logs/audit" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"errors": [
{
"message": "message"
}
],
"result": [
{
"account": {
"id": "4bb334f7c94c4a29a045f03944f072e5",
"name": "Example Account"
},
"action": {
"description": "Add Member",
"result": "success",
"time": "2024-04-26T17:31:07Z",
"type": "create"
},
"actor": {
"id": "f6b5de0326bb5182b8a4840ee01ec774",
"context": "dash",
"email": "[email protected]",
"ip_address": "198.41.129.166",
"token_id": "token_id",
"token_name": "token_name",
"type": "user"
},
"raw": {
"cf_ray_id": "8e9b1c60ef9e1c9a",
"method": "POST",
"status_code": 200,
"uri": "/accounts/4bb334f7c94c4a29a045f03944f072e5/members",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Safari/605.1.15"
},
"resource": {
"id": "id",
"product": "members",
"request": {},
"response": {},
"scope": {},
"type": "type"
},
"zone": {
"id": "id",
"name": "example.com"
}
}
],
"result_info": {
"count": "1",
"cursor": "ASqdKd7dKgxh-aZ8bm0mZos1BtW4BdEqifCzNkEeGRzi_5SN_-362Y8sF-C1TRn60_6rd3z2dIajf9EAPyQ_NmIeAMkacmaJPXipqvP7PLU4t72wyqBeJfjmjdE="
},
"success": true
}Actor 表示谁或什么执行了操作。其身份属性取决于执行者类型。这些属性可以包括用户 ID、电子邮件地址和 IP 地址。执行者类型包括 user、account、cloudflare_admin、delegated_service 或 system。Actor 还可以包含用于发起操作的上下文:
api:操作通过 API 执行。未记录具体凭证类型。api_key:操作使用 Cloudflare Global API Key 进行身份验证。api_token:操作使用 API token 进行身份验证。dash:操作通过 Cloudflare 仪表板执行。oauth:操作使用 OAuth token 进行身份验证。origin_ca_key:操作使用 Origin CA key 进行身份验证。
Action 字段捕获事件的性质以及是否成功。它包括高级类型(例如 create、update、delete)、具体描述(例如 SSO_LOGIN)、操作发生的时间戳以及结果(success 或 failure)。
支持的端点会记录 view 操作,并可通过 Audit Logs v2 API 和 Logpush 获取。仪表板默认排除 view 操作。详情请参阅 View actions(查看操作)。
此字段指执行操作所在的 Cloudflare 账户。它包括唯一的账户 ID 和便于阅读的账户名称,以帮助将活动与客户环境关联。
Resource 标识受操作影响的对象。它包括资源类型、唯一资源 ID、范围(user、account 或 zone),以及可选的与变更关联的产品。
这是日志记录本身的唯一标识符。它可用于去重、关联或在调查期间引用特定操作。