@rio-cloud/cdk-v2-constructs 9.0.0-alpha.8 → 9.0.0-alpha.9

package/.jsii

@@ -9869,7 +9869,7 @@
   },
   "name": "@rio-cloud/cdk-v2-constructs",
   "readme": {
-    "markdown": "# RIO CDK Constructs\n\nThis package contains CDK2 constructs for RIO teams.\n\n> NPM: `@rio-cloud/cdk-v2-constructs`\n\n## Bootstrapping of CDK project\n\n```\n$ npx cdk init --language typescript\n```\n\n## Installation\n\n```\n$ npm install --save @rio-cloud/cdk-v2-constructs\n```\n\n## See also\n\n * [How to contribute](./docs/contribution.md)\n * [Changelog](./docs/changelog.md)\n * [brief API description](./docs/API.md)\n * [Agent documentation](./docs/AGENTS_DOCUMENTATION.md)\n\n## Internal documentation for library devs\n[Documentation](./docs/developers-readme.md)\n\n## Constructs overview (Under construction...)\n\n### Watchful\n\nWatchful constructs help generate some default monitors based on the resources defined in your stack. E.g. - If your stack contains a lambda function, and you configure watchful construct, then it will create out of box metric monitors for Throttling, Lambda error and Log error monitors. The ever-growing list of resources that watchful creates monitors for as of today are:\n\n- Application load balancer\n- Cloudfront\n- Documentdb\n- Dynamodb\n- Fargate\n- Lambda\n- RDS\n\nSimply add the following to your CDK stack to get started.\n```\n  import * as rio from '@rio-cloud/cdk-v2-constructs';\n    ...\n    const dw = new rio.watchfulv2.Watchful(this, 'Watchful', {\n      serviceName,\n    });\n    dw.watchScope(this); // Generates alarms for all supported resources\n    ...\n```\n\nThere are options to override some defaults too. Please be aware that the library is very opinionated and is written with the most general use cases in mind. It is necessary to keep the use of the library simple enough, which means that there is only limited flexibility regarding the configuration options. Having said that, feel free to reach out to team CLAID over slack #rio-platform-support in case of feature requests.\n\nThe broad classification of the monitors created by watchful are\n- Log error monitors\n- Metrics Query monitors: Basically everything other than log error monitors\n\nFor Metrics query monitors, you can configure the priority (defaults as 3). For log error monitors, you can configure priority, renotification interval and can configure if the auto close of the monitor is disabled.\n```\n    ...\n    const dw = new Watchful(stack, 'Watchful2', {\n      logErrorMonitorConfig: {\n        disableAutoClose: true,\n        renotifyInterval: 150,\n        priority: 4,\n      },\n      queryErrorMonitorConfig: {\n        priority: 4\n      }\n    });\n    dw.watchScope(stack);\n```\n\nThere is an `overrideAlarmThreshold` method which can be used to override the default watchful thresholds. Please make sure to use the method before the `watchscope` function.\nE.g. -\n```\n...\nconst dw = new Watchful(stack, 'Watchful', {});\ndw.overrideAlarmThreshold({\n  monitoredResourceScope: lambdaA,\n  monitorType: MonitorType.ERRORS,\n  threshold: 5,\n});\ndw.watchScope(stack);\n```\n\n### ClassifyPipelineType\n\nThe pipelines can be tagged with key 'pipeline_type' to the following values:\n\n* deploy: To tag the production pipeline releasing the application\n* branch: The branch pipeline. Mostly used to test contributions / renovate updates\n* vulnerability: The vulnerability pipeline\n\nThe construct `ClassifyPipelineType` can be used to tag the pipeline accordingly. This tag is also picked up by the Datadog pipeline metric used to monitor the pipelines. It is added as a tag to the metric. This gives you more flexibility with managing the monitors also. E.g. some teams don't want to get alerted for branch pipelines. You can then leverage this metric tag to filter the pipelines.\n\nExample:\n\n```typescript\nconst pipeline = new pipelines.CodePipeline(this, 'Pipeline', {\n      ...\n    });\nrio.ClassifyPipelineType.apply(pipeline, rio.RioPipelineType.DEPLOY);\n```\n"
+    "markdown": "# RIO CDK Constructs\n\nThis package contains CDK2 constructs for RIO teams.\n\n> NPM: `@rio-cloud/cdk-v2-constructs`\n\n## Bootstrapping of CDK project\n\n```\n$ npx cdk init --language typescript\n```\n\n## Installation\n\n```\n$ npm install --save @rio-cloud/cdk-v2-constructs\n```\n\n## See also\n\n * [How to contribute](./docs/contribution.md)\n * [Changelog](./docs/changelog.md)\n * [brief API description](./docs/API.md)\n * [Agent documentation](./docs/AGENTS_DOCUMENTATION.md)\n\n## Internal documentation for library devs\n[Documentation](./docs/developers-readme.md)\n\n## Constructs overview (Under construction...)\n\n### Fargate trace sampling\n\n`RioFargateService` and `RioFargateServiceBlueGreenAlpha` configure Datadog\ntrace sampling through `datadogOptions.traceSampling`. The default is\n`TraceSamplingMode.DEFAULT`: it sets `DD_APM_TARGET_TPS=5` and\n`DD_APM_ERROR_TPS=10` on the Datadog Agent sidecar. This replaces the\nhistorical application-level fixed rate of `DD_TRACE_SAMPLE_RATE=1.0`.\nThese settings apply per Agent; each Fargate task has its own Agent sidecar.\n\nThe head-sampling target is averaged over time, so traffic spikes can exceed\nit. Error sampling captures additional local error trace chunks missed by\nhead sampling; it does not cap the total number of error traces ingested.\n\nRIO uses target-per-second sampling as its default because it is appropriate\nfor both low- and high-traffic services: low-traffic services can retain all\ntheir traces, while high-traffic services are sampled toward the target.\n\nFor Kotlin/Spring Boot services on Fargate it is recommended to use the\nDatadog Java tracer, `dd-java-agent`, as a JVM agent. It automatically\ninstruments supported Spring Boot libraries and enables the Agent-side\ntarget-per-second sampling configured by this construct.\n\nDo not use the OpenTelemetry Java agent. The default tracing behavior for RIO\nFargate Services—`DD_APM_TARGET_TPS`—controls Datadog SDKs, not OTLP\ningestion. OpenTelemetry users must configure sampling in their own SDK and\nmaintain that integration separately.\n\n- `DEFAULT` (or no option) emits the RIO Agent head-sampling target of 5\n  traces per second and an additional error-sampling budget of 10 error trace\n  chunks per second, per Agent (and therefore per running service instance).\n  This target-per-second approach is a practical default for both low- and\n  high-traffic services.\n- `DATADOG_DEFAULT` emits no sampling variables, leaving Datadog's sampling\n  defaults in control.\n- `FIXED_RATE` requires `fixedRate` (from 0 through 1) and emits a global\n  `DD_TRACE_SAMPLING_RULES` rule on the application container.\n  Datadog tracers additionally enforce their built-in 100-traces-per-second\n  rate limit when sampling rules are configured. This construct deliberately\n  does not expose or override that safeguard, so `fixedRate` is subject to\n  that per-instance upper bound on high-traffic services.\n- `TARGET_PER_SECOND` requires `targetTracesPerSecond` and emits\n  `DD_APM_TARGET_TPS` on the Agent sidecar. This is an average head-sampling\n  target per Agent. Optional `errorTracesPerSecond` configures\n  `DD_APM_ERROR_TPS`, the budget for additional local error trace chunks per\n  second missed by head sampling.\n\nFor example:\n\n```ts\ndatadogOptions: {\n  traceSampling: {\n    mode: TraceSamplingMode.TARGET_PER_SECOND,\n    targetTracesPerSecond: 20,\n    errorTracesPerSecond: 10,\n  },\n},\n```\n\n`DD_TRACE_SAMPLING_RULES`, `DD_TRACE_SAMPLE_RATE`, `DD_APM_TARGET_TPS`, or\n`DD_APM_ERROR_TPS` SHOULD not be set directly in\n`containerDefinitionOption.environment`. Direct configuration remains possible\nfor backwards compatibility and produces a synthesis warning only.\nUsers who choose this approach are responsible for its configuration,\ncompatibility, and ongoing maintenance.\n\n### Watchful\n\nWatchful constructs help generate some default monitors based on the resources defined in your stack. E.g. - If your stack contains a lambda function, and you configure watchful construct, then it will create out of box metric monitors for Throttling, Lambda error and Log error monitors. The ever-growing list of resources that watchful creates monitors for as of today are:\n\n- Application load balancer\n- Cloudfront\n- Documentdb\n- Dynamodb\n- Fargate\n- Lambda\n- RDS\n\nSimply add the following to your CDK stack to get started.\n```\n  import * as rio from '@rio-cloud/cdk-v2-constructs';\n    ...\n    const dw = new rio.watchfulv2.Watchful(this, 'Watchful', {\n      serviceName,\n    });\n    dw.watchScope(this); // Generates alarms for all supported resources\n    ...\n```\n\nThere are options to override some defaults too. Please be aware that the library is very opinionated and is written with the most general use cases in mind. It is necessary to keep the use of the library simple enough, which means that there is only limited flexibility regarding the configuration options. Having said that, feel free to reach out to team CLAID over slack #rio-platform-support in case of feature requests.\n\nThe broad classification of the monitors created by watchful are\n- Log error monitors\n- Metrics Query monitors: Basically everything other than log error monitors\n\nFor Metrics query monitors, you can configure the priority (defaults as 3). For log error monitors, you can configure priority, renotification interval and can configure if the auto close of the monitor is disabled.\n```\n    ...\n    const dw = new Watchful(stack, 'Watchful2', {\n      logErrorMonitorConfig: {\n        disableAutoClose: true,\n        renotifyInterval: 150,\n        priority: 4,\n      },\n      queryErrorMonitorConfig: {\n        priority: 4\n      }\n    });\n    dw.watchScope(stack);\n```\n\nThere is an `overrideAlarmThreshold` method which can be used to override the default watchful thresholds. Please make sure to use the method before the `watchscope` function.\nE.g. -\n```\n...\nconst dw = new Watchful(stack, 'Watchful', {});\ndw.overrideAlarmThreshold({\n  monitoredResourceScope: lambdaA,\n  monitorType: MonitorType.ERRORS,\n  threshold: 5,\n});\ndw.watchScope(stack);\n```\n\n### ClassifyPipelineType\n\nThe pipelines can be tagged with key 'pipeline_type' to the following values:\n\n* deploy: To tag the production pipeline releasing the application\n* branch: The branch pipeline. Mostly used to test contributions / renovate updates\n* vulnerability: The vulnerability pipeline\n\nThe construct `ClassifyPipelineType` can be used to tag the pipeline accordingly. This tag is also picked up by the Datadog pipeline metric used to monitor the pipelines. It is added as a tag to the metric. This gives you more flexibility with managing the monitors also. E.g. some teams don't want to get alerted for branch pipelines. You can then leverage this metric tag to filter the pipelines.\n\nExample:\n\n```typescript\nconst pipeline = new pipelines.CodePipeline(this, 'Pipeline', {\n      ...\n    });\nrio.ClassifyPipelineType.apply(pipeline, rio.RioPipelineType.DEPLOY);\n```\n"
   },
   "repository": {
     "type": "git",
@@ -10446,7 +10446,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-        "line": 92
+        "line": 93
       },
       "name": "BlueGreenDeploymentConfig",
       "properties": [
@@ -10459,7 +10459,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 102
+            "line": 103
           },
           "name": "capabilityNames",
           "optional": true,
