api 调用的日志

API调用日志记录请求响应详情，含时间戳、参数、状态码及耗时，用于监控、调试与安全

API 调用的日志

字段名	说明
时间戳	记录 API 调用发生的具体时间，精确到秒、毫秒甚至更小单位，用于追溯调用顺序与时间分布。
API 名称	明确被调用接口的标识，如“getUserInfo”“createOrder”等，方便区分不同功能接口。
请求参数	客户端向服务器发起请求时携带的参数，以键值对形式呈现，决定 API 的具体操作对象与业务逻辑。
响应状态码	服务器返回的状态代码，如 200（成功）、400（客户端错误）、500（服务器错误）等，反映调用结果。
响应时间	从客户端发送请求到接收到服务器完整响应所耗费的时长，单位通常为毫秒，衡量 API 性能。
调用来源 IP	发起 API 调用请求的客户端所在网络的 IP 地址，可用于安全审计与访问控制。
用户 ID（若有）	当 API 与用户体系关联时，记录发起调用的用户唯一标识，便于追踪用户行为。

时间戳	API 名称	请求参数	响应状态码	响应时间（ms）	调用来源 IP	用户 ID
2024-12-01 10:00:15.123	getProductList	{“category”:“electronics”,“page”:1}	200	120	168.1.100	USER123

说明：此次调用“getProductList”接口，请求获取电子产品分类下第一页产品列表，服务器成功返回，耗时 120 毫秒，调用来源于 IP 为 192.168.1.100 的客户端，对应用户 ID 为 USER123。

时间戳	API 名称	请求参数	响应状态码	响应时间（ms）	调用来源 IP	错误信息
2024-12-01 10:05:30.456	createOrder	{“productId”:789,“quantity”:0}	400	80	168.1.105	“Quantity must be greater than 0”

说明：尝试调用“createOrder”接口创建订单，但因请求参数中商品数量为 0 不符合业务规则，服务器返回 400 错误，响应时间 80 毫秒，调用源 IP 为 192.168.1.105，错误信息提示数量必须大于 0。

统计维度	详情
调用次数趋势	[此处可绘制折线图，横坐标为时间段，纵坐标为调用次数，展示过去一天、一周或一月内 API 调用频率变化]
成功率	[计算成功调用次数与总调用次数的比例，如过去 24 小时成功率为 95%，公式：（成功调用次数÷总调用次数）×100%]
平均响应时间	[算出所有调用响应时间的平均值，如平均响应时间为 150 毫秒]
最常调用 API 排名	[按调用次数从高到低列出前几名 API，如第一名“getUserProfile”调用 5000 次，第二名“queryOrderStatus”调用 3000 次等]