trace_segment_destinations
Creates, updates, deletes, gets or lists a trace_segment_destinations resource.
Overview
| Name | trace_segment_destinations |
| Type | Resource |
| Id | aws.xray.trace_segment_destinations |
Fields
The following fields are returned by SELECT queries:
- get_trace_segment_destination
| Name | Datatype | Description |
|---|---|---|
destination | string | Retrieves the current destination. (XRay, CloudWatchLogs) |
status | string | Status of the retrieval. (PENDING, ACTIVE) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_trace_segment_destination | select | region | Retrieves the current destination of data sent to PutTraceSegments and OpenTelemetry protocol (OTLP) endpoint. The Transaction Search feature requires a CloudWatchLogs destination. For more information, see Transaction Search and OpenTelemetry. | |
update_trace_segment_destination | update | region | Modifies the destination of data sent to PutTraceSegments. The Transaction Search feature requires the CloudWatchLogs destination. For more information, see Transaction Search. |
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_segment_destination
Retrieves the current destination of data sent to PutTraceSegments and OpenTelemetry protocol (OTLP) endpoint. The Transaction Search feature requires a CloudWatchLogs destination. For more information, see Transaction Search and OpenTelemetry.
SELECT
destination,
status
FROM aws.xray.trace_segment_destinations
WHERE region = '{{ region }}' -- required
;
UPDATE examples
- update_trace_segment_destination
Modifies the destination of data sent to PutTraceSegments. The Transaction Search feature requires the CloudWatchLogs destination. For more information, see Transaction Search.
UPDATE aws.xray.trace_segment_destinations
SET
Destination = '{{ Destination }}'
WHERE
region = '{{ region }}' --required
RETURNING
destination,
status;