@@ -10482,7 +10482,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 97
+            "line": 98
           },
           "name": "testListener",
           "optional": true,
@@ -11032,7 +11032,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 79
+        "line": 94
       },
       "name": "ContainerDefinitionOptions",
       "properties": [
@@ -11046,7 +11046,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 87
+            "line": 102
           },
           "name": "image",
           "type": {
@@ -11057,14 +11057,14 @@
           "abstract": true,
           "docs": {
             "default": "- No environment variables.",
-            "remarks": "Some Datadog specific environment variables are not allowed to be set,\nbecause they are set automatically or computed from other attributes.\nThese are:\n* DD_ENV: Set same as prop stage\n* DD_SERVICE: Set same as prop serviceName\n* DD_VERSION: Set same as prop version\n* DD_TAGS: Set same as DatadogIntegrationProps#additionalTags\n* DD_LOGS_INJECTION: true\nOther DD_-prefixed vaiable may be added to this list.\n\nOther Environment variables set by default are overwritten if passed.\nThese are:\n* DD_SERVICE_MAPPING: database:fargate-web-app-aurora,java-aws-sdk:fargate-web-app-aws-sdk,kafka:fargate-web-app-kafka,mysql:fargate-web-app-aurora\n* DD_TRACE_SAMPLE_RATE: 1.0",
+            "remarks": "Some Datadog specific environment variables are not allowed to be set,\nbecause they are set automatically or computed from other attributes.\nThese are:\n* DD_ENV: Set same as prop stage\n* DD_SERVICE: Set same as prop serviceName\n* DD_VERSION: Set same as prop version\n* DD_TAGS: Set same as DatadogIntegrationProps#additionalTags\n* DD_LOGS_INJECTION: true\nOther DD_-prefixed vaiable may be added to this list.\n\nOther Environment variables set by default are overwritten if passed.\nThese are:\n* DD_SERVICE_MAPPING: database:fargate-web-app-aurora,java-aws-sdk:fargate-web-app-aws-sdk,kafka:fargate-web-app-kafka,mysql:fargate-web-app-aurora\nSampling variables (`DD_TRACE_SAMPLING_RULES`, `DD_TRACE_SAMPLE_RATE`,\n`DD_APM_TARGET_TPS`, and `DD_APM_ERROR_TPS`) should be configured through\n`DatadogIntegrationProps.traceSampling`. Supplying them here is preserved\nfor backwards compatibility, but produces a synthesis warning. In\nparticular, `DD_APM_*` values on this application container do not\nconfigure the Datadog Agent sidecar.",
             "stability": "stable",
             "summary": "The environment variables to pass to the container."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 109
+            "line": 129
           },
           "name": "environment",
           "optional": true,
@@ -11087,7 +11087,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 123
+            "line": 143
           },
           "name": "healthCheck",
           "optional": true,
