trace_graphs
Creates, updates, deletes, gets or lists a trace_graphs resource.
Overview
| Name | trace_graphs |
| Type | Resource |
| Id | aws.xray.trace_graphs |
Fields
The following fields are returned by SELECT queries:
- get_trace_graph
| Name | Datatype | Description |
|---|---|---|
account_id | string | Identifier of the Amazon Web Services account in which the service runs. |
duration_histogram | array | A histogram that maps the spread of service durations. |
edges | array | Connections to downstream services. |
end_time | string (date-time) | The end time of the last segment that the service generated. |
name | string | The canonical name of the service. |
names | array | A list of names for the service, including the canonical name. |
reference_id | integer | Identifier for the service. Unique within the service map. |
response_time_histogram | array | A histogram that maps the spread of service response times. |
root | boolean | Indicates that the service was the first service to process a request. |
start_time | string (date-time) | The start time of the first segment that the service generated. |
state | string | The service's state. |
summary_statistics | object | Aggregated statistics for the service. |
type | string | The 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:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_trace_graph | select | region | Retrieves 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.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_trace_graph
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
;