@aws-sdk/client-xray 3.876.0 → 3.879.0

package/dist-cjs/index.js

@@ -837,6 +837,7 @@ var se_GetSamplingTargetsCommand = /* @__PURE__ */ __name(async (input, context)
   let body;
   body = JSON.stringify(
     (0, import_smithy_client.take)(input, {
+      SamplingBoostStatisticsDocuments: /* @__PURE__ */ __name((_) => se_SamplingBoostStatisticsDocumentList(_, context), "SamplingBoostStatisticsDocuments"),
       SamplingStatisticsDocuments: /* @__PURE__ */ __name((_) => se_SamplingStatisticsDocumentList(_, context), "SamplingStatisticsDocuments")
     })
   );
@@ -1424,6 +1425,7 @@ var de_GetSamplingTargetsCommand = /* @__PURE__ */ __name(async (output, context
   const doc = (0, import_smithy_client.take)(data, {
     LastRuleModification: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "LastRuleModification"),
     SamplingTargetDocuments: /* @__PURE__ */ __name((_) => de_SamplingTargetDocumentList(_, context), "SamplingTargetDocuments"),
+    UnprocessedBoostStatistics: import_smithy_client._json,
     UnprocessedStatistics: import_smithy_client._json
   });
   Object.assign(contents, doc);
@@ -1890,6 +1892,27 @@ var se_ProbabilisticRuleValueUpdate = /* @__PURE__ */ __name((input, context) =>
     DesiredSamplingPercentage: import_smithy_client.serializeFloat
   });
 }, "se_ProbabilisticRuleValueUpdate");
