Skip to main content

trace_graphs

Creates, updates, deletes, gets or lists a trace_graphs resource.

Overview

Nametrace_graphs
TypeResource
Idaws.xray.trace_graphs

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
account_idstringIdentifier of the Amazon Web Services account in which the service runs.
duration_histogramarrayA histogram that maps the spread of service durations.
edgesarrayConnections to downstream services.
end_timestring (date-time)The end time of the last segment that the service generated.
namestringThe canonical name of the service.
namesarrayA list of names for the service, including the canonical name.
reference_idintegerIdentifier for the service. Unique within the service map.
response_time_histogramarrayA histogram that maps the spread of service response times.
rootbooleanIndicates that the service was the first service to process a request.
start_timestring (date-time)The start time of the first segment that the service generated.
statestringThe service's state.
summary_statisticsobjectAggregated statistics for the service.
typestringThe type of service. Amazon Web Services Resource - The type of an Amazon Web Services resource. For example, AWS::EC2::Instance for an application running on Amazon EC2 or AWS::DynamoDB::Table for an Amazon DynamoDB table that the application used. Amazon Web Services Service - The type of an Amazon Web Services service. For example, AWS::DynamoDB for downstream calls to Amazon DynamoDB that didn't target a specific table. client - Represents the clients that sent requests to a root service. remote - A downstream service of indeterminate type.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_trace_graphselectregionRetrieves a service graph for one or more specific trace IDs.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)

SELECT examples

Retrieves a service graph for one or more specific trace IDs.

SELECT
account_id,
duration_histogram,
edges,
end_time,
name,
names,
reference_id,
response_time_histogram,
root,
start_time,
state,
summary_statistics,
type
FROM aws.xray.trace_graphs
WHERE region = '{{ region }}' -- required
;