Module trace_ingest 

Structs

TraceBatchColumnObservation 🔒

The schema and value types observed for one column in one chunk.

TraceChunkIngestContext 🔒

Shared dependencies and request metadata used while ingesting trace chunks.

TraceChunkRetry 🔒

Sparse representation retained for a v1 trace chunk.

TraceColumnRequestSchema 🔒

Per-column observations and the resolved target type for a trace request.

TraceFailureEntry 🔒

TraceFailureMessages 🔒

Bounded, deduplicated failure details for one trace request.

TraceIngestState 🔒

Accumulates trace outcomes, auxiliary rows, and bounded failure details.

TraceRequestSchema 🔒

Request-wide schema observations collected across all v1 trace chunks.

TraceRetryRow 🔒

The projected retry values and identifying metadata for one span.

TraceRetryValue 🔒

One retry cell and the logical type to restore before insertion.

TraceSpanMetadata 🔒

Span identity and operation fields retained after request conversion.

TraceTablePreAlter 🔒

Table columns to add or widen before inserting the prepared chunks.

Enums

ChunkFailureReaction 🔒

Determines how trace ingestion responds to a failure before a write is dispatched.

TraceChunkSchemaState 🔒

How a v1 chunk should be reconciled when it is written.

TraceRequestSchemaPlan 🔒

Either a ready table-alter plan or the observations that cannot be unified.

TraceRetrySchemaType 🔒

The scalar or binary logical type recorded for a retry value.

Constants

TRACE_FAILURE_CAUSE_LIMIT 🔒

Maximum characters of a failure cause echoed to the client and the log.

TRACE_FAILURE_MESSAGE_LIMIT 🔒

Functions

chunk_owned 🔒

trace_conventions 🔒

Derives trace.conventions from the request’s resource/scope schema_urls. A single distinct non-empty value is concrete; multiple distinct values are mixed; none is unknown. schema_url is row-level in OTLP, so the table-level value is best-effort per the RFC conflict rule.

trace_logical_types_incompatible 🔒

wrap_trace_alter_failure 🔒

Preserve the original alter failure status so chunk retry behavior stays correct.

Type Aliases

TraceSchemaExclusions 🔒

Maps incompatible columns to the chunk indexes that must use fallback.