HTTP 交换 (`httpexchanges`)

httpexchanges 端点提供有关 HTTP 请求-响应交换的信息。

检索 HTTP 交换

要检索 HTTP 交换，请向 /actuator/httpexchanges 发出 GET 请求，如以下基于 curl 的示例所示

$ curl 'https://: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" : {
      "headers" : {
        "Accept" : [ "application/json" ]
      },
      "method" : "GET",
      "uri" : "https://api.example.com"
    },
    "response" : {
      "headers" : {
        "Content-Type" : [ "application/json" ]
      },
      "status" : 200
    },
    "principal" : {
      "name" : "alice"
    },
    "session" : {
      "id" : "7baf7dde-eb28-4571-8579-d787a7413e25"
    },
    "timeTaken" : "PT0.023S"
  } ]
}

响应结构

响应包含跟踪的 HTTP 请求-响应交换的详细信息。下表描述了响应的结构

路径类型描述

路径	类型	描述
`交换`	`数组`	HTTP 请求-响应交换的数组。
`exchanges.[].timestamp`	`字符串`	交换发生的时间戳。
`exchanges.[].principal`	`对象`	交换的主体（如果存在）。
`exchanges.[].principal.name`	`字符串`	主体的名称。
`exchanges.[].request.method`	`字符串`	请求的 HTTP 方法。
`exchanges.[].request.remoteAddress`	`字符串`	接收请求的远程地址（如果已知）。
`exchanges.[].request.uri`	`字符串`	请求的 URI。
`exchanges.[].request.headers`	`对象`	请求的头部，以头部名称为键。
`exchanges.[].request.headers.*.[]`	`数组`	头部的值
`exchanges.[].response.status`	`数字`	响应的状态
`exchanges.[].response.headers`	`对象`	响应的头部，以头部名称为键。
`exchanges.[].response.headers.*.[]`	`数组`	头部的值
`exchanges.[].session`	`对象`	与交换关联的会话（如果存在）。
`exchanges.[].session.id`	`字符串`	会话的 ID。
`exchanges.[].timeTaken`	`字符串`	处理交换所花费的时间。

交换

数组

HTTP 请求-响应交换的数组。

exchanges.[].timestamp

字符串

交换发生的时间戳。

exchanges.[].principal

对象

交换的主体（如果存在）。

exchanges.[].principal.name

字符串

主体的名称。

exchanges.[].request.method

字符串

请求的 HTTP 方法。

exchanges.[].request.remoteAddress

字符串

接收请求的远程地址（如果已知）。

exchanges.[].request.uri

字符串

请求的 URI。

exchanges.[].request.headers

对象

请求的头部，以头部名称为键。

exchanges.[].request.headers.*.[]

数组

头部的值

exchanges.[].response.status

数字

响应的状态

exchanges.[].response.headers

对象

响应的头部，以头部名称为键。

exchanges.[].response.headers.*.[]

数组

头部的值

exchanges.[].session

对象

与交换关联的会话（如果存在）。

exchanges.[].session.id

字符串

会话的 ID。

exchanges.[].timeTaken

字符串

处理交换所花费的时间。

HTTP 交换 (httpexchanges)

检索 HTTP 交换

响应结构

HTTP 交换 (`httpexchanges`)