OpenAI Agents Span

An OpenAI Agents Span is an OpenAI agents operation record that tracks timed operation execution within OpenAI agents traces.

• AKA: OpenAI Agents Operation Span, OpenAI Agents Execution Span, OpenAI Agents Timing Span.
• Context:
  • It can typically record OpenAI Agents Start Time with timestamp precision.
  • It can typically capture OpenAI Agents End Time for duration calculation.
  • It can typically maintain OpenAI Agents Parent ID through span hierarchy links.
  • It can often include OpenAI Agents Span Attributes with operation metadata.
  • It can often track OpenAI Agents Resource Usage via performance metrics.
  • It can often store OpenAI Agents Error Information when execution failures occur.
  • It can often support OpenAI Agents Span Nesting for hierarchical operations.
  • It can range from being a Root OpenAI Agents Span to being a Child OpenAI Agents Span, depending on its hierarchy position.
  • It can range from being a System OpenAI Agents Span to being a Custom OpenAI Agents Span, depending on its creation source.
  • It can range from being a Short-Duration OpenAI Agents Span to being a Long-Duration OpenAI Agents Span, depending on its execution time.
  • It can range from being a Successful OpenAI Agents Span to being a Failed OpenAI Agents Span, depending on its completion status.
  • ...
• Example(s):
  • OpenAI Agents System Spans, such as:
    • OpenAI Agents AgentSpan, which wraps agent execution operations.
    • OpenAI Agents GenerationSpan, which captures LLM generation calls.
    • OpenAI Agents FunctionSpan, which tracks tool call executions.
    • OpenAI Agents GuardrailSpan, which monitors validation checks.
    • OpenAI Agents HandoffSpan, which records agent-to-agent transfers.
  • OpenAI Agents Custom Spans, such as:
    • User-Defined Operation Span for application-specific tracking.
    • Business Logic Span for domain operation monitoring.
    • Integration Point Span for external service calls.
  • OpenAI Agents Span Attributes, such as:
    • Span Duration Metric for performance measurement.
    • Span Status Code for success/failure indication.
    • Span Context Data for operation parameters.
  • ...
• Counter-Example(s):
  • Static Log Entry, which lacks timing relationship data.
  • Event Record, which represents point-in-time occurrences rather than duration operations.
  • Configuration Setting, which defines static parameters rather than execution records.
• See: OpenAI Agents Trace, OpenAI Agents Tracing System, OpenAI Agents AgentSpan, OpenAI Agents GenerationSpan, Distributed Span, OpenTelemetry Span, Execution Timing Record.

---