@@ -11105,7 +11105,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 116
+            "line": 136
           },
           "name": "secrets",
           "optional": true,
@@ -11228,7 +11228,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 337
+        "line": 372
       },
       "members": [
         {
@@ -11454,6 +11454,41 @@
       ],
       "symbolId": "src/watchful/datadog-log-alarm:DataDogProps"
     },
+    "@rio-cloud/cdk-v2-constructs.DatadogDefaultTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "remarks": "retain Datadog's defaults.",
+        "stability": "stable",
+        "summary": "Do not set sampling environment variables;"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.DatadogDefaultTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 41
+      },
+      "name": "DatadogDefaultTraceSamplingOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 43
+          },
+          "name": "mode",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:DatadogDefaultTraceSamplingOptions"
+    },
     "@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "datatype": true,
@@ -11464,7 +11499,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 231
+        "line": 251
       },
       "name": "DatadogIntegrationProps",
       "properties": [
@@ -11478,7 +11513,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 334
+            "line": 369
           },
           "name": "additionalTags",
           "optional": true,
@@ -11502,7 +11537,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 290
+            "line": 325
           },
           "name": "apmGetEndpointsToIgnore",
           "optional": true,
@@ -11526,7 +11561,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 259
+            "line": 294
           },
           "name": "awsFireLensCpu",
           "optional": true,
@@ -11545,7 +11580,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 269
+            "line": 304
           },
           "name": "awsFireLensMemoryLimitMiB",
           "optional": true,
@@ -11563,7 +11598,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 237
+            "line": 272
           },
           "name": "cpu",
           "optional": true,
@@ -11581,7 +11616,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 297
+            "line": 332
           },
           "name": "datadogSidecarEssential",
           "optional": true,
@@ -11599,7 +11634,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 303
+            "line": 338
           },
           "name": "datadogSidecarTag",
           "optional": true,
@@ -11617,7 +11652,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 309
+            "line": 344
           },
           "name": "enableRestartPolicy",
           "optional": true,
@@ -11635,7 +11670,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 283
+            "line": 318
           },
           "name": "loggingModeForDatadogAgent",
           "optional": true,
@@ -11653,7 +11688,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 276
+            "line": 311
           },
           "name": "loggingModeForService",
           "optional": true,
@@ -11672,7 +11707,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 249
+            "line": 284
           },
           "name": "memoryLimitMiB",
           "optional": true,
@@ -11690,7 +11725,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 315
+            "line": 350
           },
           "name": "restartIgnoredExitCodes",
           "optional": true,
@@ -11702,6 +11737,39 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `TraceSamplingMode.DEFAULT`, which configures each\nAgent sidecar with an average head-sampling target of 5 traces per second\nand an additional error-sampling budget of 10 local error trace chunks per\nsecond. Each Fargate task has its own sidecar. Therefore, the target traces\nper second apply per Fargate task. Traffic spikes can exceed the\nhead-sampling target; these settings do not cap total ingestion.\nTarget-per-second sampling is suitable for both low- and high-traffic\nservices: low-traffic services can retain all traces while high-traffic\nservices are sampled toward the target.",
+            "stability": "stable",
+            "summary": "Configure Datadog APM trace sampling for the application and Agent sidecar."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/rio-fargate-service.ts",
+            "line": 265
+          },
+          "name": "traceSampling",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.RioDefaultTraceSamplingOptions"
+                },
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.DatadogDefaultTraceSamplingOptions"
+                },
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.FixedRateTraceSamplingOptions"
+                },
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.TargetPerSecondTraceSamplingOptions"
+                }
+              ]
+            }
+          }
         }
       ],
       "symbolId": "src/fargate/rio-fargate-service:DatadogIntegrationProps"
@@ -12171,7 +12239,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 126
+        "line": 146
       },
       "name": "FargateTaskDefinitionProps",
       "properties": [
@@ -12186,7 +12254,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 144
+            "line": 164
           },
           "name": "cpu",
           "type": {
@@ -12204,7 +12272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 162
+            "line": 182
           },
           "name": "memoryLimitMiB",
           "type": {
@@ -12221,7 +12289,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 170
+            "line": 190
           },
           "name": "desiredCount",
           "optional": true,
@@ -12239,7 +12307,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 177
+            "line": 197
           },
           "name": "runtimePlatform",
           "optional": true,
@@ -12250,6 +12318,56 @@
       ],
       "symbolId": "src/fargate/rio-fargate-service:FargateTaskDefinitionProps"
     },
