Span
A span represents a unit of work during AI agent execution, capturing timing, status, and contextual attributes.
Contents
- assistantId
-
UUID of the Connect AI Assistant resource
Type: String
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Required: Yes
- attributes
-
Span-specific contextual attributes
Type: SpanAttributes object
Required: Yes
- endTimestamp
-
Operation end time in milliseconds since epoch
Type: Timestamp
Required: Yes
- requestId
-
The service request ID that initiated the operation
Type: String
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Required: Yes
- sessionId
-
UUID of the Connect AI Session resource
Type: String
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Required: Yes
- spanId
-
Unique span identifier
Type: String
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Required: Yes
- spanName
-
Service-defined operation name
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[a-zA-Z0-9\s_.,-]+.*Required: Yes
- spanType
-
Operation relationship type
Type: String
Valid Values:
CLIENT | SERVER | INTERNALRequired: Yes
- startTimestamp
-
Operation start time in milliseconds since epoch
Type: Timestamp
Required: Yes
- status
-
Span completion status
Type: String
Valid Values:
OK | ERROR | TIMEOUTRequired: Yes
- parentSpanId
-
Parent span identifier for hierarchy. Null for root spans.
Type: String
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
