@odigos/aws-cdk 0.0.16 → 0.0.18

package/.jsii

@@ -3887,7 +3887,7 @@
           "abstract": true,
           "docs": {
             "default": "- no headers",
-            "remarks": "These are rendered into `OPENTELEMETRY_COLLECTOR_CONFIG_URI`, which is a plain Lambda environment\nvariable: readable by anyone with `lambda:GetFunctionConfiguration` and visible in the console. For a\nlong-lived credential prefer a destination that authenticates by network position, or terminate at a\ncollector you control.\n\nOn ECS Fargate they are rendered into `OTEL_EXPORTER_OTLP_HEADERS` on the instrumented container,\nwith the same exposure — `ecs:DescribeTaskDefinition` and the console. Note that the connector does\nNOT set that variable when it instruments a Fargate task itself, and does not compare it, so this is\nneither reconciled nor reported as drift either way: it is here because an authenticated destination\nis otherwise unreachable from a task, which has no collector of its own to hold the credential.",
+            "remarks": "These are included in compact `ODIGOS_LAMBDA_CONFIG`, which is a plain Lambda environment\nvariable: readable by anyone with `lambda:GetFunctionConfiguration` and visible in the console. For a\nlong-lived credential prefer a destination that authenticates by network position, or terminate at a\ncollector you control.\n\nOn ECS Fargate they are rendered into `OTEL_EXPORTER_OTLP_HEADERS` on the instrumented container,\nwith the same exposure — `ecs:DescribeTaskDefinition` and the console. Note that the connector does\nNOT set that variable when it instruments a Fargate task itself, and does not compare it, so this is\nneither reconciled nor reported as drift either way: it is here because an authenticated destination\nis otherwise unreachable from a task, which has no collector of its own to hold the credential.",
             "stability": "stable",
             "summary": "Per-request headers, in practice the destination's credential."
           },
@@ -3982,6 +3982,25 @@
             "primitive": "boolean"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "Current language bundles do not generate OTLP profiles;\nenabling this emits a warning and does not activate a profiler.",
+            "stability": "stable",
+            "summary": "Retains profiling intent."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/types.ts",
+            "line": 244
+          },
+          "name": "profiles",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4019,7 +4038,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate.ts",
-          "line": 277
+          "line": 274
         },
         "parameters": [
           {
@@ -4045,7 +4064,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate.ts",
-        "line": 271
+        "line": 268
       },
       "methods": [
         {
@@ -4056,7 +4075,7 @@
           },
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 303
+            "line": 300
           },
           "name": "instrument",
           "parameters": [
@@ -4075,7 +4094,7 @@
           },
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 341
+            "line": 338
           },
           "name": "instrumentAll",
           "parameters": [
@@ -4107,7 +4126,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate.ts",
-        "line": 91
+        "line": 88
       },
       "name": "OdigosFargateInstrumentationOptions",
       "properties": [
@@ -4121,7 +4140,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 99
+            "line": 96
           },
           "name": "destination",
           "type": {
@@ -4139,7 +4158,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 117
+            "line": 114
           },
           "name": "agentsImage",
           "optional": true,
@@ -4158,7 +4177,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 128
+            "line": 125
           },
           "name": "debug",
           "optional": true,
@@ -4183,7 +4202,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate.ts",
-        "line": 201
+        "line": 198
       },
       "name": "OdigosFargateInstrumentationProps",
       "properties": [
@@ -4198,7 +4217,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 207
+            "line": 204
           },
           "name": "targets",
           "optional": true,
@@ -4289,7 +4308,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/fargate.ts",
-        "line": 134
+        "line": 131
       },
       "name": "OdigosFargateTarget",
       "properties": [
@@ -4303,7 +4322,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 139
+            "line": 136
           },
           "name": "container",
           "type": {
@@ -4320,7 +4339,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 147
+            "line": 144
           },
           "name": "language",
           "type": {
@@ -4338,7 +4357,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 195
+            "line": 192
           },
           "name": "existingLoaderValue",
           "optional": true,
@@ -4357,7 +4376,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 182
+            "line": 179
           },
           "name": "runtimeVersion",
           "optional": true,
@@ -4376,7 +4395,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 172
+            "line": 169
           },
           "name": "service",
           "optional": true,
@@ -4395,7 +4414,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate.ts",
-            "line": 161
+            "line": 158
           },
           "name": "serviceName",
           "optional": true,
@@ -4420,7 +4439,7 @@
         },
         "locationInModule": {
           "filename": "src/instrumentation.ts",
-          "line": 386
+          "line": 385
         },
         "parameters": [
           {
@@ -4447,7 +4466,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/instrumentation.ts",
-        "line": 378
+        "line": 377
       },
       "methods": [
         {
@@ -4457,7 +4476,7 @@
           },
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 393
+            "line": 392
           },
           "name": "visit",
           "overrides": "aws-cdk-lib.IAspect",
@@ -4488,7 +4507,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/instrumentation.ts",
-        "line": 359
+        "line": 358
       },
       "name": "OdigosInstrumentationAspectProps",
       "symbolId": "src/instrumentation:OdigosInstrumentationAspectProps"
