Create Span Batch - Galtea Docs

Returns

Returns a list of Span objects.

Example

galtea.spans.create_batch(
    [
        SpanBase(
            trace_id=trace_id,
            name="batch_span_1",
            type=SpanType.SPAN,
        )
    ]
)

Parameters

list[SpanBase]

required

List of span objects to create. Each span should include trace_id, name, and optionally other fields.

SpanBase Fields

Field	Type	Required	Description
`trace_id`	`str`	Yes	ID of the trace this span belongs to
`name`	`str`	Yes	Name of the traced operation
`id`	`str`	No	Client-generated ID (auto-generated if not provided)
`type`	`SpanType`	No	Type: SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL. See Span Types
`parent_trace_id`	`str`	No	ID of parent span
`input_data`	`dict`	No	Input parameters
`output_data`	`dict`	No	Output result
`error`	`str`	No	Error message if failed
`latency_ms`	`float`	No	Execution time in milliseconds
`start_time`	`str`	No	ISO 8601 timestamp when the span started
`end_time`	`str`	No	ISO 8601 timestamp when the span ended
`metadata`	`dict`	No	Additional custom metadata

For type, other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.