+    "@rio-cloud/cdk-v2-constructs.FixedRateTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Configure a fixed application-tracer sampling rate."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.FixedRateTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 47
+      },
+      "name": "FixedRateTraceSamplingOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The global tracer sampling-rule rate, from 0.0 to 1.0 inclusive. Datadog tracers additionally apply their built-in 100-traces-per-second rate limit when sampling rules are configured. This construct does not expose or override that per-instance safeguard."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 57
+          },
+          "name": "fixedRate",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 49
+          },
+          "name": "mode",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:FixedRateTraceSamplingOptions"
+    },
     "@rio-cloud/cdk-v2-constructs.Framework": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
@@ -12259,7 +12377,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 72
+        "line": 87
       },
       "members": [
         {
@@ -13322,7 +13440,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 180
+        "line": 200
       },
       "name": "ListenerRule",
       "properties": [
@@ -13334,7 +13452,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 183
+            "line": 203
           },
           "name": "conditions",
           "type": {
@@ -13354,7 +13472,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 181
+            "line": 201
           },
           "name": "priority",
           "type": {
@@ -13374,7 +13492,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 186
+        "line": 206
       },
       "name": "LoadBalancerOptions",
       "properties": [
@@ -13387,7 +13505,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 205
+            "line": 225
           },
           "name": "healthCheck",
           "type": {
@@ -13403,7 +13521,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 210
+            "line": 230
           },
           "name": "healthCheckGracePeriod",
           "type": {
@@ -13419,7 +13537,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 190
+            "line": 210
           },
           "name": "listener",
           "type": {
@@ -13436,7 +13554,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 200
+            "line": 220
           },
           "name": "listenerRules",
           "type": {
@@ -13459,7 +13577,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 228
+            "line": 248
           },
           "name": "deregistrationDelay",
           "optional": true,
@@ -13478,7 +13596,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 219
+            "line": 239
           },
           "name": "slowStart",
           "optional": true,
@@ -14212,6 +14330,44 @@
       ],
       "symbolId": "src/pipeline/rio-bitbucket-source-action:RioBitBucketSourceActionProps"
     },
+    "@rio-cloud/cdk-v2-constructs.RioDefaultTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "remarks": "This is also the default when `traceSampling` is omitted.",
+        "stability": "stable",
+        "summary": "Use RIO's default Datadog Agent sampling targets."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.RioDefaultTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 31
+      },
+      "name": "RioDefaultTraceSamplingOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `TraceSamplingMode.DEFAULT`",
+            "remarks": "May be omitted to use the default.",
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 37
+          },
+          "name": "mode",
+          "optional": true,
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:RioDefaultTraceSamplingOptions"
+    },
     "@rio-cloud/cdk-v2-constructs.RioFargateService": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
@@ -14227,7 +14383,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service.ts",
-          "line": 451
+          "line": 486
         },
         "parameters": [
           {
@@ -14256,7 +14412,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 410
+        "line": 445
       },
       "name": "RioFargateService",
       "properties": [
@@ -14268,7 +14424,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 447
+            "line": 482
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -14283,7 +14439,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 443
+            "line": 478
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -14297,7 +14453,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 448
+            "line": 483
           },
           "name": "service",
           "type": {
@@ -14311,7 +14467,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 442
+            "line": 477
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -14325,7 +14481,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 445
+            "line": 480
           },
           "name": "taskDefinition",
           "type": {
@@ -14339,7 +14495,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 444
+            "line": 479
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -14354,7 +14510,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 449
+            "line": 484
           },
           "name": "targetGroup",
           "optional": true,
@@ -14378,7 +14534,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-          "line": 145
+          "line": 146
         },
         "parameters": [
           {
@@ -14407,7 +14563,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-        "line": 105
+        "line": 106
       },
       "name": "RioFargateServiceBlueGreenAlpha",
       "properties": [
@@ -14419,7 +14575,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 140
+            "line": 141
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -14434,7 +14590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 136
+            "line": 137
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -14448,7 +14604,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 141
+            "line": 142
           },
           "name": "service",
           "type": {
@@ -14462,7 +14618,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 135
+            "line": 136
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -14476,7 +14632,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 138
+            "line": 139
           },
           "name": "taskDefinition",
           "type": {
@@ -14490,7 +14646,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 142
+            "line": 143
           },
           "name": "blueTargetGroup",
           "optional": true,
@@ -14505,7 +14661,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 143
+            "line": 144
           },
           "name": "greenTargetGroup",
           "optional": true,
@@ -14520,7 +14676,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 137
+            "line": 138
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -14542,7 +14698,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-        "line": 30
+        "line": 31
       },
       "name": "RioFargateServiceBlueGreenAlphaProps",
       "properties": [
@@ -14555,7 +14711,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 69
+            "line": 70
           },
           "name": "containerDefinitionOption",
           "type": {
@@ -14571,7 +14727,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 74
+            "line": 75
           },
           "name": "fargateOptions",
           "type": {
@@ -14587,7 +14743,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 39
+            "line": 40
           },
           "name": "serviceName",
           "type": {
@@ -14603,7 +14759,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 34
+            "line": 35
           },
           "name": "stage",
           "type": {
@@ -14619,7 +14775,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 44
+            "line": 45
           },
           "name": "version",
           "type": {
@@ -14635,7 +14791,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 56
+            "line": 57
           },
           "name": "vpc",
           "type": {
@@ -14651,7 +14807,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 89
+            "line": 90
           },
           "name": "blueGreenDeploymentConfig",
           "optional": true,
@@ -14670,7 +14826,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 64
+            "line": 65
           },
           "name": "cluster",
           "optional": true,
@@ -14687,7 +14843,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 84
+            "line": 85
           },
           "name": "datadogOptions",
           "optional": true,
@@ -14705,7 +14861,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 51
+            "line": 52
           },
           "name": "frameworks",
           "optional": true,
@@ -14727,7 +14883,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 79
+            "line": 80
           },
           "name": "loadBalancerOptions",
           "optional": true,
@@ -14749,7 +14905,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 15
+        "line": 31
       },
       "name": "RioFargateServiceProps",
       "properties": [
@@ -14762,7 +14918,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 54
+            "line": 70
           },
           "name": "containerDefinitionOption",
           "type": {
@@ -14778,7 +14934,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 59
+            "line": 75
           },
           "name": "fargateOptions",
           "type": {
@@ -14794,7 +14950,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 24
+            "line": 40
           },
           "name": "serviceName",
           "type": {
@@ -14810,7 +14966,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 19
+            "line": 35
           },
           "name": "stage",
           "type": {
@@ -14826,7 +14982,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 29
+            "line": 45
           },
           "name": "version",
           "type": {
@@ -14842,7 +14998,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 41
+            "line": 57
           },
           "name": "vpc",
           "type": {
@@ -14860,7 +15016,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 49
+            "line": 65
           },
           "name": "cluster",
           "optional": true,