@@ -4538,7 +4557,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/instrumentation.ts",
-        "line": 85
+        "line": 54
       },
       "name": "OdigosInstrumentationOptions",
       "properties": [
@@ -4551,13 +4570,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 89
+            "line": 58
           },
           "name": "destination",
           "type": {
             "fqn": "@odigos/aws-cdk.OdigosDestination"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- resolved from layerSource for ADOT",
+            "remarks": "Upstream SDK layers already include their collector and do not use this option.",
+            "stability": "stable",
+            "summary": "Architecture-matched collector layer when supplying a custom ADOT SDK layer."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/instrumentation.ts",
+            "line": 132
+          },
+          "name": "collectorLayerVersion",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.ILayerVersion"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4569,7 +4607,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 141
+            "line": 115
           },
           "name": "debug",
           "optional": true,
@@ -4577,6 +4615,24 @@
             "primitive": "boolean"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- the bundled default distribution for the function's runtime",
+            "stability": "stable",
+            "summary": "Connector GraphQL distro name, such as java-lambda-otel-agent or java-lambda-otel-wrapper."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/instrumentation.ts",
+            "line": 82
+          },
+          "name": "distro",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4588,7 +4644,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 163
+            "line": 144
           },
           "name": "existingLoaderValue",
           "optional": true,
@@ -4599,15 +4655,14 @@
         {
           "abstract": true,
           "docs": {
-            "default": "OdigosJavaHandlerDistro.OTEL_HANDLER",
-            "remarks": "Ignored for other languages.",
-            "stability": "stable",
-            "summary": "Which of the Java layer's four wrapper scripts to use."
+            "deprecated": "Use the corresponding java-lambda-otel-*-wrapper distro.",
+            "stability": "deprecated",
+            "summary": "Legacy lightweight Java handler adapter."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 114
+            "line": 88
           },
           "name": "javaHandlerDistro",
           "optional": true,
@@ -4625,7 +4680,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 96
+            "line": 65
           },
           "name": "layerSource",
           "optional": true,
@@ -4644,7 +4699,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 151
+            "line": 125
           },
           "name": "layerVersion",
           "optional": true,
@@ -4663,7 +4718,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 107
+            "line": 76
           },
           "name": "mode",
           "optional": true,
@@ -4682,7 +4737,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 129
+            "line": 103
           },
           "name": "serviceName",
           "optional": true,
@@ -4701,7 +4756,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 174
+            "line": 155
           },
           "name": "skipUnsupportedRuntimes",
           "optional": true,
@@ -4763,7 +4818,7 @@
       "assembly": "@odigos/aws-cdk",
       "base": "constructs.Construct",
       "docs": {
-        "remarks": "```ts\nconst odigos = new OdigosLambdaInstrumentation(this, 'Odigos', {\n  destination: { endpoint: 'otlp.example.com:4317' },\n  functions: [apiFn, workerFn],\n});\nodigos.instrument(anotherFn);\n```\n\nWhat it does to each function: attaches the layer for the function's language and architecture, sets\n`AWS_LAMBDA_EXEC_WRAPPER` so the layer loads the SDK, sets `OTEL_SERVICE_NAME`, and hands the in-Lambda\ncollector its entire configuration inline through `OPENTELEMETRY_COLLECTOR_CONFIG_URI`.\n\nThe function's SDK exports to the collector on localhost, not to your destination. The collector\nforwards after the handler has already returned, so a slow destination costs billed duration rather\nthan caller latency.\n\n## Do not also instrument these functions with the connector\n\nThe Odigos AWS connector instruments live functions by mutating them, and reconciles them back to its\nown desired state on every pass. A function instrumented here and also enabled as a connector source\nends up owned by both: each `cdk deploy` reasserts the CDK's environment, each reconcile reasserts the\nconnector's, and every round trip publishes a new function version.\n\nChoose one per function. This construct writes `ODIGOS_IAC` and never the connector's `ODIGOS_MANAGED`\nownership marker, so an IaC-instrumented function reports as instrumented but is not one the connector\nwill roll back — though it will happily take it over if you enable it as a source.",
+        "remarks": "```ts\nconst odigos = new OdigosLambdaInstrumentation(this, 'Odigos', {\n  destination: { endpoint: 'otlp.example.com:4317' },\n  functions: [apiFn, workerFn],\n});\nodigos.instrument(anotherFn);\n```\n\nWhat it does to each function: attaches the layer for the function's language and architecture, sets\n`AWS_LAMBDA_EXEC_WRAPPER` and compact `ODIGOS_LAMBDA_CONFIG`. The layer builds the SDK environment and\ncollector pipelines at startup; ownership and exact layer attribution are recorded in resource tags.\n\nThe function's SDK exports to the collector on localhost, not to your destination. The collector\nforwards after the handler has already returned, so a slow destination costs billed duration rather\nthan caller latency.\n\n## Do not also instrument these functions with the connector\n\nThe Odigos AWS connector instruments live functions by mutating them, and reconciles them back to its\nown desired state on every pass. A function instrumented here and also enabled as a connector source\nends up owned by both: each `cdk deploy` reasserts the CDK's environment, each reconcile reasserts the\nconnector's, and every round trip publishes a new function version.\n\nChoose one per function. This construct writes `odigos:iac` resource tags and never the connector's `odigos:managed`\nownership tag, so an IaC-instrumented function reports as instrumented but is not one the connector\nwill roll back — though it will happily take it over if you enable it as a source.",
         "stability": "stable",
         "summary": "Instruments AWS Lambda functions with the Odigos OpenTelemetry layer."
       },
