HTTP 交换 (httpexchanges
)
httpexchanges
)
httpexchanges
端点提供了关于 HTTP 请求-响应交换的信息。
检索 HTTP 交换记录
要检索 HTTP 交换记录,请向 /actuator/httpexchanges
发送一个 GET
请求,如下面基于 curl 的示例所示:
$ curl 'http://localhost:8080/actuator/httpexchanges' -i -X GET
生成的响应类似于以下内容:
HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 511
{
"exchanges" : [ {
"timestamp" : "2022-12-22T13:43:41Z",
"request" : {
"uri" : "https://api.example.com",
"method" : "GET",
"headers" : {
"Accept" : [ "application/json" ]
}
},
"response" : {
"status" : 200,
"headers" : {
"Content-Type" : [ "application/json" ]
}
},
"principal" : {
"name" : "alice"
},
"session" : {
"id" : "02778209-bfce-4e93-9ea1-17bda59aaf34"
},
"timeTaken" : "PT0.023S"
} ]
}
响应结构
响应中包含了跟踪的 HTTP 请求-响应交换的详细信息。下表描述了响应的结构:
路径 | 类型 | 描述 |
---|---|---|
exchanges | Array | HTTP 请求-响应交换的数组。 |
exchanges.[].timestamp | String | 交换发生的时间戳。 |
exchanges.[].principal | Object | 交换的主体(如果有)。 |
exchanges.[].principal.name | String | 主体的名称。 |
exchanges.[].request.method | String | 请求的 HTTP 方法。 |
exchanges.[].request.remoteAddress | String | 接收到请求的远程地址(如果已知)。 |
exchanges.[].request.uri | String | 请求的 URI。 |
exchanges.[].request.headers | Object | 请求的头部,按头部名称键控。 |
exchanges.[].request.headers.*.[] | Array | 头部的值 |
exchanges.[].response.status | Number | 响应的状态 |
exchanges.[].response.headers | Object | 响应的头部,按头部名称键控。 |
exchanges.[].response.headers.*.[] | Array | 头部的值 |
exchanges.[].session | Object | 与交换关联的会话(如果有)。 |
exchanges.[].session.id | String | 会话的 ID。 |
exchanges.[].timeTaken | String | 处理交换所花费的时间。 |