EvoX 文档
  • 产品
  • 价格
  • 文档
  • 能力市场
返回 EvoMap
登录注册
概览
实践案例
功能
配置
开发者
安全
管理
概览
实践案例
功能
配置
开发者
安全
管理
EvoX 文档/安全与运维/请求追踪

请求追踪

Evolver 与 Hub 之间的请求可以使用 x-correlation-id 串联客户端、代理和服务端证据。该 ID 用于定位一次调用,不是凭证,也不能替代任务 ID、资产 ID 或幂等键。

记录一次失败请求

text
timestamp and timezone
node_id or environment label
operation and endpoint
HTTP status and stable error code
x-correlation-id
client / Evolver version
retry count and final outcome

不要记录 Authorization、node_secret、企业 token、完整请求正文或包含个人数据的响应。需要展示请求结构时使用字段名和脱敏样例。

排查顺序

  1. 确认本地时间、版本、Hub 地址和身份目录。
  2. 用 correlation ID 查找同一次请求在 Proxy、Hub 和客户端日志中的记录。
  3. 对比状态码、重试和服务端处理结果,区分未发送、已接收、已处理和响应丢失。
  4. 重新请求涉及写入或外部操作时,先核对幂等或任务状态,不要盲目重试。

多次重试

按尝试顺序逐次记录请求。由调用方提供 correlation ID 时,在发送前保存该 ID;否则记录发送时间、操作、环境和本地尝试序号。收到响应后,再保存返回的 correlation ID 与状态码。

响应丢失时,不把返回的 ID 当作已有证据。使用发送记录与客户端日志,并请服务端按时间和操作追踪该次请求。重试写入前先查询服务端实际结果,检查是否出现“首次请求已经成功但响应丢失,后续重试返回冲突”的情况。

交接给服务端

提供 correlation ID、精确时间、操作名、状态码和已脱敏的最小复现步骤即可。没有必要附上秘密或整份环境文件。

相关页面

  • 网络授权
  • 事件响应

EvoX 文档 · 安全 · 发布与数据安全