@@ -4774,7 +4829,7 @@
         },
         "locationInModule": {
           "filename": "src/instrumentation.ts",
-          "line": 225
+          "line": 205
         },
         "parameters": [
           {
@@ -4800,7 +4855,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/instrumentation.ts",
-        "line": 219
+        "line": 200
       },
       "methods": [
         {
@@ -4811,7 +4866,7 @@
           },
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 265
+            "line": 245
           },
           "name": "instrument",
           "parameters": [
@@ -4830,7 +4885,7 @@
           },
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 298
+            "line": 293
           },
           "name": "instrumentAll",
           "parameters": [
@@ -4865,7 +4920,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/instrumentation.ts",
-        "line": 180
+        "line": 161
       },
       "name": "OdigosLambdaInstrumentationProps",
       "properties": [
@@ -4880,7 +4935,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/instrumentation.ts",
-            "line": 186
+            "line": 167
           },
           "name": "functions",
           "optional": true,
@@ -4930,6 +4985,6 @@
       "symbolId": "src/types:OdigosLayerSource"
     }
   },
-  "version": "0.0.16",
-  "fingerprint": "pvjcSr/Q7i2ERY7MnFXzW6blKkBUD8Km216xADkW2Uk="
+  "version": "0.0.18",
+  "fingerprint": "5/xKYOxxDpKywcwlm/8NYunPMm8n0M9yKWyb2VKFn3Q="
 }

package/lib/collector-config.d.ts

@@ -1,6 +1,6 @@
 import { OdigosDestination } from './types';
 /**
- * Renders the in-Lambda collector's complete configuration as an inline
+ * Renders the legacy in-Lambda collector configuration for validation and parity tests as an inline
  * `OPENTELEMETRY_COLLECTOR_CONFIG_URI` value.
  *
  * This is a PORT of `renderCollectorConfig` in the connector
@@ -59,8 +59,7 @@ export declare function signalEnabled(value: boolean | undefined, defaultEnabled
  * almost every destination accepts and what almost everyone instruments for; the other two are a
  * deliberate choice about the destination, so they are made deliberately.
  *
- * Turning one on is `metrics: true`. Enabling a signal also drops the `OTEL_*_EXPORTER=none` override, so
- * the SDK starts producing it again.
+ * Turning one on is `metrics: true`. Enabling a signal sets `OTEL_*_EXPORTER=otlp` explicitly.
  */
 export declare const SIGNAL_DEFAULTS: {
     traces: boolean;
@@ -79,18 +78,21 @@ export declare function resolvedSignals(dest: OdigosDestination): {
  * different endpoint grammars, so this is a genuine branch.
  */
 export declare function exporterNameFor(dest: OdigosDestination): string;
-/**
- * Returns the value a signal's `OTEL_*_EXPORTER` must hold: `none` to suppress a signal the destination
- * does not accept, or `undefined` meaning the variable must be ABSENT because the SDK's own default is
- * already what we want.
- *
- * Only the "none" side is written, because `otlp` is already every OpenTelemetry SDK's default for all
- * three signals — setting it would restate the default in three variables on every function.
- */
-export declare function exporterOverrideFor(supported: boolean): string | undefined;
+/** Explicit exporter selectors mirror the base connector policy; SDK defaults vary. */
+export declare function exporterOverrideFor(enabled: boolean): string;
+/** Per-signal transport overrides bypass the destination and must not coexist with it. */
+export declare function signalTransportOverrides(): string[];
+/** Language-specific SDK activation, shared by Lambda and Fargate. */
+export declare function signalActivation(language: string, dest: OdigosDestination): {
+    [key: string]: string;
+};
 /**
  * Renders the complete collector configuration for one destination.
  *
  * @throws if the destination names neither transport, both transports, or no signals at all.
  */
 export declare function renderCollectorConfig(dest: OdigosDestination): string;
+/** The Lambda Node layer registers only dns/http/net unless explicitly configured. */
+export declare function lambdaSignalActivation(language: string, dest: OdigosDestination): {
+    [key: string]: string;
+};