@@ -14877,7 +15033,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 69
+            "line": 85
           },
           "name": "datadogOptions",
           "optional": true,
@@ -14895,7 +15051,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 36
+            "line": 52
           },
           "name": "frameworks",
           "optional": true,
@@ -14917,7 +15073,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 64
+            "line": 80
           },
           "name": "loadBalancerOptions",
           "optional": true,
@@ -16419,51 +16575,242 @@
       ],
       "symbolId": "src/sbom-catalog/catalog-project:StandaloneSbomCatalogProjectProps"
     },
-    "@rio-cloud/cdk-v2-constructs.TriggerKey": {
+    "@rio-cloud/cdk-v2-constructs.TargetPerSecondTraceSamplingOptions": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Configure Datadog Agent target sampling."
       },
-      "fqn": "@rio-cloud/cdk-v2-constructs.TriggerKey",
-      "kind": "enum",
+      "fqn": "@rio-cloud/cdk-v2-constructs.TargetPerSecondTraceSamplingOptions",
+      "kind": "interface",
       "locationInModule": {
-        "filename": "src/pipeline/rio-bitbucket-source-action.ts",
-        "line": 7
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 61
       },
-      "members": [
+      "name": "TargetPerSecondTraceSamplingOptions",
+      "properties": [
         {
+          "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "points to master_repo.zip."
+            "summary": "The sampling strategy."
           },
-          "name": "MASTER_REPO"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 63
+          },
+          "name": "mode",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
         },
         {
+          "abstract": true,
           "docs": {
+            "remarks": "Traffic spikes\ncan exceed this target; it is not a hard cap on total ingestion.",
             "stability": "stable",
-            "summary": "points to branch_repo.zip."
+            "summary": "The average head-sampling target in traces per second for each Agent sidecar (and therefore each Fargate service instance)."
           },
-          "name": "BRANCH_REPO"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 70
+          },
+          "name": "targetTracesPerSecond",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This does not cap error traces already kept by head sampling.",
+            "stability": "stable",
+            "summary": "The budget for additional local error trace chunks per second missed by head sampling, for each Agent sidecar (and therefore each Fargate service instance)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 77
+          },
+          "name": "errorTracesPerSecond",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
         }
       ],
-      "name": "TriggerKey",
-      "symbolId": "src/pipeline/rio-bitbucket-source-action:TriggerKey"
+      "symbolId": "src/fargate/trace-sampling:TargetPerSecondTraceSamplingOptions"
     },
-    "@rio-cloud/cdk-v2-constructs.UnitOfPeriod": {
+    "@rio-cloud/cdk-v2-constructs.TraceSamplingMode": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "The trace sampling strategy used by the Fargate Datadog integration."
       },
-      "fqn": "@rio-cloud/cdk-v2-constructs.UnitOfPeriod",
+      "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode",
       "kind": "enum",
       "locationInModule": {
-        "filename": "src/watchful/datadog-log-alarm.ts",
-        "line": 6
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 7
       },
       "members": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Target-per-second sampling is a practical default for both low- and\nhigh-traffic services.",
+            "stability": "stable",
+            "summary": "Use RIO's per-Agent head-sampling target of 5 traces/sec and an additional error-sampling budget of 10 local error trace chunks/sec."
+          },
+          "name": "DEFAULT"
+        },
+        {
+          "docs": {
+            "remarks": "retain Datadog's defaults.",
+            "stability": "stable",
+            "summary": "Do not set sampling environment variables;"
+          },
+          "name": "DATADOG_DEFAULT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set a fixed sampling rule on the application tracer."
+          },
+          "name": "FIXED_RATE"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set a per-Agent target number of traces per second."
+          },
+          "name": "TARGET_PER_SECOND"
+        }
+      ],
+      "name": "TraceSamplingMode",
+      "symbolId": "src/fargate/trace-sampling:TraceSamplingMode"
+    },
+    "@rio-cloud/cdk-v2-constructs.TraceSamplingValidator": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingValidator",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/fargate/trace-sampling.ts",
+          "line": 101
+        },
+        "parameters": [
+          {
+            "name": "traceSampling",
+            "optional": true,
+            "type": {
+              "union": {
+                "types": [
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.RioDefaultTraceSamplingOptions"
+                  },
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.DatadogDefaultTraceSamplingOptions"
+                  },
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.FixedRateTraceSamplingOptions"
+                  },
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.TargetPerSecondTraceSamplingOptions"
+                  }
+                ]
+              }
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "constructs.IValidation"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 100
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "This method can be implemented by derived constructs in order to perform\nvalidation logic. It is called on all constructs before synthesis.",
+            "stability": "stable",
+            "summary": "Validate the current construct."
+          },
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 103
+          },
+          "name": "validate",
+          "overrides": "constructs.IValidation",
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        }
+      ],
+      "name": "TraceSamplingValidator",
+      "symbolId": "src/fargate/trace-sampling:TraceSamplingValidator"
+    },
+    "@rio-cloud/cdk-v2-constructs.TriggerKey": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.TriggerKey",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/pipeline/rio-bitbucket-source-action.ts",
+        "line": 7
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "points to master_repo.zip."
+          },
+          "name": "MASTER_REPO"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "points to branch_repo.zip."
+          },
+          "name": "BRANCH_REPO"
+        }
+      ],
+      "name": "TriggerKey",
+      "symbolId": "src/pipeline/rio-bitbucket-source-action:TriggerKey"
+    },
+    "@rio-cloud/cdk-v2-constructs.UnitOfPeriod": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.UnitOfPeriod",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/watchful/datadog-log-alarm.ts",
+        "line": 6
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "stable"
           },
           "name": "SECONDS"
         },
@@ -23158,7 +23505,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-        "line": 92
+        "line": 93
       },
       "name": "BlueGreenDeploymentConfig",
       "namespace": "fargate",
@@ -23172,7 +23519,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 102
+            "line": 103
           },
           "name": "capabilityNames",
           "optional": true,
