在分布式系统中关联「业务请求 ↔ 网关调用 ↔ 工单排障」。
建议发送的请求头
| 请求头 | 说明 | 限制 |
|---|---|---|
x-trace-id | 业务追踪 ID（UUID、雪花 ID 等） | 截断至 256 字符 |
x-user-id | 你们产品中的用户 ID | 512 字符 |
x-agent-name | 调用方 Agent / 服务名 | 512 字符 |
示例：
curl -sS "https://51kik.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "x-trace-id: order-2024-0001" \
-H "x-user-id: user_abc" \
-H "x-agent-name: billing-bot" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"hi"}]}'
网关将这些信息写入用量记录，供控制台查询（具体 UI 以产品为准）。
Anthropic 面
同样支持上述请求头。Anthropic API 的错误响应另含 request_id：
{ "request_id": "req_..." }
请与 x-trace-id 一并提供给支持团队。
日志建议
在业务服务日志中打印：
trace_id=order-2024-0001 gateway_status=200 model=vendor/model latency_ms=1234
不要记录完整 API Key 或用户消息正文（除非合规允许且已脱敏）。