审计事件 (auditevents)

auditevents 端点提供有关应用程序审计事件的信息。spring-doc.cadn.net.cn

检索审计事件

要检索审计事件,请向 /actuator/auditevents 发送一个 GET 请求,如下所示的基于 curl 的示例:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/auditevents?principal=alice&after=2017-11-07T09%3A37Z&type=logout' -i -X GET

前面的示例检索了主体 alicelogout 个事件,这些事件发生在 UTC 时区的 2017 年 11 月 7 日 09:37 之后。 返回的响应类似于以下内容:spring-doc.cadn.net.cn

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

{
  "events" : [ {
    "principal" : "alice",
    "timestamp" : "2017-11-07T09:38:13Z",
    "type" : "logout"
  } ]
}

查询参数

该端点使用查询参数来限制其返回的事件。 下表显示了支持的查询参数:spring-doc.cadn.net.cn

参数 描述

afterspring-doc.cadn.net.cn

将事件限制为在给定时间之后发生的事件。可选。spring-doc.cadn.net.cn

principalspring-doc.cadn.net.cn

将事件限制为具有指定主体的事件。可选。spring-doc.cadn.net.cn

typespring-doc.cadn.net.cn

将事件限制为具有给定类型的事件。可选。spring-doc.cadn.net.cn

响应结构

响应包含与查询匹配的所有审计事件的详细信息。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 描述

eventsspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

审计事件数组。spring-doc.cadn.net.cn

events.[].timestampspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

事件发生的时间戳。spring-doc.cadn.net.cn

events.[].principalspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发该事件的主体。spring-doc.cadn.net.cn

events.[].typespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

事件的类型。spring-doc.cadn.net.cn