Skip to main content

trace_segment_destinations

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

Overview​

Nametrace_segment_destinations
TypeResource
Idaws.xray.trace_segment_destinations

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
destinationstringRetrieves the current destination. (XRay, CloudWatchLogs)
statusstringStatus of the retrieval. (PENDING, ACTIVE)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_trace_segment_destinationselectregionRetrieves 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_destinationupdateregionModifies 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.

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

SELECT examples​

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​

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;