@@ -23195,7 +23542,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 97
+            "line": 98
           },
           "name": "testListener",
           "optional": true,
@@ -23216,7 +23563,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 79
+        "line": 94
       },
       "name": "ContainerDefinitionOptions",
       "namespace": "fargate",
@@ -23231,7 +23578,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 87
+            "line": 102
           },
           "name": "image",
           "type": {
@@ -23242,14 +23589,14 @@
           "abstract": true,
           "docs": {
             "default": "- No environment variables.",
-            "remarks": "Some Datadog specific environment variables are not allowed to be set,\nbecause they are set automatically or computed from other attributes.\nThese are:\n* DD_ENV: Set same as prop stage\n* DD_SERVICE: Set same as prop serviceName\n* DD_VERSION: Set same as prop version\n* DD_TAGS: Set same as DatadogIntegrationProps#additionalTags\n* DD_LOGS_INJECTION: true\nOther DD_-prefixed vaiable may be added to this list.\n\nOther Environment variables set by default are overwritten if passed.\nThese are:\n* DD_SERVICE_MAPPING: database:fargate-web-app-aurora,java-aws-sdk:fargate-web-app-aws-sdk,kafka:fargate-web-app-kafka,mysql:fargate-web-app-aurora\n* DD_TRACE_SAMPLE_RATE: 1.0",
+            "remarks": "Some Datadog specific environment variables are not allowed to be set,\nbecause they are set automatically or computed from other attributes.\nThese are:\n* DD_ENV: Set same as prop stage\n* DD_SERVICE: Set same as prop serviceName\n* DD_VERSION: Set same as prop version\n* DD_TAGS: Set same as DatadogIntegrationProps#additionalTags\n* DD_LOGS_INJECTION: true\nOther DD_-prefixed vaiable may be added to this list.\n\nOther Environment variables set by default are overwritten if passed.\nThese are:\n* DD_SERVICE_MAPPING: database:fargate-web-app-aurora,java-aws-sdk:fargate-web-app-aws-sdk,kafka:fargate-web-app-kafka,mysql:fargate-web-app-aurora\nSampling variables (`DD_TRACE_SAMPLING_RULES`, `DD_TRACE_SAMPLE_RATE`,\n`DD_APM_TARGET_TPS`, and `DD_APM_ERROR_TPS`) should be configured through\n`DatadogIntegrationProps.traceSampling`. Supplying them here is preserved\nfor backwards compatibility, but produces a synthesis warning. In\nparticular, `DD_APM_*` values on this application container do not\nconfigure the Datadog Agent sidecar.",
             "stability": "stable",
             "summary": "The environment variables to pass to the container."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 109
+            "line": 129
           },
           "name": "environment",
           "optional": true,
@@ -23272,7 +23619,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 123
+            "line": 143
           },
           "name": "healthCheck",
           "optional": true,
@@ -23290,7 +23637,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 116
+            "line": 136
           },
           "name": "secrets",
           "optional": true,
@@ -23315,7 +23662,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 337
+        "line": 372
       },
       "members": [
         {
@@ -23353,6 +23700,42 @@
       "namespace": "fargate",
       "symbolId": "src/fargate/rio-fargate-service:DataDogLoggingMode"
     },
+    "@rio-cloud/cdk-v2-constructs.fargate.DatadogDefaultTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "remarks": "retain Datadog's defaults.",
+        "stability": "stable",
+        "summary": "Do not set sampling environment variables;"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.fargate.DatadogDefaultTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 41
+      },
+      "name": "DatadogDefaultTraceSamplingOptions",
+      "namespace": "fargate",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 43
+          },
+          "name": "mode",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:DatadogDefaultTraceSamplingOptions"
+    },
     "@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "datatype": true,
@@ -23363,7 +23746,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 231
+        "line": 251
       },
       "name": "DatadogIntegrationProps",
       "namespace": "fargate",
@@ -23378,7 +23761,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 334
+            "line": 369
           },
           "name": "additionalTags",
           "optional": true,
@@ -23402,7 +23785,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 290
+            "line": 325
           },
           "name": "apmGetEndpointsToIgnore",
           "optional": true,
@@ -23426,7 +23809,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 259
+            "line": 294
           },
           "name": "awsFireLensCpu",
           "optional": true,
@@ -23445,7 +23828,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 269
+            "line": 304
           },
           "name": "awsFireLensMemoryLimitMiB",
           "optional": true,
@@ -23463,7 +23846,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 237
+            "line": 272
           },
           "name": "cpu",
           "optional": true,
@@ -23481,7 +23864,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 297
+            "line": 332
           },
           "name": "datadogSidecarEssential",
           "optional": true,
@@ -23499,7 +23882,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 303
+            "line": 338
           },
           "name": "datadogSidecarTag",
           "optional": true,
@@ -23517,7 +23900,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 309
+            "line": 344
           },
           "name": "enableRestartPolicy",
           "optional": true,
@@ -23535,7 +23918,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 283
+            "line": 318
           },
           "name": "loggingModeForDatadogAgent",
           "optional": true,
@@ -23553,7 +23936,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 276
+            "line": 311
           },
           "name": "loggingModeForService",
           "optional": true,
@@ -23572,7 +23955,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 249
+            "line": 284
           },
           "name": "memoryLimitMiB",
           "optional": true,
@@ -23590,7 +23973,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 315
+            "line": 350
           },
           "name": "restartIgnoredExitCodes",
           "optional": true,
@@ -23602,6 +23985,39 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `TraceSamplingMode.DEFAULT`, which configures each\nAgent sidecar with an average head-sampling target of 5 traces per second\nand an additional error-sampling budget of 10 local error trace chunks per\nsecond. Each Fargate task has its own sidecar. Therefore, the target traces\nper second apply per Fargate task. Traffic spikes can exceed the\nhead-sampling target; these settings do not cap total ingestion.\nTarget-per-second sampling is suitable for both low- and high-traffic\nservices: low-traffic services can retain all traces while high-traffic\nservices are sampled toward the target.",
+            "stability": "stable",
+            "summary": "Configure Datadog APM trace sampling for the application and Agent sidecar."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/rio-fargate-service.ts",
+            "line": 265
+          },
+          "name": "traceSampling",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.RioDefaultTraceSamplingOptions"
+                },
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.DatadogDefaultTraceSamplingOptions"
+                },
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.FixedRateTraceSamplingOptions"
+                },
+                {
+                  "fqn": "@rio-cloud/cdk-v2-constructs.TargetPerSecondTraceSamplingOptions"
+                }
+              ]
+            }
+          }
         }
       ],
       "symbolId": "src/fargate/rio-fargate-service:DatadogIntegrationProps"
