终结点提供有关应用程序审核事件的信息。auditeventsSpring中文文档

检索审核事件

若要检索审核事件,请向 发出请求,如以下基于 curl 的示例所示:GET/actuator/auditeventsSpring中文文档

$ curl 'http://localhost:8080/actuator/auditevents?principal=alice&after=2024-06-20T09%3A57%3A37.755126481Z&type=logout' -i -X GET

前面的示例检索 2017 年 11 月 7 日 09:37 之后发生的事件(UTC 时区)。 生成的响应类似于以下内容:logoutaliceSpring中文文档

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 127

{
  "events" : [ {
    "timestamp" : "2024-06-20T09:57:37.756180874Z",
    "principal" : "alice",
    "type" : "logout"
  } ]
}

查询参数

终结点使用查询参数来限制它返回的事件。 下表显示了支持的查询参数:Spring中文文档

参数 描述

afterSpring中文文档

将事件限制为在给定时间之后发生的事件。自选。Spring中文文档

principalSpring中文文档

将事件限制为具有给定主体的事件。自选。Spring中文文档

typeSpring中文文档

将事件限制为具有给定类型的事件。自选。Spring中文文档

响应结构

响应包含与查询匹配的所有审核事件的详细信息。 下表描述了响应的结构:Spring中文文档

路径 类型 描述

eventsSpring中文文档

ArraySpring中文文档

一系列审核事件。Spring中文文档

events.[].timestampSpring中文文档

StringSpring中文文档

事件发生时间的时间戳。Spring中文文档

events.[].principalSpring中文文档

StringSpring中文文档

触发事件的主体。Spring中文文档

events.[].typeSpring中文文档

StringSpring中文文档

事件的类型。Spring中文文档

参数 描述

afterSpring中文文档

将事件限制为在给定时间之后发生的事件。自选。Spring中文文档

principalSpring中文文档

将事件限制为具有给定主体的事件。自选。Spring中文文档

typeSpring中文文档

将事件限制为具有给定类型的事件。自选。Spring中文文档

路径 类型 描述

eventsSpring中文文档

ArraySpring中文文档

一系列审核事件。Spring中文文档

events.[].timestampSpring中文文档

StringSpring中文文档

事件发生时间的时间戳。Spring中文文档

events.[].principalSpring中文文档

StringSpring中文文档

触发事件的主体。Spring中文文档

events.[].typeSpring中文文档

StringSpring中文文档

事件的类型。Spring中文文档