58 lines
2.3 KiB
Go
58 lines
2.3 KiB
Go
package common
|
||
|
||
import "context"
|
||
|
||
// DebugLogRecord 渠道调试日志记录（四段报文 + 元数据），经 SubmitDebugLog 钩子异步落库。
|
||
// headers 均已脱敏；body 为原始字节（落库时经 EncodeBody 处理二进制）。
|
||
type DebugLogRecord struct {
|
||
ChannelID int64
|
||
ChannelName string
|
||
ChannelType int
|
||
RequestID string
|
||
TenantID int64
|
||
UserID int64
|
||
ApiKeyID int64
|
||
ModelName string
|
||
UpstreamModel string
|
||
RelayMode string
|
||
InboundPath string
|
||
UpstreamURL string
|
||
IsStream bool
|
||
RetryIndex int
|
||
IsFinal bool
|
||
|
||
UpstreamStatusCode int // 0 = 未发起请求或连接失败（落库为 NULL）
|
||
ClientStatusCode int
|
||
Error string
|
||
|
||
// 四段报文：段1 客户端请求 / 段2 发往上游最终请求 / 段3 上游响应 / 段4 返回客户端响应
|
||
ClientReqHeaders map[string]string
|
||
ClientReqBody []byte
|
||
UpstreamReqHeaders map[string]string
|
||
UpstreamReqBody []byte
|
||
UpstreamRespHeaders map[string]string
|
||
UpstreamRespBody []byte
|
||
ClientRespHeaders map[string]string
|
||
ClientRespBody []byte
|
||
|
||
UpstreamLatencyMs int64
|
||
TotalLatencyMs int64
|
||
FirstTokenMs int64
|
||
|
||
// Conversion 协议转换信息（客户端协议 → 上游协议及转换链），buildRelayInfo 后由 CaptureProtocol 快照
|
||
Conversion *DebugConversion
|
||
}
|
||
|
||
// DebugConversion 协议转换信息：追踪客户端协议经哪些格式转换到上游协议。
|
||
// 段3/段4 的协议无需单独记录——段3 = upstream_format，段4 = client_format（推导关系）。
|
||
type DebugConversion struct {
|
||
ClientFormat string `json:"client_format"` // 客户端原始协议（openai/claude/gemini/responses）
|
||
UpstreamFormat string `json:"upstream_format"` // 发往上游的协议
|
||
Chain []string `json:"chain,omitempty"` // 请求侧转换链（relaykit 填充；为空且两端不同时兜底两端）
|
||
Bridge string `json:"bridge,omitempty"` // 桥接方式：responses_api / responses_direct / pass_through，空=常规转换
|
||
}
|
||
|
||
// SubmitDebugLog 调试日志提交钩子。relay 层不直接依赖 internal/logic（避免反向导入），
|
||
// 由 internal/logic/relay 在进程启动时注入实现；nil（未初始化/单测）时调用方静默丢弃。
|
||
var SubmitDebugLog func(ctx context.Context, record *DebugLogRecord)
|