@@ -23616,7 +24032,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 126
+        "line": 146
       },
       "name": "FargateTaskDefinitionProps",
       "namespace": "fargate",
@@ -23632,7 +24048,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 144
+            "line": 164
           },
           "name": "cpu",
           "type": {
@@ -23650,7 +24066,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 162
+            "line": 182
           },
           "name": "memoryLimitMiB",
           "type": {
@@ -23667,7 +24083,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 170
+            "line": 190
           },
           "name": "desiredCount",
           "optional": true,
@@ -23685,7 +24101,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 177
+            "line": 197
           },
           "name": "runtimePlatform",
           "optional": true,
@@ -23696,6 +24112,57 @@
       ],
       "symbolId": "src/fargate/rio-fargate-service:FargateTaskDefinitionProps"
     },
+    "@rio-cloud/cdk-v2-constructs.fargate.FixedRateTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Configure a fixed application-tracer sampling rate."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.fargate.FixedRateTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 47
+      },
+      "name": "FixedRateTraceSamplingOptions",
+      "namespace": "fargate",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The global tracer sampling-rule rate, from 0.0 to 1.0 inclusive. Datadog tracers additionally apply their built-in 100-traces-per-second rate limit when sampling rules are configured. This construct does not expose or override that per-instance safeguard."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 57
+          },
+          "name": "fixedRate",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 49
+          },
+          "name": "mode",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:FixedRateTraceSamplingOptions"
+    },
     "@rio-cloud/cdk-v2-constructs.fargate.Framework": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
@@ -23705,7 +24172,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 72
+        "line": 87
       },
       "members": [
         {
@@ -23730,7 +24197,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 180
+        "line": 200
       },
       "name": "ListenerRule",
       "namespace": "fargate",
@@ -23743,7 +24210,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 183
+            "line": 203
           },
           "name": "conditions",
           "type": {
@@ -23763,7 +24230,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 181
+            "line": 201
           },
           "name": "priority",
           "type": {
@@ -23783,7 +24250,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 186
+        "line": 206
       },
       "name": "LoadBalancerOptions",
       "namespace": "fargate",
@@ -23797,7 +24264,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 205
+            "line": 225
           },
           "name": "healthCheck",
           "type": {
@@ -23813,7 +24280,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 210
+            "line": 230
           },
           "name": "healthCheckGracePeriod",
           "type": {
@@ -23829,7 +24296,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 190
+            "line": 210
           },
           "name": "listener",
           "type": {
@@ -23846,7 +24313,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 200
+            "line": 220
           },
           "name": "listenerRules",
           "type": {
@@ -23869,7 +24336,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 228
+            "line": 248
           },
           "name": "deregistrationDelay",
           "optional": true,
@@ -23888,7 +24355,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 219
+            "line": 239
           },
           "name": "slowStart",
           "optional": true,
@@ -23899,6 +24366,45 @@
       ],
       "symbolId": "src/fargate/rio-fargate-service:LoadBalancerOptions"
     },
+    "@rio-cloud/cdk-v2-constructs.fargate.RioDefaultTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "remarks": "This is also the default when `traceSampling` is omitted.",
+        "stability": "stable",
+        "summary": "Use RIO's default Datadog Agent sampling targets."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.fargate.RioDefaultTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 31
+      },
+      "name": "RioDefaultTraceSamplingOptions",
+      "namespace": "fargate",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `TraceSamplingMode.DEFAULT`",
+            "remarks": "May be omitted to use the default.",
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 37
+          },
+          "name": "mode",
+          "optional": true,
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:RioDefaultTraceSamplingOptions"
+    },
     "@rio-cloud/cdk-v2-constructs.fargate.RioFargateService": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
@@ -23914,7 +24420,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service.ts",
-          "line": 451
+          "line": 486
         },
         "parameters": [
           {
@@ -23943,7 +24449,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 410
+        "line": 445
       },
       "name": "RioFargateService",
       "namespace": "fargate",
@@ -23956,7 +24462,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 447
+            "line": 482
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -23971,7 +24477,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 443
+            "line": 478
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -23985,7 +24491,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 448
+            "line": 483
           },
           "name": "service",
           "type": {
@@ -23999,7 +24505,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 442
+            "line": 477
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -24013,7 +24519,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 445
+            "line": 480
           },
           "name": "taskDefinition",
           "type": {
@@ -24027,7 +24533,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 444
+            "line": 479
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -24042,7 +24548,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 449
+            "line": 484
           },
           "name": "targetGroup",
           "optional": true,
@@ -24066,7 +24572,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-          "line": 145
+          "line": 146
         },
         "parameters": [
           {
@@ -24095,7 +24601,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-        "line": 105
+        "line": 106
       },
       "name": "RioFargateServiceBlueGreenAlpha",
       "namespace": "fargate",
@@ -24108,7 +24614,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 140
+            "line": 141
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -24123,7 +24629,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 136
+            "line": 137
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -24137,7 +24643,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 141
+            "line": 142
           },
           "name": "service",
           "type": {
@@ -24151,7 +24657,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 135
+            "line": 136
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -24165,7 +24671,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 138
+            "line": 139
           },
           "name": "taskDefinition",
           "type": {
@@ -24179,7 +24685,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 142
+            "line": 143
           },
           "name": "blueTargetGroup",
           "optional": true,
@@ -24194,7 +24700,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 143
+            "line": 144
           },
           "name": "greenTargetGroup",
           "optional": true,
@@ -24209,7 +24715,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 137
+            "line": 138
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -24231,7 +24737,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-        "line": 30
+        "line": 31
       },
       "name": "RioFargateServiceBlueGreenAlphaProps",
       "namespace": "fargate",
@@ -24245,7 +24751,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 69
+            "line": 70
           },
           "name": "containerDefinitionOption",
           "type": {
@@ -24261,7 +24767,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 74
+            "line": 75
           },
           "name": "fargateOptions",
           "type": {
@@ -24277,7 +24783,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 39
+            "line": 40
           },
           "name": "serviceName",
           "type": {
@@ -24293,7 +24799,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 34
+            "line": 35
           },
           "name": "stage",
           "type": {
@@ -24309,7 +24815,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 44
+            "line": 45
           },
           "name": "version",
           "type": {
@@ -24325,7 +24831,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 56
+            "line": 57
           },
           "name": "vpc",
           "type": {
@@ -24341,7 +24847,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 89
+            "line": 90
           },
           "name": "blueGreenDeploymentConfig",
           "optional": true,
