Documentation
¶
Overview ¶
Package tracecapture provides bounded, side-effect-free trace capture leaves shared by Generic API and LLM request recorders.
Index ¶
- Constants
- func PolicyFromToken(enabled bool, rawMode string, maxBodyBytes int) (apiattempt.APITracePolicy, bool)
- func RedactHeaders(source http.Header, dynamicSensitiveNames ...string) (http.Header, bool)
- type BodyCaptureDecision
- type BodyWindow
- func (window *BodyWindow) Bytes() []byte
- func (window *BodyWindow) Capture(decision BodyCaptureDecision) apiattempt.APIBodyCapture
- func (window *BodyWindow) Len() int
- func (window *BodyWindow) Limit() int
- func (window *BodyWindow) MarkReadFailed()
- func (window *BodyWindow) Reset()
- func (window *BodyWindow) String() string
- func (window *BodyWindow) Text() bool
- func (window *BodyWindow) TotalBytes() int64
- func (window *BodyWindow) TotalSeen() int64
- func (window *BodyWindow) Truncated() bool
- func (window *BodyWindow) Write(value []byte) (int, error)
- func (window *BodyWindow) WriteString(value string) (int, error)
Constants ¶
View Source
const ( ReasonTraceHeadersOnly = "trace_headers_only" ReasonContentEncoded = "content_encoded" ReasonMultipart = "multipart" ReasonBinaryContentType = "binary_content_type" ReasonBinaryDetected = "binary_detected" ReasonWebSocket = "websocket" ReasonCaptureReadFailed = "capture_read_failed" )
View Source
const ( RedactedValue = "***" MaxHeaderFields = 64 MaxHeaderValues = 8 MaxHeaderNameBytes = 256 MaxHeaderValueBytes = 1024 MaxHeadersBytes = 32 * 1024 )
View Source
const DefaultBodyWindowBytes = 64 * 1024
Variables ¶
This section is empty.
Functions ¶
func PolicyFromToken ¶
func PolicyFromToken(enabled bool, rawMode string, maxBodyBytes int) (apiattempt.APITracePolicy, bool)
PolicyFromToken applies the shared runtime semantics: disabled is off, legacy empty is full, headers is headers, and unknown modes fail open to full capture while reporting unknown=true to the caller.
Types ¶
type BodyCaptureDecision ¶
func DecideBody ¶
func DecideBody(protocol, contentType, contentEncoding string, textBody bool) BodyCaptureDecision
DecideBody returns whether a completed bounded body window is safe to persist. It never decodes content encodings or serializes opaque bytes.
type BodyWindow ¶
type BodyWindow struct {
// contains filtered or unexported fields
}
BodyWindow is a fixed-capacity streaming tail. Write always acknowledges the original byte count, so capture cannot change the surrounding I/O contract.
func NewBodyWindow ¶
func NewBodyWindow(limit int) *BodyWindow
func (*BodyWindow) Bytes ¶
func (window *BodyWindow) Bytes() []byte
func (*BodyWindow) Capture ¶
func (window *BodyWindow) Capture(decision BodyCaptureDecision) apiattempt.APIBodyCapture
func (*BodyWindow) Len ¶
func (window *BodyWindow) Len() int
func (*BodyWindow) Limit ¶
func (window *BodyWindow) Limit() int
func (*BodyWindow) MarkReadFailed ¶
func (window *BodyWindow) MarkReadFailed()
func (*BodyWindow) Reset ¶
func (window *BodyWindow) Reset()
func (*BodyWindow) String ¶
func (window *BodyWindow) String() string
func (*BodyWindow) Text ¶
func (window *BodyWindow) Text() bool
func (*BodyWindow) TotalBytes ¶
func (window *BodyWindow) TotalBytes() int64
func (*BodyWindow) TotalSeen ¶
func (window *BodyWindow) TotalSeen() int64
func (*BodyWindow) Truncated ¶
func (window *BodyWindow) Truncated() bool
func (*BodyWindow) WriteString ¶
func (window *BodyWindow) WriteString(value string) (int, error)
Click to show internal directories.
Click to hide internal directories.