+var se_SamplingBoostStatisticsDocument = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    AnomalyCount: [],
+    RuleName: [],
+    SampledAnomalyCount: [],
+    ServiceName: [],
+    Timestamp: /* @__PURE__ */ __name((_) => _.getTime() / 1e3, "Timestamp"),
+    TotalCount: []
+  });
+}, "se_SamplingBoostStatisticsDocument");
+var se_SamplingBoostStatisticsDocumentList = /* @__PURE__ */ __name((input, context) => {
+  return input.filter((e) => e != null).map((entry) => {
+    return se_SamplingBoostStatisticsDocument(entry, context);
+  });
+}, "se_SamplingBoostStatisticsDocumentList");
+var se_SamplingRateBoost = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    CooldownWindowMinutes: [],
+    MaxRate: import_smithy_client.serializeFloat
+  });
+}, "se_SamplingRateBoost");
 var se_SamplingRule = /* @__PURE__ */ __name((input, context) => {
   return (0, import_smithy_client.take)(input, {
     Attributes: import_smithy_client._json,
@@ -1901,6 +1924,7 @@ var se_SamplingRule = /* @__PURE__ */ __name((input, context) => {
     ResourceARN: [],
     RuleARN: [],
     RuleName: [],
+    SamplingRateBoost: /* @__PURE__ */ __name((_) => se_SamplingRateBoost(_, context), "SamplingRateBoost"),
     ServiceName: [],
     ServiceType: [],
     URLPath: [],
@@ -1918,6 +1942,7 @@ var se_SamplingRuleUpdate = /* @__PURE__ */ __name((input, context) => {
     ResourceARN: [],
     RuleARN: [],
     RuleName: [],
+    SamplingRateBoost: /* @__PURE__ */ __name((_) => se_SamplingRateBoost(_, context), "SamplingRateBoost"),
     ServiceName: [],
     ServiceType: [],
     URLPath: []
@@ -2174,6 +2199,18 @@ var de_RetrievedTrace = /* @__PURE__ */ __name((output, context) => {
     Spans: import_smithy_client._json
   });
 }, "de_RetrievedTrace");
+var de_SamplingBoost = /* @__PURE__ */ __name((output, context) => {
+  return (0, import_smithy_client.take)(output, {
+    BoostRate: import_smithy_client.limitedParseDouble,
+    BoostRateTTL: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "BoostRateTTL")
+  });
+}, "de_SamplingBoost");
+var de_SamplingRateBoost = /* @__PURE__ */ __name((output, context) => {
+  return (0, import_smithy_client.take)(output, {
+    CooldownWindowMinutes: import_smithy_client.expectInt32,
+    MaxRate: import_smithy_client.limitedParseDouble
+  });
+}, "de_SamplingRateBoost");
 var de_SamplingRule = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     Attributes: import_smithy_client._json,
@@ -2185,6 +2222,7 @@ var de_SamplingRule = /* @__PURE__ */ __name((output, context) => {
     ResourceARN: import_smithy_client.expectString,
     RuleARN: import_smithy_client.expectString,
     RuleName: import_smithy_client.expectString,
+    SamplingRateBoost: /* @__PURE__ */ __name((_) => de_SamplingRateBoost(_, context), "SamplingRateBoost"),
     ServiceName: import_smithy_client.expectString,
     ServiceType: import_smithy_client.expectString,
     URLPath: import_smithy_client.expectString,
@@ -2225,7 +2263,8 @@ var de_SamplingTargetDocument = /* @__PURE__ */ __name((output, context) => {
     Interval: import_smithy_client.expectInt32,
     ReservoirQuota: import_smithy_client.expectInt32,
     ReservoirQuotaTTL: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "ReservoirQuotaTTL"),
-    RuleName: import_smithy_client.expectString
+    RuleName: import_smithy_client.expectString,
+    SamplingBoost: /* @__PURE__ */ __name((_) => de_SamplingBoost(_, context), "SamplingBoost")
   });
 }, "de_SamplingTargetDocument");
 var de_SamplingTargetDocumentList = /* @__PURE__ */ __name((output, context) => {

package/dist-es/protocols/Aws_restJson1.js

@@ -261,6 +261,7 @@ export const se_GetSamplingTargetsCommand = async (input, context) => {
     b.bp("/SamplingTargets");
     let body;
     body = JSON.stringify(take(input, {
+        SamplingBoostStatisticsDocuments: (_) => se_SamplingBoostStatisticsDocumentList(_, context),
         SamplingStatisticsDocuments: (_) => se_SamplingStatisticsDocumentList(_, context),
     }));
     b.m("POST").h(headers).b(body);
@@ -811,6 +812,7 @@ export const de_GetSamplingTargetsCommand = async (output, context) => {
     const doc = take(data, {
         LastRuleModification: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         SamplingTargetDocuments: (_) => de_SamplingTargetDocumentList(_, context),
+        UnprocessedBoostStatistics: _json,
         UnprocessedStatistics: _json,
     });
     Object.assign(contents, doc);
@@ -1277,6 +1279,29 @@ const se_ProbabilisticRuleValueUpdate = (input, context) => {
         DesiredSamplingPercentage: __serializeFloat,
     });
 };
+const se_SamplingBoostStatisticsDocument = (input, context) => {
+    return take(input, {
+        AnomalyCount: [],
+        RuleName: [],
+        SampledAnomalyCount: [],
+        ServiceName: [],
+        Timestamp: (_) => _.getTime() / 1_000,
+        TotalCount: [],
+    });
+};
+const se_SamplingBoostStatisticsDocumentList = (input, context) => {
+    return input
+        .filter((e) => e != null)
+        .map((entry) => {
+        return se_SamplingBoostStatisticsDocument(entry, context);
+    });
+};
+const se_SamplingRateBoost = (input, context) => {
+    return take(input, {
+        CooldownWindowMinutes: [],
+        MaxRate: __serializeFloat,
+    });
+};
 const se_SamplingRule = (input, context) => {
     return take(input, {
         Attributes: _json,
@@ -1288,6 +1313,7 @@ const se_SamplingRule = (input, context) => {
         ResourceARN: [],
         RuleARN: [],
         RuleName: [],
+        SamplingRateBoost: (_) => se_SamplingRateBoost(_, context),
         ServiceName: [],
         ServiceType: [],
         URLPath: [],
@@ -1305,6 +1331,7 @@ const se_SamplingRuleUpdate = (input, context) => {
         ResourceARN: [],
         RuleARN: [],
         RuleName: [],
+        SamplingRateBoost: (_) => se_SamplingRateBoost(_, context),
         ServiceName: [],
         ServiceType: [],
         URLPath: [],
@@ -1585,6 +1612,18 @@ const de_RetrievedTrace = (output, context) => {
         Spans: _json,
     });
 };
+const de_SamplingBoost = (output, context) => {
+    return take(output, {
+        BoostRate: __limitedParseDouble,
+        BoostRateTTL: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+    });
+};
+const de_SamplingRateBoost = (output, context) => {
+    return take(output, {
+        CooldownWindowMinutes: __expectInt32,
+        MaxRate: __limitedParseDouble,
+    });
+};
 const de_SamplingRule = (output, context) => {
     return take(output, {
         Attributes: _json,
@@ -1596,6 +1635,7 @@ const de_SamplingRule = (output, context) => {
         ResourceARN: __expectString,
         RuleARN: __expectString,
         RuleName: __expectString,
+        SamplingRateBoost: (_) => de_SamplingRateBoost(_, context),
         ServiceName: __expectString,
         ServiceType: __expectString,
         URLPath: __expectString,
@@ -1641,6 +1681,7 @@ const de_SamplingTargetDocument = (output, context) => {
         ReservoirQuota: __expectInt32,
         ReservoirQuotaTTL: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         RuleName: __expectString,
+        SamplingBoost: (_) => de_SamplingBoost(_, context),
     });
 };
 const de_SamplingTargetDocumentList = (output, context) => {

package/dist-types/commands/CreateSamplingRuleCommand.d.ts

@@ -57,6 +57,10 @@ declare const CreateSamplingRuleCommand_base: {
  *     Attributes: { // AttributeMap
  *       "<keys>": "STRING_VALUE",
  *     },
+ *     SamplingRateBoost: { // SamplingRateBoost
+ *       MaxRate: Number("double"), // required
+ *       CooldownWindowMinutes: Number("int"), // required
+ *     },
  *   },
  *   Tags: [ // TagList
  *     { // Tag
@@ -85,6 +89,10 @@ declare const CreateSamplingRuleCommand_base: {
  * //       Attributes: { // AttributeMap
  * //         "<keys>": "STRING_VALUE",
  * //       },
+ * //       SamplingRateBoost: { // SamplingRateBoost
+ * //         MaxRate: Number("double"), // required
+ * //         CooldownWindowMinutes: Number("int"), // required
+ * //       },
  * //     },
  * //     CreatedAt: new Date("TIMESTAMP"),
  * //     ModifiedAt: new Date("TIMESTAMP"),

package/dist-types/commands/DeleteSamplingRuleCommand.d.ts

@@ -58,6 +58,10 @@ declare const DeleteSamplingRuleCommand_base: {
  * //       Attributes: { // AttributeMap
  * //         "<keys>": "STRING_VALUE",
  * //       },
+ * //       SamplingRateBoost: { // SamplingRateBoost
+ * //         MaxRate: Number("double"), // required
+ * //         CooldownWindowMinutes: Number("int"), // required
+ * //       },
  * //     },
  * //     CreatedAt: new Date("TIMESTAMP"),
  * //     ModifiedAt: new Date("TIMESTAMP"),

package/dist-types/commands/GetSamplingRulesCommand.d.ts

@@ -58,6 +58,10 @@ declare const GetSamplingRulesCommand_base: {
  * //         Attributes: { // AttributeMap
  * //           "<keys>": "STRING_VALUE",
  * //         },
+ * //         SamplingRateBoost: { // SamplingRateBoost
+ * //           MaxRate: Number("double"), // required
+ * //           CooldownWindowMinutes: Number("int"), // required
+ * //         },
  * //       },
  * //       CreatedAt: new Date("TIMESTAMP"),
  * //       ModifiedAt: new Date("TIMESTAMP"),

package/dist-types/commands/GetSamplingTargetsCommand.d.ts

@@ -46,6 +46,16 @@ declare const GetSamplingTargetsCommand_base: {
  *       BorrowCount: Number("int"),
  *     },
  *   ],
+ *   SamplingBoostStatisticsDocuments: [ // SamplingBoostStatisticsDocumentList
+ *     { // SamplingBoostStatisticsDocument
+ *       RuleName: "STRING_VALUE", // required
+ *       ServiceName: "STRING_VALUE", // required
+ *       Timestamp: new Date("TIMESTAMP"), // required
+ *       AnomalyCount: Number("int"), // required
+ *       TotalCount: Number("int"), // required
+ *       SampledAnomalyCount: Number("int"), // required
+ *     },
+ *   ],
  * };
  * const command = new GetSamplingTargetsCommand(input);
  * const response = await client.send(command);
@@ -57,6 +67,10 @@ declare const GetSamplingTargetsCommand_base: {
  * //       ReservoirQuota: Number("int"),
  * //       ReservoirQuotaTTL: new Date("TIMESTAMP"),
  * //       Interval: Number("int"),
+ * //       SamplingBoost: { // SamplingBoost
+ * //         BoostRate: Number("double"), // required
+ * //         BoostRateTTL: new Date("TIMESTAMP"), // required
+ * //       },
  * //     },
  * //   ],
  * //   LastRuleModification: new Date("TIMESTAMP"),
@@ -67,6 +81,13 @@ declare const GetSamplingTargetsCommand_base: {
  * //       Message: "STRING_VALUE",
  * //     },
  * //   ],
+ * //   UnprocessedBoostStatistics: [
+ * //     {
+ * //       RuleName: "STRING_VALUE",
+ * //       ErrorCode: "STRING_VALUE",
+ * //       Message: "STRING_VALUE",
+ * //     },
+ * //   ],
  * // };
  *
  * ```

package/dist-types/commands/GetTraceSegmentDestinationCommand.d.ts

@@ -28,7 +28,7 @@ declare const GetTraceSegmentDestinationCommand_base: {
 };
 /**
  * <p>
- *   Retrieves the current destination of data sent to <code>PutTraceSegments</code> and <i>OpenTelemetry</i> API. The Transaction Search feature requires a CloudWatchLogs destination. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html">Transaction Search</a> and <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html">OpenTelemetry</a>.
+ *   Retrieves the current destination of data sent to <code>PutTraceSegments</code> and <i>OpenTelemetry protocol (OTLP)</i> endpoint. The Transaction Search feature requires a CloudWatchLogs destination. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html">Transaction Search</a> and <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html">OpenTelemetry</a>.
  * </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/ListRetrievedTracesCommand.d.ts

@@ -30,11 +30,11 @@ declare const ListRetrievedTracesCommand_base: {
  * <p>
  *   Retrieves a list of traces for a given <code>RetrievalToken</code> from the CloudWatch log group generated by Transaction Search. For information on what each trace returns, see <a href="https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html">BatchGetTraces</a>.
  * </p>
- *          <p>This API does not initiate a retrieval job. To start a trace retrieval, use <code>StartTraceRetrieval</code>, which generates the required <code>RetrievalToken</code>.</p>
+ *          <p>This API does not initiate a retrieval process. To start a trace retrieval, use <code>StartTraceRetrieval</code>, which generates the required <code>RetrievalToken</code>.</p>
  *          <p>
  *     When the <code>RetrievalStatus</code> is not <i>COMPLETE</i>, the API will return an empty response. Retry the request once the retrieval has completed to access the full list of traces.</p>
- *          <p>For cross-account observability, this API can retrieve traces from linked accounts when CloudWatch log is the destination across relevant accounts. For more details, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
- *          <p>For retrieving data from X-Ray directly as opposed to the Transaction-Search Log group, see <a href="https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html">BatchGetTraces</a>.</p>
+ *          <p>For cross-account observability, this API can retrieve traces from linked accounts when CloudWatch log is set as the destination across relevant accounts. For more details, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
+ *          <p>For retrieving data from X-Ray directly as opposed to the Transaction Search generated log group, see <a href="https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html">BatchGetTraces</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/StartTraceRetrievalCommand.d.ts

@@ -28,7 +28,7 @@ declare const StartTraceRetrievalCommand_base: {
 };
 /**
  * <p>
- *   Initiates a trace retrieval process using the specified time range and for the give trace IDs on Transaction Search generated by the CloudWatch log group. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html">Transaction Search</a>.
+ *   Initiates a trace retrieval process using the specified time range and for the given trace IDs in the  Transaction Search generated CloudWatch log group. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html">Transaction Search</a>.
  * </p>
  *          <p>API returns a <code>RetrievalToken</code>, which can be used with <code>ListRetrievedTraces</code> or <code>GetRetrievedTracesGraph</code> to fetch results. Retrievals will time out after 60 minutes. To execute long time ranges, consider segmenting into multiple retrievals.</p>
  *          <p>If you are using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>, you can use this operation in a monitoring account to retrieve data from a linked source account, as long as both accounts have transaction search enabled.</p>

package/dist-types/commands/UpdateSamplingRuleCommand.d.ts

@@ -50,6 +50,10 @@ declare const UpdateSamplingRuleCommand_base: {
  *     Attributes: { // AttributeMap
  *       "<keys>": "STRING_VALUE",
  *     },
+ *     SamplingRateBoost: { // SamplingRateBoost
+ *       MaxRate: Number("double"), // required
+ *       CooldownWindowMinutes: Number("int"), // required
+ *     },
  *   },
  * };
  * const command = new UpdateSamplingRuleCommand(input);
@@ -72,6 +76,10 @@ declare const UpdateSamplingRuleCommand_base: {
  * //       Attributes: { // AttributeMap
  * //         "<keys>": "STRING_VALUE",
  * //       },
+ * //       SamplingRateBoost: { // SamplingRateBoost
+ * //         MaxRate: Number("double"), // required
+ * //         CooldownWindowMinutes: Number("int"), // required
+ * //       },
  * //     },
  * //     CreatedAt: new Date("TIMESTAMP"),
  * //     ModifiedAt: new Date("TIMESTAMP"),

package/dist-types/models/models_0.d.ts

@@ -189,8 +189,7 @@ export interface Trace {
      */
     Id?: string | undefined;
     /**
-     * <p>The length of time in seconds between the start time of the root segment and the end
-     *       time of the last segment that completed.</p>
+     * <p>The length of time in seconds between the start time of the earliest segment that started and the end time of the last segment that completed.</p>
      * @public
      */
     Duration?: number | undefined;
@@ -449,6 +448,24 @@ export interface CreateGroupResult {
      */
     Group?: Group | undefined;
 }
+/**
+ * <p>Enable temporary sampling rate increases when you detect anomalies to improve visibility.</p>
+ * @public
+ */
+export interface SamplingRateBoost {
+    /**
+     * <p>Defines max temporary sampling rate to apply when a boost is triggered.
+     *       Calculated boost rate by X-Ray will be less than or equal to this max rate.</p>
+     * @public
+     */
+    MaxRate: number | undefined;
+    /**
+     * <p>Sets the time window (in minutes) in which only one sampling rate boost can be triggered.
+     *       After a boost occurs, no further boosts are allowed until the next window.</p>
+     * @public
+     */
+    CooldownWindowMinutes: number | undefined;
+}
 /**
  * <p>A sampling rule that services use to decide whether to instrument a request. Rule
  *       fields can match properties of the service, or properties of a request. The service can ignore
@@ -523,6 +540,12 @@ export interface SamplingRule {
      * @public
      */
     Attributes?: Record<string, string> | undefined;
+    /**
+     * <p>Specifies the multiplier applied to the base sampling rate.
+     *       This boost allows you to temporarily increase sampling without changing the rule's configuration.</p>
+     * @public
+     */
+    SamplingRateBoost?: SamplingRateBoost | undefined;
 }
 /**
  * @public
@@ -1879,6 +1902,44 @@ export interface GetSamplingStatisticSummariesResult {
      */
     NextToken?: string | undefined;
 }
+/**
+ * <p>Request anomaly stats for a single rule from a service. Results are for the last 10
+ *       seconds unless the service has been assigned a longer reporting interval after a previous call
+ *       to <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a>.</p>
+ * @public
+ */
+export interface SamplingBoostStatisticsDocument {
+    /**
+     * <p>The name of the sampling rule.</p>
+     * @public
+     */
+    RuleName: string | undefined;
+    /**
+     * <p>Matches the <code>name</code> that the service uses to identify itself in segments.</p>
+     * @public
+     */
+    ServiceName: string | undefined;
+    /**
+     * <p>The current time.</p>
+     * @public
+     */
+    Timestamp: Date | undefined;
+    /**
+     * <p>The number of requests with anomaly.</p>
+     * @public
+     */
+    AnomalyCount: number | undefined;
+    /**
+     * <p>The number of requests that associated to the rule.</p>
+     * @public
+     */
+    TotalCount: number | undefined;
+    /**
+     * <p>The number of requests with anomaly recorded.</p>
+     * @public
+     */
+    SampledAnomalyCount: number | undefined;
+}
 /**
  * <p>Request sampling results for a single rule from a service. Results are for the last 10
  *       seconds unless the service has been assigned a longer reporting interval after a previous call
@@ -1926,6 +1987,28 @@ export interface GetSamplingTargetsRequest {
      * @public
      */
     SamplingStatisticsDocuments: SamplingStatisticsDocument[] | undefined;
+    /**
+     * <p>Information about rules that the service is using to boost sampling rate.</p>
+     * @public
+     */
+    SamplingBoostStatisticsDocuments?: SamplingBoostStatisticsDocument[] | undefined;
+}
+/**
+ * <p>Temporary boost sampling rate. X-Ray calculates sampling boost for each service based on the recent sampling boost stats of all services that called
+ *       <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a>.</p>
+ * @public
+ */
+export interface SamplingBoost {
+    /**
+     * <p>The calculated sampling boost rate for this service </p>
+     * @public
+     */
+    BoostRate: number | undefined;
+    /**
+     * <p>When the sampling boost expires.</p>
+     * @public
+     */
+    BoostRateTTL: Date | undefined;
 }
 /**
  * <p>Temporary changes to a sampling rule configuration. To meet the global sampling target for a rule, X-Ray
@@ -1961,6 +2044,11 @@ export interface SamplingTargetDocument {
      * @public
      */
     Interval?: number | undefined;
+    /**
+     * <p>The sampling boost that X-Ray allocated for this service.</p>
+     * @public
+     */
+    SamplingBoost?: SamplingBoost | undefined;
 }
 /**
  * <p>Sampling statistics from a call to <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a> that X-Ray
@@ -2006,6 +2094,12 @@ export interface GetSamplingTargetsResult {
      * @public
      */
     UnprocessedStatistics?: UnprocessedStatistics[] | undefined;
+    /**
+     * <p>Information about <a href="https://docs.aws.amazon.com/xray/latest/api/API_SamplingBoostStatisticsDocument.html">SamplingBoostStatisticsDocument</a> that X-Ray could not
+     *          process.</p>
+     * @public
+     */
+    UnprocessedBoostStatistics?: UnprocessedStatistics[] | undefined;
 }
 /**
  * @public
@@ -2677,8 +2771,7 @@ export interface TraceSummary {
      */
     StartTime?: Date | undefined;
     /**
-     * <p>The length of time in seconds between the start time of the root segment and the end
-     *       time of the last segment that completed.</p>
+     * <p> The length of time in seconds between the start time of the earliest segment that started and the end time of the last segment that completed.</p>
      * @public
      */
     Duration?: number | undefined;
@@ -3613,6 +3706,12 @@ export interface SamplingRuleUpdate {
      * @public
      */
     Attributes?: Record<string, string> | undefined;
+    /**
+     * <p>Specifies the multiplier applied to the base sampling rate.
+     *       This boost allows you to temporarily increase sampling without changing the rule's configuration.</p>
+     * @public
+     */
+    SamplingRateBoost?: SamplingRateBoost | undefined;
 }
 /**
  * @public

package/dist-types/ts3.4/models/models_0.d.ts

@@ -128,6 +128,10 @@ export interface Group {
 export interface CreateGroupResult {
   Group?: Group | undefined;
 }
+export interface SamplingRateBoost {
+  MaxRate: number | undefined;
+  CooldownWindowMinutes: number | undefined;
+}
 export interface SamplingRule {
   RuleName?: string | undefined;
   RuleARN?: string | undefined;
@@ -142,6 +146,7 @@ export interface SamplingRule {
   URLPath: string | undefined;
   Version: number | undefined;
   Attributes?: Record<string, string> | undefined;
+  SamplingRateBoost?: SamplingRateBoost | undefined;
 }
 export interface CreateSamplingRuleRequest {
   SamplingRule: SamplingRule | undefined;
@@ -472,6 +477,14 @@ export interface GetSamplingStatisticSummariesResult {
   SamplingStatisticSummaries?: SamplingStatisticSummary[] | undefined;
   NextToken?: string | undefined;
 }
+export interface SamplingBoostStatisticsDocument {
+  RuleName: string | undefined;
+  ServiceName: string | undefined;
+  Timestamp: Date | undefined;
+  AnomalyCount: number | undefined;
+  TotalCount: number | undefined;
+  SampledAnomalyCount: number | undefined;
+}
 export interface SamplingStatisticsDocument {
   RuleName: string | undefined;
   ClientID: string | undefined;
@@ -482,6 +495,13 @@ export interface SamplingStatisticsDocument {
 }
 export interface GetSamplingTargetsRequest {
   SamplingStatisticsDocuments: SamplingStatisticsDocument[] | undefined;
+  SamplingBoostStatisticsDocuments?:
+    | SamplingBoostStatisticsDocument[]
+    | undefined;
+}
+export interface SamplingBoost {
+  BoostRate: number | undefined;
+  BoostRateTTL: Date | undefined;
 }
 export interface SamplingTargetDocument {
   RuleName?: string | undefined;
@@ -489,6 +509,7 @@ export interface SamplingTargetDocument {
   ReservoirQuota?: number | undefined;
   ReservoirQuotaTTL?: Date | undefined;
   Interval?: number | undefined;
+  SamplingBoost?: SamplingBoost | undefined;
 }
 export interface UnprocessedStatistics {
   RuleName?: string | undefined;
@@ -499,6 +520,7 @@ export interface GetSamplingTargetsResult {
   SamplingTargetDocuments?: SamplingTargetDocument[] | undefined;
   LastRuleModification?: Date | undefined;
   UnprocessedStatistics?: UnprocessedStatistics[] | undefined;
+  UnprocessedBoostStatistics?: UnprocessedStatistics[] | undefined;
 }
 export interface GetServiceGraphRequest {
   StartTime: Date | undefined;
@@ -906,6 +928,7 @@ export interface SamplingRuleUpdate {
   HTTPMethod?: string | undefined;
   URLPath?: string | undefined;
   Attributes?: Record<string, string> | undefined;
+  SamplingRateBoost?: SamplingRateBoost | undefined;
 }
 export interface UpdateSamplingRuleRequest {
   SamplingRuleUpdate: SamplingRuleUpdate | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-xray",
   "description": "AWS SDK for JavaScript Xray Client for Node.js, Browser and React Native",
-  "version": "3.876.0",
+  "version": "3.879.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-xray",
@@ -20,38 +20,38 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.876.0",
-    "@aws-sdk/credential-provider-node": "3.876.0",
+    "@aws-sdk/core": "3.879.0",
+    "@aws-sdk/credential-provider-node": "3.879.0",
     "@aws-sdk/middleware-host-header": "3.873.0",
     "@aws-sdk/middleware-logger": "3.876.0",
     "@aws-sdk/middleware-recursion-detection": "3.873.0",
-    "@aws-sdk/middleware-user-agent": "3.876.0",
+    "@aws-sdk/middleware-user-agent": "3.879.0",
     "@aws-sdk/region-config-resolver": "3.873.0",
     "@aws-sdk/types": "3.862.0",
-    "@aws-sdk/util-endpoints": "3.873.0",
+    "@aws-sdk/util-endpoints": "3.879.0",
     "@aws-sdk/util-user-agent-browser": "3.873.0",
-    "@aws-sdk/util-user-agent-node": "3.876.0",
+    "@aws-sdk/util-user-agent-node": "3.879.0",
     "@smithy/config-resolver": "^4.1.5",
-    "@smithy/core": "^3.8.0",
+    "@smithy/core": "^3.9.0",
     "@smithy/fetch-http-handler": "^5.1.1",
     "@smithy/hash-node": "^4.0.5",
     "@smithy/invalid-dependency": "^4.0.5",
     "@smithy/middleware-content-length": "^4.0.5",
-    "@smithy/middleware-endpoint": "^4.1.18",
-    "@smithy/middleware-retry": "^4.1.19",
+    "@smithy/middleware-endpoint": "^4.1.19",
+    "@smithy/middleware-retry": "^4.1.20",
     "@smithy/middleware-serde": "^4.0.9",
     "@smithy/middleware-stack": "^4.0.5",
     "@smithy/node-config-provider": "^4.1.4",
     "@smithy/node-http-handler": "^4.1.1",
     "@smithy/protocol-http": "^5.1.3",
-    "@smithy/smithy-client": "^4.4.10",
+    "@smithy/smithy-client": "^4.5.0",
     "@smithy/types": "^4.3.2",
     "@smithy/url-parser": "^4.0.5",
     "@smithy/util-base64": "^4.0.0",
     "@smithy/util-body-length-browser": "^4.0.0",
     "@smithy/util-body-length-node": "^4.0.0",
-    "@smithy/util-defaults-mode-browser": "^4.0.26",
-    "@smithy/util-defaults-mode-node": "^4.0.26",
+    "@smithy/util-defaults-mode-browser": "^4.0.27",
+    "@smithy/util-defaults-mode-node": "^4.0.27",
     "@smithy/util-endpoints": "^3.0.7",
     "@smithy/util-middleware": "^4.0.5",
     "@smithy/util-retry": "^4.0.7",