@@ -24360,7 +24866,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 64
+            "line": 65
           },
           "name": "cluster",
           "optional": true,
@@ -24377,7 +24883,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 84
+            "line": 85
           },
           "name": "datadogOptions",
           "optional": true,
@@ -24395,7 +24901,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 51
+            "line": 52
           },
           "name": "frameworks",
           "optional": true,
@@ -24417,7 +24923,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service-blue-green-alpha.ts",
-            "line": 79
+            "line": 80
           },
           "name": "loadBalancerOptions",
           "optional": true,
@@ -24439,7 +24945,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 15
+        "line": 31
       },
       "name": "RioFargateServiceProps",
       "namespace": "fargate",
@@ -24453,7 +24959,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 54
+            "line": 70
           },
           "name": "containerDefinitionOption",
           "type": {
@@ -24469,7 +24975,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 59
+            "line": 75
           },
           "name": "fargateOptions",
           "type": {
@@ -24485,7 +24991,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 24
+            "line": 40
           },
           "name": "serviceName",
           "type": {
@@ -24501,7 +25007,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 19
+            "line": 35
           },
           "name": "stage",
           "type": {
@@ -24517,7 +25023,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 29
+            "line": 45
           },
           "name": "version",
           "type": {
@@ -24533,7 +25039,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 41
+            "line": 57
           },
           "name": "vpc",
           "type": {
@@ -24551,7 +25057,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 49
+            "line": 65
           },
           "name": "cluster",
           "optional": true,
@@ -24568,7 +25074,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 69
+            "line": 85
           },
           "name": "datadogOptions",
           "optional": true,
@@ -24586,7 +25092,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 36
+            "line": 52
           },
           "name": "frameworks",
           "optional": true,
@@ -24608,7 +25114,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 64
+            "line": 80
           },
           "name": "loadBalancerOptions",
           "optional": true,
@@ -24619,6 +25125,200 @@
       ],
       "symbolId": "src/fargate/rio-fargate-service:RioFargateServiceProps"
     },
+    "@rio-cloud/cdk-v2-constructs.fargate.TargetPerSecondTraceSamplingOptions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Configure Datadog Agent target sampling."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.fargate.TargetPerSecondTraceSamplingOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 61
+      },
+      "name": "TargetPerSecondTraceSamplingOptions",
+      "namespace": "fargate",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The sampling strategy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 63
+          },
+          "name": "mode",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.TraceSamplingMode"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Traffic spikes\ncan exceed this target; it is not a hard cap on total ingestion.",
+            "stability": "stable",
+            "summary": "The average head-sampling target in traces per second for each Agent sidecar (and therefore each Fargate service instance)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 70
+          },
+          "name": "targetTracesPerSecond",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This does not cap error traces already kept by head sampling.",
+            "stability": "stable",
+            "summary": "The budget for additional local error trace chunks per second missed by head sampling, for each Agent sidecar (and therefore each Fargate service instance)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 77
+          },
+          "name": "errorTracesPerSecond",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "src/fargate/trace-sampling:TargetPerSecondTraceSamplingOptions"
+    },
+    "@rio-cloud/cdk-v2-constructs.fargate.TraceSamplingMode": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "stability": "stable",
+        "summary": "The trace sampling strategy used by the Fargate Datadog integration."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.fargate.TraceSamplingMode",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 7
+      },
+      "members": [
+        {
+          "docs": {
+            "remarks": "Target-per-second sampling is a practical default for both low- and\nhigh-traffic services.",
+            "stability": "stable",
+            "summary": "Use RIO's per-Agent head-sampling target of 5 traces/sec and an additional error-sampling budget of 10 local error trace chunks/sec."
+          },
+          "name": "DEFAULT"
+        },
+        {
+          "docs": {
+            "remarks": "retain Datadog's defaults.",
+            "stability": "stable",
+            "summary": "Do not set sampling environment variables;"
+          },
+          "name": "DATADOG_DEFAULT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set a fixed sampling rule on the application tracer."
+          },
+          "name": "FIXED_RATE"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set a per-Agent target number of traces per second."
+          },
+          "name": "TARGET_PER_SECOND"
+        }
+      ],
+      "name": "TraceSamplingMode",
+      "namespace": "fargate",
+      "symbolId": "src/fargate/trace-sampling:TraceSamplingMode"
+    },
+    "@rio-cloud/cdk-v2-constructs.fargate.TraceSamplingValidator": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.fargate.TraceSamplingValidator",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/fargate/trace-sampling.ts",
+          "line": 101
+        },
+        "parameters": [
+          {
+            "name": "traceSampling",
+            "optional": true,
+            "type": {
+              "union": {
+                "types": [
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.RioDefaultTraceSamplingOptions"
+                  },
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.DatadogDefaultTraceSamplingOptions"
+                  },
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.FixedRateTraceSamplingOptions"
+                  },
+                  {
+                    "fqn": "@rio-cloud/cdk-v2-constructs.TargetPerSecondTraceSamplingOptions"
+                  }
+                ]
+              }
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "constructs.IValidation"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/fargate/trace-sampling.ts",
+        "line": 100
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "This method can be implemented by derived constructs in order to perform\nvalidation logic. It is called on all constructs before synthesis.",
+            "stability": "stable",
+            "summary": "Validate the current construct."
+          },
+          "locationInModule": {
+            "filename": "src/fargate/trace-sampling.ts",
+            "line": 103
+          },
+          "name": "validate",
+          "overrides": "constructs.IValidation",
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        }
+      ],
+      "name": "TraceSamplingValidator",
+      "namespace": "fargate",
+      "symbolId": "src/fargate/trace-sampling:TraceSamplingValidator"
+    },
     "@rio-cloud/cdk-v2-constructs.kafka.KafkaAclStatement": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "datatype": true,
@@ -26391,5 +27091,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "6fVhuhRPQgQKnQtiW4/ZqFEConidQeW9Ui/E5tNsv+4="
+  "fingerprint": "4X97qlXFrbEDNsy539F3VpyRPpndxN1z+9G/Jky/g1w="
 }