Xray Trace Summary Structure
Metadata generated from the segment documents in a trace.
TraceSummary is a JSON Structure definition published by Amazon X-Ray, describing 20 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"type": "object",
"properties": {
"Id": {
"allOf": [
{
"$ref": "#/components/schemas/TraceId"
},
{
"description": "The unique identifier for the request that generated the trace's segments and subsegments."
}
]
},
"Duration": {
"allOf": [
{
"$ref": "#/components/schemas/NullableDouble"
},
{
"description": "The length of time in seconds between the start time of the root segment and the end time of the last segment that completed."
}
]
},
"ResponseTime": {
"allOf": [
{
"$ref": "#/components/schemas/NullableDouble"
},
{
"description": "The length of time in seconds between the start and end times of the root segment. If the service performs work asynchronously, the response time measures the time before the response is sent to the user, while the duration measures the amount of time before the last traced activity completes."
}
]
},
"HasFault": {
"allOf": [
{
"$ref": "#/components/schemas/NullableBoolean"
},
{
"description": "The root segment document has a 500 series error."
}
]
},
"HasError": {
"allOf": [
{
"$ref": "#/components/schemas/NullableBoolean"
},
{
"description": "The root segment document has a 400 series error."
}
]
},
"HasThrottle": {
"allOf": [
{
"$ref": "#/components/schemas/NullableBoolean"
},
{
"description": "One or more of the segment documents has a 429 throttling error."
}
]
},
"IsPartial": {
"allOf": [
{
"$ref": "#/components/schemas/NullableBoolean"
},
{
"description": "One or more of the segment documents is in progress."
}
]
},
"Http": {
"allOf": [
{
"$ref": "#/components/schemas/Http"
},
{
"description": "Information about the HTTP request served by the trace."
}
]
},
"Annotations": {
"allOf": [
{
"$ref": "#/components/schemas/Annotations"
},
{
"description": "Annotations from the trace's segment documents."
}
]
},
"Users": {
"allOf": [
{
"$ref": "#/components/schemas/TraceUsers"
},
{
"description": "Users from the trace's segment documents."
}
]
},
"ServiceIds": {
"allOf": [
{
"$ref": "#/components/schemas/ServiceIds"
},
{
"description": "Service IDs from the trace's segment documents."
}
]
},
"ResourceARNs": {
"allOf": [
{
"$ref": "#/components/schemas/TraceResourceARNs"
},
{
"description": "A list of resource ARNs for any resource corresponding to the trace segments."
}
]
},
"InstanceIds": {
"allOf": [
{
"$ref": "#/components/schemas/TraceInstanceIds"
},
{
"description": "A list of EC2 instance IDs for any instance corresponding to the trace segments."
}
]
},
"AvailabilityZones": {
"allOf": [
{
"$ref": "#/components/schemas/TraceAvailabilityZones"
},
{
"description": "A list of Availability Zones for any zone corresponding to the trace segments."
}
]
},
"EntryPoint": {
"allOf": [
{
"$ref": "#/components/schemas/ServiceId"
},
{
"description": "The root of a trace."
}
]
},
"FaultRootCauses": {
"allOf": [
{
"$ref": "#/components/schemas/FaultRootCauses"
},
{
"description": "A collection of FaultRootCause structures corresponding to the trace segments."
}
]
},
"ErrorRootCauses": {
"allOf": [
{
"$ref": "#/components/schemas/ErrorRootCauses"
},
{
"description": "A collection of ErrorRootCause structures corresponding to the trace segments."
}
]
},
"ResponseTimeRootCauses": {
"allOf": [
{
"$ref": "#/components/schemas/ResponseTimeRootCauses"
},
{
"description": "A collection of ResponseTimeRootCause structures corresponding to the trace segments."
}
]
},
"Revision": {
"allOf": [
{
"$ref": "#/components/schemas/Integer"
},
{
"description": "The revision number of a trace."
}
]
},
"MatchedEventTime": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": "The matched time stamp of a defined event."
}
]
}
},
"description": "Metadata generated from the segment documents in a trace.",
"$schema": "https://json-structure.org/meta/core/v0/#",
"name": "TraceSummary",
"$id": "https://raw.githubusercontent.com/api-evangelist/amazon-xray/refs/heads/main/json-structure/xray-trace-summary-structure.json"
}
Work with this as data
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-structures/xray-trace-summary-structure"
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.