aws-sdk-xray 1.77.0 → 1.78.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-xray/client.rb +456 -14
- data/lib/aws-sdk-xray/client_api.rb +237 -0
- data/lib/aws-sdk-xray/endpoint_provider.rb +1 -1
- data/lib/aws-sdk-xray/types.rb +461 -5
- data/lib/aws-sdk-xray.rb +1 -1
- data/sig/client.rbs +96 -0
- data/sig/types.rbs +156 -0
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 5ce38f1bc77e0944af62e135fe329ee1db8535ca6ff8b747ee21be3bf79dfccc
|
4
|
+
data.tar.gz: 893333142252bd040a8574a49529e1e425ed6e62f44cc27e18896731b3418085
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 546fbea139661b4d44a6ab98efa40818c2a32f11a909a96fe9bdf47461849879186c10c352e94f99d5e82edc1f94fba21dc08d7ef6c0ebdbf6fb57fa57a34d40
|
7
|
+
data.tar.gz: 3c9495247dbbf042342f663c0fd0450308ad0809f43d9472fd792da07a44d0cfbc43b5e560c06d55dc4571d74eb38bf98aec4e1b73b8be28cf6982f53c37c6be
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,11 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.78.0 (2024-11-21)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - AWS X-Ray introduces Transaction Search APIs, enabling span ingestion into CloudWatch Logs for high-scale trace data indexing. These APIs support span-level queries, trace graph generation, and metric correlation for deeper application insights.
|
8
|
+
|
4
9
|
1.77.0 (2024-10-18)
|
5
10
|
------------------
|
6
11
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.78.0
|
data/lib/aws-sdk-xray/client.rb
CHANGED
@@ -447,6 +447,11 @@ module Aws::XRay
|
|
447
447
|
|
448
448
|
# @!group API Operations
|
449
449
|
|
450
|
+
# <note markdown="1"> You cannot find traces through this API if Transaction Search is
|
451
|
+
# enabled since trace is not indexed in X-Ray.
|
452
|
+
#
|
453
|
+
# </note>
|
454
|
+
#
|
450
455
|
# Retrieves a list of traces specified by ID. Each trace is a collection
|
451
456
|
# of segment documents that originates from a single request. Use
|
452
457
|
# `GetTraceSummaries` to get a list of trace IDs.
|
@@ -494,6 +499,30 @@ module Aws::XRay
|
|
494
499
|
req.send_request(options)
|
495
500
|
end
|
496
501
|
|
502
|
+
# Cancels an ongoing trace retrieval job initiated by
|
503
|
+
# `StartTraceRetrieval` using the provided `RetrievalToken`. A
|
504
|
+
# successful cancellation will return an HTTP 200 response.
|
505
|
+
#
|
506
|
+
# @option params [required, String] :retrieval_token
|
507
|
+
# Retrieval token.
|
508
|
+
#
|
509
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
510
|
+
#
|
511
|
+
# @example Request syntax with placeholder values
|
512
|
+
#
|
513
|
+
# resp = client.cancel_trace_retrieval({
|
514
|
+
# retrieval_token: "RetrievalToken", # required
|
515
|
+
# })
|
516
|
+
#
|
517
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/CancelTraceRetrieval AWS API Documentation
|
518
|
+
#
|
519
|
+
# @overload cancel_trace_retrieval(params = {})
|
520
|
+
# @param [Hash] params ({})
|
521
|
+
def cancel_trace_retrieval(params = {}, options = {})
|
522
|
+
req = build_request(:cancel_trace_retrieval, params)
|
523
|
+
req.send_request(options)
|
524
|
+
end
|
525
|
+
|
497
526
|
# Creates a group resource with a name and a filter expression.
|
498
527
|
#
|
499
528
|
# @option params [required, String] :group_name
|
@@ -878,6 +907,49 @@ module Aws::XRay
|
|
878
907
|
req.send_request(options)
|
879
908
|
end
|
880
909
|
|
910
|
+
# Retrieves all indexing rules.
|
911
|
+
#
|
912
|
+
# Indexing rules are used to determine the server-side sampling rate for
|
913
|
+
# spans ingested through the CloudWatchLogs destination and indexed by
|
914
|
+
# X-Ray. For more information, see [Transaction Search][1].
|
915
|
+
#
|
916
|
+
#
|
917
|
+
#
|
918
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
|
919
|
+
#
|
920
|
+
# @option params [String] :next_token
|
921
|
+
# Specify the pagination token returned by a previous request to
|
922
|
+
# retrieve the next page of indexes.
|
923
|
+
#
|
924
|
+
# @return [Types::GetIndexingRulesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
925
|
+
#
|
926
|
+
# * {Types::GetIndexingRulesResult#indexing_rules #indexing_rules} => Array<Types::IndexingRule>
|
927
|
+
# * {Types::GetIndexingRulesResult#next_token #next_token} => String
|
928
|
+
#
|
929
|
+
# @example Request syntax with placeholder values
|
930
|
+
#
|
931
|
+
# resp = client.get_indexing_rules({
|
932
|
+
# next_token: "String",
|
933
|
+
# })
|
934
|
+
#
|
935
|
+
# @example Response structure
|
936
|
+
#
|
937
|
+
# resp.indexing_rules #=> Array
|
938
|
+
# resp.indexing_rules[0].name #=> String
|
939
|
+
# resp.indexing_rules[0].modified_at #=> Time
|
940
|
+
# resp.indexing_rules[0].rule.probabilistic.desired_sampling_percentage #=> Float
|
941
|
+
# resp.indexing_rules[0].rule.probabilistic.actual_sampling_percentage #=> Float
|
942
|
+
# resp.next_token #=> String
|
943
|
+
#
|
944
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetIndexingRules AWS API Documentation
|
945
|
+
#
|
946
|
+
# @overload get_indexing_rules(params = {})
|
947
|
+
# @param [Hash] params ({})
|
948
|
+
def get_indexing_rules(params = {}, options = {})
|
949
|
+
req = build_request(:get_indexing_rules, params)
|
950
|
+
req.send_request(options)
|
951
|
+
end
|
952
|
+
|
881
953
|
# Retrieves the summary information of an insight. This includes impact
|
882
954
|
# to clients and root cause services, the top anomalous services, the
|
883
955
|
# category, the state of the insight, and the start and end time of the
|
@@ -1149,6 +1221,119 @@ module Aws::XRay
|
|
1149
1221
|
req.send_request(options)
|
1150
1222
|
end
|
1151
1223
|
|
1224
|
+
# Retrieves a service graph for traces based on the specified
|
1225
|
+
# `RetrievalToken` from the CloudWatch log group generated by
|
1226
|
+
# Transaction Search. This API does not initiate a retrieval job. You
|
1227
|
+
# must first execute `StartTraceRetrieval` to obtain the required
|
1228
|
+
# `RetrievalToken`.
|
1229
|
+
#
|
1230
|
+
# The trace graph describes services that process incoming requests and
|
1231
|
+
# any downstream services they call, which may include Amazon Web
|
1232
|
+
# Services resources, external APIs, or databases.
|
1233
|
+
#
|
1234
|
+
# The response is empty until the `RetrievalStatus` is *COMPLETE*. Retry
|
1235
|
+
# the request after the status changes from *RUNNING* or *SCHEDULED* to
|
1236
|
+
# *COMPLETE* to access the full service graph.
|
1237
|
+
#
|
1238
|
+
# When CloudWatch log is the destination, this API can support
|
1239
|
+
# cross-account observability and service graph retrieval across linked
|
1240
|
+
# accounts.
|
1241
|
+
#
|
1242
|
+
# For retrieving graphs from X-Ray directly as opposed to the
|
1243
|
+
# Transaction-Search Log group, see [GetTraceGraph][1].
|
1244
|
+
#
|
1245
|
+
#
|
1246
|
+
#
|
1247
|
+
# [1]: https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html
|
1248
|
+
#
|
1249
|
+
# @option params [required, String] :retrieval_token
|
1250
|
+
# Retrieval token.
|
1251
|
+
#
|
1252
|
+
# @option params [String] :next_token
|
1253
|
+
# Specify the pagination token returned by a previous request to
|
1254
|
+
# retrieve the next page of indexes.
|
1255
|
+
#
|
1256
|
+
# @return [Types::GetRetrievedTracesGraphResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1257
|
+
#
|
1258
|
+
# * {Types::GetRetrievedTracesGraphResult#retrieval_status #retrieval_status} => String
|
1259
|
+
# * {Types::GetRetrievedTracesGraphResult#services #services} => Array<Types::RetrievedService>
|
1260
|
+
# * {Types::GetRetrievedTracesGraphResult#next_token #next_token} => String
|
1261
|
+
#
|
1262
|
+
# @example Request syntax with placeholder values
|
1263
|
+
#
|
1264
|
+
# resp = client.get_retrieved_traces_graph({
|
1265
|
+
# retrieval_token: "RetrievalToken", # required
|
1266
|
+
# next_token: "String",
|
1267
|
+
# })
|
1268
|
+
#
|
1269
|
+
# @example Response structure
|
1270
|
+
#
|
1271
|
+
# resp.retrieval_status #=> String, one of "SCHEDULED", "RUNNING", "COMPLETE", "FAILED", "CANCELLED", "TIMEOUT"
|
1272
|
+
# resp.services #=> Array
|
1273
|
+
# resp.services[0].service.reference_id #=> Integer
|
1274
|
+
# resp.services[0].service.name #=> String
|
1275
|
+
# resp.services[0].service.names #=> Array
|
1276
|
+
# resp.services[0].service.names[0] #=> String
|
1277
|
+
# resp.services[0].service.root #=> Boolean
|
1278
|
+
# resp.services[0].service.account_id #=> String
|
1279
|
+
# resp.services[0].service.type #=> String
|
1280
|
+
# resp.services[0].service.state #=> String
|
1281
|
+
# resp.services[0].service.start_time #=> Time
|
1282
|
+
# resp.services[0].service.end_time #=> Time
|
1283
|
+
# resp.services[0].service.edges #=> Array
|
1284
|
+
# resp.services[0].service.edges[0].reference_id #=> Integer
|
1285
|
+
# resp.services[0].service.edges[0].start_time #=> Time
|
1286
|
+
# resp.services[0].service.edges[0].end_time #=> Time
|
1287
|
+
# resp.services[0].service.edges[0].summary_statistics.ok_count #=> Integer
|
1288
|
+
# resp.services[0].service.edges[0].summary_statistics.error_statistics.throttle_count #=> Integer
|
1289
|
+
# resp.services[0].service.edges[0].summary_statistics.error_statistics.other_count #=> Integer
|
1290
|
+
# resp.services[0].service.edges[0].summary_statistics.error_statistics.total_count #=> Integer
|
1291
|
+
# resp.services[0].service.edges[0].summary_statistics.fault_statistics.other_count #=> Integer
|
1292
|
+
# resp.services[0].service.edges[0].summary_statistics.fault_statistics.total_count #=> Integer
|
1293
|
+
# resp.services[0].service.edges[0].summary_statistics.total_count #=> Integer
|
1294
|
+
# resp.services[0].service.edges[0].summary_statistics.total_response_time #=> Float
|
1295
|
+
# resp.services[0].service.edges[0].response_time_histogram #=> Array
|
1296
|
+
# resp.services[0].service.edges[0].response_time_histogram[0].value #=> Float
|
1297
|
+
# resp.services[0].service.edges[0].response_time_histogram[0].count #=> Integer
|
1298
|
+
# resp.services[0].service.edges[0].aliases #=> Array
|
1299
|
+
# resp.services[0].service.edges[0].aliases[0].name #=> String
|
1300
|
+
# resp.services[0].service.edges[0].aliases[0].names #=> Array
|
1301
|
+
# resp.services[0].service.edges[0].aliases[0].names[0] #=> String
|
1302
|
+
# resp.services[0].service.edges[0].aliases[0].type #=> String
|
1303
|
+
# resp.services[0].service.edges[0].edge_type #=> String
|
1304
|
+
# resp.services[0].service.edges[0].received_event_age_histogram #=> Array
|
1305
|
+
# resp.services[0].service.edges[0].received_event_age_histogram[0].value #=> Float
|
1306
|
+
# resp.services[0].service.edges[0].received_event_age_histogram[0].count #=> Integer
|
1307
|
+
# resp.services[0].service.summary_statistics.ok_count #=> Integer
|
1308
|
+
# resp.services[0].service.summary_statistics.error_statistics.throttle_count #=> Integer
|
1309
|
+
# resp.services[0].service.summary_statistics.error_statistics.other_count #=> Integer
|
1310
|
+
# resp.services[0].service.summary_statistics.error_statistics.total_count #=> Integer
|
1311
|
+
# resp.services[0].service.summary_statistics.fault_statistics.other_count #=> Integer
|
1312
|
+
# resp.services[0].service.summary_statistics.fault_statistics.total_count #=> Integer
|
1313
|
+
# resp.services[0].service.summary_statistics.total_count #=> Integer
|
1314
|
+
# resp.services[0].service.summary_statistics.total_response_time #=> Float
|
1315
|
+
# resp.services[0].service.duration_histogram #=> Array
|
1316
|
+
# resp.services[0].service.duration_histogram[0].value #=> Float
|
1317
|
+
# resp.services[0].service.duration_histogram[0].count #=> Integer
|
1318
|
+
# resp.services[0].service.response_time_histogram #=> Array
|
1319
|
+
# resp.services[0].service.response_time_histogram[0].value #=> Float
|
1320
|
+
# resp.services[0].service.response_time_histogram[0].count #=> Integer
|
1321
|
+
# resp.services[0].links #=> Array
|
1322
|
+
# resp.services[0].links[0].reference_type #=> String
|
1323
|
+
# resp.services[0].links[0].source_trace_id #=> String
|
1324
|
+
# resp.services[0].links[0].destination_trace_ids #=> Array
|
1325
|
+
# resp.services[0].links[0].destination_trace_ids[0] #=> String
|
1326
|
+
# resp.next_token #=> String
|
1327
|
+
#
|
1328
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetRetrievedTracesGraph AWS API Documentation
|
1329
|
+
#
|
1330
|
+
# @overload get_retrieved_traces_graph(params = {})
|
1331
|
+
# @param [Hash] params ({})
|
1332
|
+
def get_retrieved_traces_graph(params = {}, options = {})
|
1333
|
+
req = build_request(:get_retrieved_traces_graph, params)
|
1334
|
+
req.send_request(options)
|
1335
|
+
end
|
1336
|
+
|
1152
1337
|
# Retrieves all sampling rules.
|
1153
1338
|
#
|
1154
1339
|
# @option params [String] :next_token
|
@@ -1571,6 +1756,35 @@ module Aws::XRay
|
|
1571
1756
|
req.send_request(options)
|
1572
1757
|
end
|
1573
1758
|
|
1759
|
+
# Retrieves the current destination of data sent to `PutTraceSegments`
|
1760
|
+
# and *OpenTelemetry* API. The Transaction Search feature requires a
|
1761
|
+
# CloudWatchLogs destination. For more information, see [Transaction
|
1762
|
+
# Search][1] and [OpenTelemetry][2].
|
1763
|
+
#
|
1764
|
+
#
|
1765
|
+
#
|
1766
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
|
1767
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html
|
1768
|
+
#
|
1769
|
+
# @return [Types::GetTraceSegmentDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1770
|
+
#
|
1771
|
+
# * {Types::GetTraceSegmentDestinationResult#destination #destination} => String
|
1772
|
+
# * {Types::GetTraceSegmentDestinationResult#status #status} => String
|
1773
|
+
#
|
1774
|
+
# @example Response structure
|
1775
|
+
#
|
1776
|
+
# resp.destination #=> String, one of "XRay", "CloudWatchLogs"
|
1777
|
+
# resp.status #=> String, one of "PENDING", "ACTIVE"
|
1778
|
+
#
|
1779
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSegmentDestination AWS API Documentation
|
1780
|
+
#
|
1781
|
+
# @overload get_trace_segment_destination(params = {})
|
1782
|
+
# @param [Hash] params ({})
|
1783
|
+
def get_trace_segment_destination(params = {}, options = {})
|
1784
|
+
req = build_request(:get_trace_segment_destination, params)
|
1785
|
+
req.send_request(options)
|
1786
|
+
end
|
1787
|
+
|
1574
1788
|
# Retrieves IDs and annotations for traces available for a specified
|
1575
1789
|
# time frame using an optional filter. To get the full traces, pass the
|
1576
1790
|
# trace IDs to `BatchGetTraces`.
|
@@ -1588,12 +1802,12 @@ module Aws::XRay
|
|
1588
1802
|
# `annotation.account = "12345"`
|
1589
1803
|
#
|
1590
1804
|
# For a full list of indexed fields and keywords that you can use in
|
1591
|
-
# filter expressions, see [
|
1592
|
-
#
|
1805
|
+
# filter expressions, see [Use filter expressions][1] in the *Amazon Web
|
1806
|
+
# Services X-Ray Developer Guide*.
|
1593
1807
|
#
|
1594
1808
|
#
|
1595
1809
|
#
|
1596
|
-
# [1]: https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters
|
1810
|
+
# [1]: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-filters
|
1597
1811
|
#
|
1598
1812
|
# @option params [required, Time,DateTime,Date,Integer,String] :start_time
|
1599
1813
|
# The start of the time frame for which to retrieve traces.
|
@@ -1602,8 +1816,8 @@ module Aws::XRay
|
|
1602
1816
|
# The end of the time frame for which to retrieve traces.
|
1603
1817
|
#
|
1604
1818
|
# @option params [String] :time_range_type
|
1605
|
-
#
|
1606
|
-
#
|
1819
|
+
# Query trace summaries by TraceId (trace start time), Event (trace
|
1820
|
+
# update time), or Service (trace segment end time).
|
1607
1821
|
#
|
1608
1822
|
# @option params [Boolean] :sampling
|
1609
1823
|
# Set to `true` to get summaries for only a subset of available traces.
|
@@ -1791,6 +2005,77 @@ module Aws::XRay
|
|
1791
2005
|
req.send_request(options)
|
1792
2006
|
end
|
1793
2007
|
|
2008
|
+
# Retrieves a list of traces for a given `RetrievalToken` from the
|
2009
|
+
# CloudWatch log group generated by Transaction Search. For information
|
2010
|
+
# on what each trace returns, see [BatchGetTraces][1].
|
2011
|
+
#
|
2012
|
+
# This API does not initiate a retrieval job. To start a trace
|
2013
|
+
# retrieval, use `StartTraceRetrieval`, which generates the required
|
2014
|
+
# `RetrievalToken`.
|
2015
|
+
#
|
2016
|
+
# When the `RetrievalStatus` is not *COMPLETE*, the API will return an
|
2017
|
+
# empty response. Retry the request once the retrieval has completed to
|
2018
|
+
# access the full list of traces.
|
2019
|
+
#
|
2020
|
+
# For cross-account observability, this API can retrieve traces from
|
2021
|
+
# linked accounts when CloudWatch log is the destination across relevant
|
2022
|
+
# accounts. For more details, see [CloudWatch cross-account
|
2023
|
+
# observability][2].
|
2024
|
+
#
|
2025
|
+
# For retrieving data from X-Ray directly as opposed to the
|
2026
|
+
# Transaction-Search Log group, see [BatchGetTraces][1].
|
2027
|
+
#
|
2028
|
+
#
|
2029
|
+
#
|
2030
|
+
# [1]: https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html
|
2031
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
|
2032
|
+
#
|
2033
|
+
# @option params [required, String] :retrieval_token
|
2034
|
+
# Retrieval token.
|
2035
|
+
#
|
2036
|
+
# @option params [String] :trace_format
|
2037
|
+
# Format of the requested traces.
|
2038
|
+
#
|
2039
|
+
# @option params [String] :next_token
|
2040
|
+
# Specify the pagination token returned by a previous request to
|
2041
|
+
# retrieve the next page of indexes.
|
2042
|
+
#
|
2043
|
+
# @return [Types::ListRetrievedTracesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2044
|
+
#
|
2045
|
+
# * {Types::ListRetrievedTracesResult#retrieval_status #retrieval_status} => String
|
2046
|
+
# * {Types::ListRetrievedTracesResult#trace_format #trace_format} => String
|
2047
|
+
# * {Types::ListRetrievedTracesResult#traces #traces} => Array<Types::RetrievedTrace>
|
2048
|
+
# * {Types::ListRetrievedTracesResult#next_token #next_token} => String
|
2049
|
+
#
|
2050
|
+
# @example Request syntax with placeholder values
|
2051
|
+
#
|
2052
|
+
# resp = client.list_retrieved_traces({
|
2053
|
+
# retrieval_token: "RetrievalToken", # required
|
2054
|
+
# trace_format: "XRAY", # accepts XRAY, OTEL
|
2055
|
+
# next_token: "String",
|
2056
|
+
# })
|
2057
|
+
#
|
2058
|
+
# @example Response structure
|
2059
|
+
#
|
2060
|
+
# resp.retrieval_status #=> String, one of "SCHEDULED", "RUNNING", "COMPLETE", "FAILED", "CANCELLED", "TIMEOUT"
|
2061
|
+
# resp.trace_format #=> String, one of "XRAY", "OTEL"
|
2062
|
+
# resp.traces #=> Array
|
2063
|
+
# resp.traces[0].id #=> String
|
2064
|
+
# resp.traces[0].duration #=> Float
|
2065
|
+
# resp.traces[0].spans #=> Array
|
2066
|
+
# resp.traces[0].spans[0].id #=> String
|
2067
|
+
# resp.traces[0].spans[0].document #=> String
|
2068
|
+
# resp.next_token #=> String
|
2069
|
+
#
|
2070
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/ListRetrievedTraces AWS API Documentation
|
2071
|
+
#
|
2072
|
+
# @overload list_retrieved_traces(params = {})
|
2073
|
+
# @param [Hash] params ({})
|
2074
|
+
def list_retrieved_traces(params = {}, options = {})
|
2075
|
+
req = build_request(:list_retrieved_traces, params)
|
2076
|
+
req.send_request(options)
|
2077
|
+
end
|
2078
|
+
|
1794
2079
|
# Returns a list of tags that are applied to the specified Amazon Web
|
1795
2080
|
# Services X-Ray group or sampling rule.
|
1796
2081
|
#
|
@@ -1995,13 +2280,12 @@ module Aws::XRay
|
|
1995
2280
|
req.send_request(options)
|
1996
2281
|
end
|
1997
2282
|
|
1998
|
-
# Uploads segment documents to Amazon Web Services X-Ray.
|
1999
|
-
#
|
2000
|
-
#
|
2001
|
-
# completed segment, an in-progress segment, or an array of subsegments.
|
2283
|
+
# Uploads segment documents to Amazon Web Services X-Ray. A segment
|
2284
|
+
# document can be a completed segment, an in-progress segment, or an
|
2285
|
+
# array of subsegments.
|
2002
2286
|
#
|
2003
2287
|
# Segments must include the following fields. For the full segment
|
2004
|
-
# document schema, see [Amazon Web Services X-Ray Segment Documents][
|
2288
|
+
# document schema, see [Amazon Web Services X-Ray Segment Documents][1]
|
2005
2289
|
# in the *Amazon Web Services X-Ray Developer Guide*.
|
2006
2290
|
#
|
2007
2291
|
# **Required segment document fields**
|
@@ -2030,7 +2314,9 @@ module Aws::XRay
|
|
2030
2314
|
# overwrite the in-progress segment.
|
2031
2315
|
#
|
2032
2316
|
# A `trace_id` consists of three numbers separated by hyphens. For
|
2033
|
-
# example, 1-58406520-a006649127e371903a2de979.
|
2317
|
+
# example, 1-58406520-a006649127e371903a2de979. For trace IDs created by
|
2318
|
+
# an X-Ray SDK, or by Amazon Web Services services integrated with
|
2319
|
+
# X-Ray, a trace ID includes:
|
2034
2320
|
#
|
2035
2321
|
# **Trace ID Format**
|
2036
2322
|
#
|
@@ -2043,10 +2329,20 @@ module Aws::XRay
|
|
2043
2329
|
# * A 96-bit identifier for the trace, globally unique, in 24
|
2044
2330
|
# hexadecimal digits.
|
2045
2331
|
#
|
2332
|
+
# <note markdown="1"> Trace IDs created via OpenTelemetry have a different format based on
|
2333
|
+
# the [W3C Trace Context specification][2]. A W3C trace ID must be
|
2334
|
+
# formatted in the X-Ray trace ID format when sending to X-Ray. For
|
2335
|
+
# example, a W3C trace ID `4efaaf4d1e8720b39541901950019ee5` should be
|
2336
|
+
# formatted as `1-4efaaf4d-1e8720b39541901950019ee5` when sending to
|
2337
|
+
# X-Ray. While X-Ray trace IDs include the original request timestamp in
|
2338
|
+
# Unix epoch time, this is not required or validated.
|
2339
|
+
#
|
2340
|
+
# </note>
|
2046
2341
|
#
|
2047
2342
|
#
|
2048
|
-
#
|
2049
|
-
# [
|
2343
|
+
#
|
2344
|
+
# [1]: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-api.html#xray-api-segmentdocuments.html
|
2345
|
+
# [2]: https://www.w3.org/TR/trace-context/
|
2050
2346
|
#
|
2051
2347
|
# @option params [required, Array<String>] :trace_segment_documents
|
2052
2348
|
# A string containing a JSON document defining one or more segments or
|
@@ -2078,6 +2374,69 @@ module Aws::XRay
|
|
2078
2374
|
req.send_request(options)
|
2079
2375
|
end
|
2080
2376
|
|
2377
|
+
# Initiates a trace retrieval process using the specified time range and
|
2378
|
+
# for the give trace IDs on Transaction Search generated by the
|
2379
|
+
# CloudWatch log group. For more information, see [Transaction
|
2380
|
+
# Search][1].
|
2381
|
+
#
|
2382
|
+
# API returns a `RetrievalToken`, which can be used with
|
2383
|
+
# `ListRetrievedTraces` or `GetRetrievedTracesGraph` to fetch results.
|
2384
|
+
# Retrievals will time out after 60 minutes. To execute long time
|
2385
|
+
# ranges, consider segmenting into multiple retrievals.
|
2386
|
+
#
|
2387
|
+
# If you are using [CloudWatch cross-account observability][2], you can
|
2388
|
+
# use this operation in a monitoring account to retrieve data from a
|
2389
|
+
# linked source account, as long as both accounts have transaction
|
2390
|
+
# search enabled.
|
2391
|
+
#
|
2392
|
+
# For retrieving data from X-Ray directly as opposed to the
|
2393
|
+
# Transaction-Search Log group, see [BatchGetTraces][3].
|
2394
|
+
#
|
2395
|
+
#
|
2396
|
+
#
|
2397
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
|
2398
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
|
2399
|
+
# [3]: https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html
|
2400
|
+
#
|
2401
|
+
# @option params [required, Array<String>] :trace_ids
|
2402
|
+
# Specify the trace IDs of the traces to be retrieved.
|
2403
|
+
#
|
2404
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :start_time
|
2405
|
+
# The start of the time range to retrieve traces. The range is
|
2406
|
+
# inclusive, so the specified start time is included in the query.
|
2407
|
+
# Specified as epoch time, the number of seconds since January 1, 1970,
|
2408
|
+
# 00:00:00 UTC.
|
2409
|
+
#
|
2410
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :end_time
|
2411
|
+
# The end of the time range to retrieve traces. The range is inclusive,
|
2412
|
+
# so the specified end time is included in the query. Specified as epoch
|
2413
|
+
# time, the number of seconds since January 1, 1970, 00:00:00 UTC.
|
2414
|
+
#
|
2415
|
+
# @return [Types::StartTraceRetrievalResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2416
|
+
#
|
2417
|
+
# * {Types::StartTraceRetrievalResult#retrieval_token #retrieval_token} => String
|
2418
|
+
#
|
2419
|
+
# @example Request syntax with placeholder values
|
2420
|
+
#
|
2421
|
+
# resp = client.start_trace_retrieval({
|
2422
|
+
# trace_ids: ["TraceId"], # required
|
2423
|
+
# start_time: Time.now, # required
|
2424
|
+
# end_time: Time.now, # required
|
2425
|
+
# })
|
2426
|
+
#
|
2427
|
+
# @example Response structure
|
2428
|
+
#
|
2429
|
+
# resp.retrieval_token #=> String
|
2430
|
+
#
|
2431
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/StartTraceRetrieval AWS API Documentation
|
2432
|
+
#
|
2433
|
+
# @overload start_trace_retrieval(params = {})
|
2434
|
+
# @param [Hash] params ({})
|
2435
|
+
def start_trace_retrieval(params = {}, options = {})
|
2436
|
+
req = build_request(:start_trace_retrieval, params)
|
2437
|
+
req.send_request(options)
|
2438
|
+
end
|
2439
|
+
|
2081
2440
|
# Applies tags to an existing Amazon Web Services X-Ray group or
|
2082
2441
|
# sampling rule.
|
2083
2442
|
#
|
@@ -2216,6 +2575,53 @@ module Aws::XRay
|
|
2216
2575
|
req.send_request(options)
|
2217
2576
|
end
|
2218
2577
|
|
2578
|
+
# Modifies an indexing rule’s configuration.
|
2579
|
+
#
|
2580
|
+
# Indexing rules are used for determining the sampling rate for spans
|
2581
|
+
# indexed from CloudWatch Logs. For more information, see [Transaction
|
2582
|
+
# Search][1].
|
2583
|
+
#
|
2584
|
+
#
|
2585
|
+
#
|
2586
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
|
2587
|
+
#
|
2588
|
+
# @option params [required, String] :name
|
2589
|
+
# Name of the indexing rule to be updated.
|
2590
|
+
#
|
2591
|
+
# @option params [required, Types::IndexingRuleValueUpdate] :rule
|
2592
|
+
# Rule configuration to be updated.
|
2593
|
+
#
|
2594
|
+
# @return [Types::UpdateIndexingRuleResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2595
|
+
#
|
2596
|
+
# * {Types::UpdateIndexingRuleResult#indexing_rule #indexing_rule} => Types::IndexingRule
|
2597
|
+
#
|
2598
|
+
# @example Request syntax with placeholder values
|
2599
|
+
#
|
2600
|
+
# resp = client.update_indexing_rule({
|
2601
|
+
# name: "String", # required
|
2602
|
+
# rule: { # required
|
2603
|
+
# probabilistic: {
|
2604
|
+
# desired_sampling_percentage: 1.0, # required
|
2605
|
+
# },
|
2606
|
+
# },
|
2607
|
+
# })
|
2608
|
+
#
|
2609
|
+
# @example Response structure
|
2610
|
+
#
|
2611
|
+
# resp.indexing_rule.name #=> String
|
2612
|
+
# resp.indexing_rule.modified_at #=> Time
|
2613
|
+
# resp.indexing_rule.rule.probabilistic.desired_sampling_percentage #=> Float
|
2614
|
+
# resp.indexing_rule.rule.probabilistic.actual_sampling_percentage #=> Float
|
2615
|
+
#
|
2616
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateIndexingRule AWS API Documentation
|
2617
|
+
#
|
2618
|
+
# @overload update_indexing_rule(params = {})
|
2619
|
+
# @param [Hash] params ({})
|
2620
|
+
def update_indexing_rule(params = {}, options = {})
|
2621
|
+
req = build_request(:update_indexing_rule, params)
|
2622
|
+
req.send_request(options)
|
2623
|
+
end
|
2624
|
+
|
2219
2625
|
# Modifies a sampling rule's configuration.
|
2220
2626
|
#
|
2221
2627
|
# @option params [required, Types::SamplingRuleUpdate] :sampling_rule_update
|
@@ -2274,6 +2680,42 @@ module Aws::XRay
|
|
2274
2680
|
req.send_request(options)
|
2275
2681
|
end
|
2276
2682
|
|
2683
|
+
# Modifies the destination of data sent to `PutTraceSegments`. The
|
2684
|
+
# Transaction Search feature requires the CloudWatchLogs destination.
|
2685
|
+
# For more information, see [Transaction Search][1].
|
2686
|
+
#
|
2687
|
+
#
|
2688
|
+
#
|
2689
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
|
2690
|
+
#
|
2691
|
+
# @option params [String] :destination
|
2692
|
+
# The configured destination of trace segments.
|
2693
|
+
#
|
2694
|
+
# @return [Types::UpdateTraceSegmentDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2695
|
+
#
|
2696
|
+
# * {Types::UpdateTraceSegmentDestinationResult#destination #destination} => String
|
2697
|
+
# * {Types::UpdateTraceSegmentDestinationResult#status #status} => String
|
2698
|
+
#
|
2699
|
+
# @example Request syntax with placeholder values
|
2700
|
+
#
|
2701
|
+
# resp = client.update_trace_segment_destination({
|
2702
|
+
# destination: "XRay", # accepts XRay, CloudWatchLogs
|
2703
|
+
# })
|
2704
|
+
#
|
2705
|
+
# @example Response structure
|
2706
|
+
#
|
2707
|
+
# resp.destination #=> String, one of "XRay", "CloudWatchLogs"
|
2708
|
+
# resp.status #=> String, one of "PENDING", "ACTIVE"
|
2709
|
+
#
|
2710
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateTraceSegmentDestination AWS API Documentation
|
2711
|
+
#
|
2712
|
+
# @overload update_trace_segment_destination(params = {})
|
2713
|
+
# @param [Hash] params ({})
|
2714
|
+
def update_trace_segment_destination(params = {}, options = {})
|
2715
|
+
req = build_request(:update_trace_segment_destination, params)
|
2716
|
+
req.send_request(options)
|
2717
|
+
end
|
2718
|
+
|
2277
2719
|
# @!endgroup
|
2278
2720
|
|
2279
2721
|
# @param params ({})
|
@@ -2292,7 +2734,7 @@ module Aws::XRay
|
|
2292
2734
|
tracer: tracer
|
2293
2735
|
)
|
2294
2736
|
context[:gem_name] = 'aws-sdk-xray'
|
2295
|
-
context[:gem_version] = '1.
|
2737
|
+
context[:gem_version] = '1.78.0'
|
2296
2738
|
Seahorse::Client::Request.new(handlers, context)
|
2297
2739
|
end
|
2298
2740
|
|