@opentelemetry/sdk-node 0.219.0 → 0.221.0

package/README.md

@@ -103,11 +103,6 @@ Deprecated, please use [logRecordProcessors](#logrecordprocessors) instead.
 
 An array of log record processors to register to the logger provider.
 
-### mergeResourceWithDefaults
-
-Merge user-provided resources with the default resource. Default `true`.
-The default will change to `false` in a future iteration of this package.
-
 ### metricReader
 
 Add a [MetricReader](../../../packages/sdk-metrics/src/export/MetricReader.ts)
@@ -128,7 +123,34 @@ or configure each instrumentation individually.
 
 ### resource
 
-Configure a resource. Resources may also be detected by using the `autoDetectResources` method of the SDK.
+A [Resource](https://opentelemetry.io/docs/specs/otel/resource/sdk/) to associate with generated telemetry.
+This resource will be use as the basis for additional resource attributes determined by [resource detectors](#resourcedetectors).
+See also the [`autoDetectResources` setting](#autodetectresources).
+
+If not specified, the [default resource](https://opentelemetry.io/docs/specs/semconv/resource/#semantic-attributes-with-sdk-provided-default-value) will be used.
+
+> [!WARNING]
+> If specifying the `resource` option, it is recommended that the default resource be included.
+> Otherwise the important `service.name` and `telemetry.sdk.*` resource attributes might not be included on telemetry,
+> which can adversely impact downstream processing or visualization.
+> The default resource can be include as follows:
+>
+> ```js
+> import { NodeSDK } from '@opentelemetry/sdk-node';
+> import { resourceFromAttributes, defaultResource } from '@opentelemetry/resources';
+> const sdk = new NodeSDK({
+>   resource: defaultResource().merge(
+>     resourceFromAttributes({
+>       'my.custom.attr': 'some value',
+>     })
+>   ),
+>   // ...
+> });
+> ```
+>
+> Alternatively, consider setting custom resource attributes via the
+> [`OTEL_RESOURCE_ATTRIBUTES`](https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/#general-sdk-configuration)
+> environment variable.
 
 ### resourceDetectors
 
@@ -174,11 +196,11 @@ An array of span processors to register to the tracer provider.
 
 ### traceExporter
 
-Configure a trace exporter. If an exporter is configured, it will be used with a [BatchSpanProcessor](../../../packages/opentelemetry-sdk-trace-base/src/platform/node/export/BatchSpanProcessor.ts). If an exporter OR span processor is not configured programmatically, this package will auto setup the default `otlp` exporter  with `http/protobuf` protocol with a `BatchSpanProcessor`.
+Configure a trace exporter. If an exporter is configured, it will be used with a [BatchSpanProcessor](../../../packages/sdk-trace/src/platform/node/export/BatchSpanProcessor.ts). If an exporter OR span processor is not configured programmatically, this package will auto setup the default `otlp` exporter  with `http/protobuf` protocol with a `BatchSpanProcessor`.
 
 ### spanLimits
 
-Configure tracing parameters. These are the same trace parameters used to [configure a tracer](../../../packages/opentelemetry-sdk-trace-base/src/types.ts#L71).
+Configure tracing parameters. These are the same trace parameters used to [configure a tracer](../../../packages/sdk-trace/src/types.ts#L20).
 
 ### serviceName
 
@@ -245,7 +267,7 @@ linkes for details:
 
 - Metric reader metrics: [MetricReaderMetrics](../../../packages//sdk-metrics/src/export/MetricReaderMetrics.ts)
 - Logger metrics: [LoggerMetrics.ts](../sdk-logs/src/LoggerMetrics.ts)
-- Span metrics: [TracerMetrics.ts](../../../packages/opentelemetry-sdk-trace-base/src/TracerMetrics.ts)
+- Span metrics: [TracerMetrics.ts](../../../packages/sdk-trace/src/TracerMetrics.ts)
 
 ## Useful links
 

package/build/src/create-from-config.d.ts

@@ -0,0 +1,11 @@
+import type { SpanLimits } from '@opentelemetry/sdk-trace';
+import type { Resource } from '@opentelemetry/resources';
+import type { AttributeLimitsConfigModel, LoggerProviderConfigModel, LogRecordExporterConfigModel, LogRecordLimitsConfigModel, LogRecordProcessorConfigModel, SpanLimitsConfigModel } from '@opentelemetry/configuration';
+import type { LogRecordExporter, LogRecordProcessor, LogRecordLimits } from '@opentelemetry/sdk-logs';
+import { LoggerProvider } from '@opentelemetry/sdk-logs';
+export declare function createLogRecordLimitsFromConfig(limits?: LogRecordLimitsConfigModel, attribute_limits?: AttributeLimitsConfigModel): LogRecordLimits | undefined;
+export declare function createLogRecordExporterFromConfig(exporter: LogRecordExporterConfigModel): LogRecordExporter;
+export declare function createLogRecordProcessorFromConfig(processor: LogRecordProcessorConfigModel): LogRecordProcessor;
+export declare function createLoggerProviderFromConfig(resource: Resource, logger_provider: LoggerProviderConfigModel, attribute_limits?: AttributeLimitsConfigModel): LoggerProvider;
+export declare function createSpanLimitsFromConfig(limits?: SpanLimitsConfigModel, attribute_limits?: AttributeLimitsConfigModel): SpanLimits | undefined;
+//# sourceMappingURL=create-from-config.d.ts.map

package/build/src/create-from-config.js

@@ -0,0 +1,207 @@
+"use strict";
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpanLimitsFromConfig = exports.createLoggerProviderFromConfig = exports.createLogRecordProcessorFromConfig = exports.createLogRecordExporterFromConfig = exports.createLogRecordLimitsFromConfig = void 0;
+/**
+ * Create SDK components from parsed declarative config.
+ * https://opentelemetry.io/docs/specs/otel/configuration/sdk/#create
+ *
+ * Dev Notes:
+ * This file exports `create<SDK Thing>FromConfig(...)` functions intended to
+ * be used by the "create" step of `startNodeSDK()`.
+ */
+const api_1 = require("@opentelemetry/api");
+const exporter_logs_otlp_http_1 = require("@opentelemetry/exporter-logs-otlp-http");
+const exporter_logs_otlp_grpc_1 = require("@opentelemetry/exporter-logs-otlp-grpc");
+const exporter_logs_otlp_proto_1 = require("@opentelemetry/exporter-logs-otlp-proto");
+const otlp_exporter_base_1 = require("@opentelemetry/otlp-exporter-base");
+const sdk_logs_1 = require("@opentelemetry/sdk-logs");
+const utils_1 = require("./utils");
+// ---- internal utilities
+/**
+ * Warn if some props from a declarative config object have not been handled.
+ *
+ * This is intended to be used by `create*FromConfig()` functions. It is a low
+ * tech mechanism to add awareness when a given valid config is not being
+ * completely handled. This could help when properties are added to the
+ * configuration schema. (A higher tech mechanism that wraps the parsed
+ * configuration during `create()` and watches for untouched properties
+ * might be nice.)
+ */
+function checkConfigUse(name, props, handledProps) {
+    if (!props)
+        return;
+    // Dev note: I'd use Set#difference, but that requires Node.js v22.
+    const unhandledProps = Object.keys(props).filter(k => !handledProps.includes(k));
+    if (unhandledProps.length > 0) {
+        api_1.diag.warn(`Config warning: some specified ${name} configuration properties were not handled by SDK setup: ${JSON.stringify(unhandledProps)}`);
+    }
+}
+/**
+ * Return the single non-undefined entry in the given config object, or throw.
+ *
+ * It is common for Declarative Configuration to have config objects with
+ * a single entry, e.g.
+ *
+ *    "LogRecordProcessor": {
+ *      "type": "object",
+ *      "additionalProperties": {
+ *        "type": [
+ *          "object",
+ *          "null"
+ *        ]
+ *      },
+ *      "minProperties": 1,
+ *      "maxProperties": 1,
+ *
+ * The TypeScript types cannot express the minProperties/maxProperties from the
+ * JSON schema. We guard against that here.
+ */
+function mustSingleEntry(configObj, configTypeName) {
+    const entries = Object.entries(configObj).filter(([_name, properties]) => properties !== undefined);
+    if (entries.length !== 1) {
+        const entryNames = entries.map(e => e[0]);
+        throw Error(`invalid ${configTypeName} in configuration: must have exactly one entry: entries=${JSON.stringify(entryNames)}`);
+    }
+    return entries[0];
+}
+// ---- create<SDKThing>FromConfig functions
+function createLogRecordLimitsFromConfig(limits, attribute_limits) {
+    if (!limits && !attribute_limits) {
+        return undefined;
+    }
+    return {
+        attributeValueLengthLimit: limits?.attribute_value_length_limit ??
+            attribute_limits?.attribute_value_length_limit ??
+            undefined,
+        attributeCountLimit: limits?.attribute_count_limit ??
+            attribute_limits?.attribute_count_limit ??
+            undefined,
+    };
+}
+exports.createLogRecordLimitsFromConfig = createLogRecordLimitsFromConfig;
+function createLogRecordExporterFromConfig(exporter) {
+    const [name, properties] = mustSingleEntry(exporter, 'LogRecordExporter');
+    switch (name) {
+        case 'otlp_http': {
+            checkConfigUse('LogRecordExporter', properties, [
+                'compression',
+                'endpoint',
+                'headers',
+                'timeout',
+                'tls',
+                'encoding',
+            ]);
+            const props = properties;
+            const commonOpts = {
+                compression: props?.compression === 'gzip'
+                    ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
+                    : otlp_exporter_base_1.CompressionAlgorithm.NONE,
+                url: props?.endpoint ?? undefined,
+                headers: (0, utils_1.getHeadersFromConfiguration)(props?.headers),
+                timeoutMillis: (0, utils_1.validateExporterTimeout)(props?.timeout),
+                httpAgentOptions: (0, utils_1.getHttpAgentOptionsFromTls)(props?.tls),
+            };
+            const encoding = props?.encoding ?? 'protobuf';
+            switch (encoding) {
+                case 'json':
+                    return new exporter_logs_otlp_http_1.OTLPLogExporter(commonOpts);
+                case 'protobuf':
+                    return new exporter_logs_otlp_proto_1.OTLPLogExporter(commonOpts);
+                default:
+                    throw new Error(`unknown OtlpHttpExporter encoding in configuration: "${encoding}"`);
+            }
+        }
+        case 'otlp_grpc': {
+            checkConfigUse('LogRecordExporter', properties, [
+                'compression',
+                'endpoint',
+                'timeout',
+                'tls',
+                'headers',
+            ]);
+            const props = properties;
+            return new exporter_logs_otlp_grpc_1.OTLPLogExporter({
+                compression: props?.compression === 'gzip'
+                    ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
+                    : otlp_exporter_base_1.CompressionAlgorithm.NONE,
+                url: props?.endpoint ?? undefined,
+                timeoutMillis: (0, utils_1.validateExporterTimeout)(props?.timeout),
+                credentials: (0, utils_1.getGrpcCredentialsFromTls)(props?.tls),
+                metadata: (0, utils_1.getGrpcMetadataFromHeaders)(props?.headers),
+            });
+        }
+        case 'console':
+            return new sdk_logs_1.ConsoleLogRecordExporter();
+        default:
+            throw new Error(`unknown LogRecordExporter name in configuration: "${name}"`);
+    }
+}
+exports.createLogRecordExporterFromConfig = createLogRecordExporterFromConfig;
+function createLogRecordProcessorFromConfig(processor) {
+    const [name, properties] = mustSingleEntry(processor, 'LogRecordProcessor');
+    switch (name) {
+        case 'batch': {
+            checkConfigUse('BatchLogRecordProcessor', properties, [
+                'exporter',
+                'max_queue_size',
+                'max_export_batch_size',
+                'schedule_delay',
+                'export_timeout',
+            ]);
+            const props = properties;
+            const exporter = createLogRecordExporterFromConfig(props.exporter);
+            return new sdk_logs_1.BatchLogRecordProcessor({
+                exporter,
+                maxQueueSize: props.max_queue_size ?? undefined,
+                maxExportBatchSize: props.max_export_batch_size ?? undefined,
+                scheduledDelayMillis: props.schedule_delay ?? undefined,
+                exportTimeoutMillis: props.export_timeout ?? undefined,
+            });
+        }
+        case 'simple': {
+            const props = properties;
+            const exporter = createLogRecordExporterFromConfig(props.exporter);
+            return new sdk_logs_1.SimpleLogRecordProcessor({ exporter });
+        }
+        default:
+            throw new Error(`unknown LogRecordProcessor name: "${name}"`);
+    }
+}
+exports.createLogRecordProcessorFromConfig = createLogRecordProcessorFromConfig;
+function createLoggerProviderFromConfig(resource, logger_provider, attribute_limits) {
+    const processors = logger_provider.processors.map(p => createLogRecordProcessorFromConfig(p));
+    const logRecordLimits = createLogRecordLimitsFromConfig(logger_provider.limits, attribute_limits);
+    checkConfigUse('LoggerProvider', logger_provider, ['processors', 'limits']);
+    return new sdk_logs_1.LoggerProvider({
+        resource,
+        processors,
+        logRecordLimits,
+        // TODO: loggerConfigurator
+        // TODO: meterProvider
+        // Note: forceFlushTimeoutMillis not configurable via decl conf.
+    });
+}
+exports.createLoggerProviderFromConfig = createLoggerProviderFromConfig;
+function createSpanLimitsFromConfig(limits, attribute_limits) {
+    if (!limits && !attribute_limits) {
+        return undefined;
+    }
+    return {
+        attributeValueLengthLimit: limits?.attribute_value_length_limit ??
+            attribute_limits?.attribute_value_length_limit ??
+            undefined,
+        attributeCountLimit: limits?.attribute_count_limit ??
+            attribute_limits?.attribute_count_limit ??
+            undefined,
+        eventCountLimit: limits?.event_count_limit ?? undefined,
+        linkCountLimit: limits?.link_count_limit ?? undefined,
+        attributePerEventCountLimit: limits?.event_attribute_count_limit ?? undefined,
+        attributePerLinkCountLimit: limits?.link_attribute_count_limit ?? undefined,
+    };
+}
+exports.createSpanLimitsFromConfig = createSpanLimitsFromConfig;
+//# sourceMappingURL=create-from-config.js.map

package/build/src/create-from-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-from-config.js","sourceRoot":"","sources":["../../src/create-from-config.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Create SDK components from parsed declarative config.\n * https://opentelemetry.io/docs/specs/otel/configuration/sdk/#create\n *\n * Dev Notes:\n * This file exports `create<SDK Thing>FromConfig(...)` functions intended to\n * be used by the \"create\" step of `startNodeSDK()`.\n */\n\nimport { diag } from '@opentelemetry/api';\nimport type { SpanLimits } from '@opentelemetry/sdk-trace';\nimport type { Resource } from '@opentelemetry/resources';\nimport { OTLPLogExporter as OTLPHttpLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { OTLPLogExporter as OTLPGrpcLogExporter } from '@opentelemetry/exporter-logs-otlp-grpc';\nimport { OTLPLogExporter as OTLPProtoLogExporter } from '@opentelemetry/exporter-logs-otlp-proto';\nimport { CompressionAlgorithm } from '@opentelemetry/otlp-exporter-base';\nimport type {\n  AttributeLimitsConfigModel,\n  BatchLogRecordProcessorConfigModel,\n  LoggerProviderConfigModel,\n  LogRecordExporterConfigModel,\n  LogRecordLimitsConfigModel,\n  LogRecordProcessorConfigModel,\n  OtlpGrpcExporterConfigModel,\n  OtlpHttpExporterConfigModel,\n  SimpleLogRecordProcessorConfigModel,\n  SpanLimitsConfigModel,\n} from '@opentelemetry/configuration';\nimport type {\n  LogRecordExporter,\n  LogRecordProcessor,\n  LogRecordLimits,\n} from '@opentelemetry/sdk-logs';\nimport {\n  BatchLogRecordProcessor,\n  ConsoleLogRecordExporter,\n  SimpleLogRecordProcessor,\n  LoggerProvider,\n} from '@opentelemetry/sdk-logs';\n\nimport {\n  getGrpcCredentialsFromTls,\n  getGrpcMetadataFromHeaders,\n  getHeadersFromConfiguration,\n  getHttpAgentOptionsFromTls,\n  validateExporterTimeout,\n} from './utils';\n\n// ---- internal utilities\n\n/**\n * Warn if some props from a declarative config object have not been handled.\n *\n * This is intended to be used by `create*FromConfig()` functions. It is a low\n * tech mechanism to add awareness when a given valid config is not being\n * completely handled. This could help when properties are added to the\n * configuration schema. (A higher tech mechanism that wraps the parsed\n * configuration during `create()` and watches for untouched properties\n * might be nice.)\n */\nfunction checkConfigUse(\n  name: string,\n  props: object | undefined,\n  handledProps: string[]\n) {\n  if (!props) return;\n  // Dev note: I'd use Set#difference, but that requires Node.js v22.\n  const unhandledProps = Object.keys(props).filter(\n    k => !handledProps.includes(k)\n  );\n\n  if (unhandledProps.length > 0) {\n    diag.warn(\n      `Config warning: some specified ${name} configuration properties were not handled by SDK setup: ${JSON.stringify(unhandledProps)}`\n    );\n  }\n}\n\n/**\n * Return the single non-undefined entry in the given config object, or throw.\n *\n * It is common for Declarative Configuration to have config objects with\n * a single entry, e.g.\n *\n *    \"LogRecordProcessor\": {\n *      \"type\": \"object\",\n *      \"additionalProperties\": {\n *        \"type\": [\n *          \"object\",\n *          \"null\"\n *        ]\n *      },\n *      \"minProperties\": 1,\n *      \"maxProperties\": 1,\n *\n * The TypeScript types cannot express the minProperties/maxProperties from the\n * JSON schema. We guard against that here.\n */\nfunction mustSingleEntry(\n  configObj: Record<string, unknown>,\n  configTypeName: string\n): [string, unknown] {\n  const entries = Object.entries(configObj).filter(\n    ([_name, properties]) => properties !== undefined\n  );\n\n  if (entries.length !== 1) {\n    const entryNames = entries.map(e => e[0]);\n    throw Error(\n      `invalid ${configTypeName} in configuration: must have exactly one entry: entries=${JSON.stringify(entryNames)}`\n    );\n  }\n\n  return entries[0];\n}\n\n// ---- create<SDKThing>FromConfig functions\n\nexport function createLogRecordLimitsFromConfig(\n  limits?: LogRecordLimitsConfigModel,\n  attribute_limits?: AttributeLimitsConfigModel\n): LogRecordLimits | undefined {\n  if (!limits && !attribute_limits) {\n    return undefined;\n  }\n  return {\n    attributeValueLengthLimit:\n      limits?.attribute_value_length_limit ??\n      attribute_limits?.attribute_value_length_limit ??\n      undefined,\n    attributeCountLimit:\n      limits?.attribute_count_limit ??\n      attribute_limits?.attribute_count_limit ??\n      undefined,\n  };\n}\n\nexport function createLogRecordExporterFromConfig(\n  exporter: LogRecordExporterConfigModel\n): LogRecordExporter {\n  const [name, properties] = mustSingleEntry(exporter, 'LogRecordExporter');\n\n  switch (name) {\n    case 'otlp_http': {\n      checkConfigUse('LogRecordExporter', properties!, [\n        'compression',\n        'endpoint',\n        'headers',\n        'timeout',\n        'tls',\n        'encoding',\n      ]);\n      const props = properties as OtlpHttpExporterConfigModel;\n      const commonOpts = {\n        compression:\n          props?.compression === 'gzip'\n            ? CompressionAlgorithm.GZIP\n            : CompressionAlgorithm.NONE,\n        url: props?.endpoint ?? undefined,\n        headers: getHeadersFromConfiguration(props?.headers),\n        timeoutMillis: validateExporterTimeout(props?.timeout),\n        httpAgentOptions: getHttpAgentOptionsFromTls(props?.tls),\n      };\n      const encoding = props?.encoding ?? 'protobuf';\n      switch (encoding) {\n        case 'json':\n          return new OTLPHttpLogExporter(commonOpts);\n        case 'protobuf':\n          return new OTLPProtoLogExporter(commonOpts);\n        default:\n          throw new Error(\n            `unknown OtlpHttpExporter encoding in configuration: \"${encoding}\"`\n          );\n      }\n    }\n\n    case 'otlp_grpc': {\n      checkConfigUse('LogRecordExporter', properties!, [\n        'compression',\n        'endpoint',\n        'timeout',\n        'tls',\n        'headers',\n      ]);\n      const props = properties as OtlpGrpcExporterConfigModel;\n      return new OTLPGrpcLogExporter({\n        compression:\n          props?.compression === 'gzip'\n            ? CompressionAlgorithm.GZIP\n            : CompressionAlgorithm.NONE,\n        url: props?.endpoint ?? undefined,\n        timeoutMillis: validateExporterTimeout(props?.timeout),\n        credentials: getGrpcCredentialsFromTls(props?.tls),\n        metadata: getGrpcMetadataFromHeaders(props?.headers),\n      });\n    }\n\n    case 'console':\n      return new ConsoleLogRecordExporter();\n\n    default:\n      throw new Error(\n        `unknown LogRecordExporter name in configuration: \"${name}\"`\n      );\n  }\n}\n\nexport function createLogRecordProcessorFromConfig(\n  processor: LogRecordProcessorConfigModel\n): LogRecordProcessor {\n  const [name, properties] = mustSingleEntry(processor, 'LogRecordProcessor');\n\n  switch (name) {\n    case 'batch': {\n      checkConfigUse('BatchLogRecordProcessor', properties!, [\n        'exporter',\n        'max_queue_size',\n        'max_export_batch_size',\n        'schedule_delay',\n        'export_timeout',\n      ]);\n      const props = properties as BatchLogRecordProcessorConfigModel;\n      const exporter = createLogRecordExporterFromConfig(props.exporter);\n      return new BatchLogRecordProcessor({\n        exporter,\n        maxQueueSize: props.max_queue_size ?? undefined,\n        maxExportBatchSize: props.max_export_batch_size ?? undefined,\n        scheduledDelayMillis: props.schedule_delay ?? undefined,\n        exportTimeoutMillis: props.export_timeout ?? undefined,\n      });\n    }\n\n    case 'simple': {\n      const props = properties as SimpleLogRecordProcessorConfigModel;\n      const exporter = createLogRecordExporterFromConfig(props.exporter);\n      return new SimpleLogRecordProcessor({ exporter });\n    }\n\n    default:\n      throw new Error(`unknown LogRecordProcessor name: \"${name}\"`);\n  }\n}\n\nexport function createLoggerProviderFromConfig(\n  resource: Resource,\n  logger_provider: LoggerProviderConfigModel,\n  attribute_limits?: AttributeLimitsConfigModel\n): LoggerProvider {\n  const processors = logger_provider.processors.map(p =>\n    createLogRecordProcessorFromConfig(p)\n  );\n  const logRecordLimits = createLogRecordLimitsFromConfig(\n    logger_provider.limits,\n    attribute_limits\n  );\n  checkConfigUse('LoggerProvider', logger_provider, ['processors', 'limits']);\n\n  return new LoggerProvider({\n    resource,\n    processors,\n    logRecordLimits,\n    // TODO: loggerConfigurator\n    // TODO: meterProvider\n    // Note: forceFlushTimeoutMillis not configurable via decl conf.\n  });\n}\n\nexport function createSpanLimitsFromConfig(\n  limits?: SpanLimitsConfigModel,\n  attribute_limits?: AttributeLimitsConfigModel\n): SpanLimits | undefined {\n  if (!limits && !attribute_limits) {\n    return undefined;\n  }\n  return {\n    attributeValueLengthLimit:\n      limits?.attribute_value_length_limit ??\n      attribute_limits?.attribute_value_length_limit ??\n      undefined,\n    attributeCountLimit:\n      limits?.attribute_count_limit ??\n      attribute_limits?.attribute_count_limit ??\n      undefined,\n    eventCountLimit: limits?.event_count_limit ?? undefined,\n    linkCountLimit: limits?.link_count_limit ?? undefined,\n    attributePerEventCountLimit:\n      limits?.event_attribute_count_limit ?? undefined,\n    attributePerLinkCountLimit: limits?.link_attribute_count_limit ?? undefined,\n  };\n}\n"]}

package/build/src/create-from-env.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Create SDK components from environment variable settings.
+ * https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/
+ */
+import type { MeterProvider } from '@opentelemetry/api';
+import type { Sampler, SpanExporter, SpanLimits } from '@opentelemetry/sdk-trace';
+import { BatchSpanProcessor } from '@opentelemetry/sdk-trace';
+export declare function createSamplerFromEnv(): Sampler | undefined;
+export declare function createSpanLimitsFromEnv(): SpanLimits | undefined;
+export declare function createBatchSpanProcessorFromEnv(exporter: SpanExporter, selfObsMeterProvider?: MeterProvider): BatchSpanProcessor;
+//# sourceMappingURL=create-from-env.d.ts.map

package/build/src/create-from-env.js

@@ -0,0 +1,80 @@
+"use strict";
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBatchSpanProcessorFromEnv = exports.createSpanLimitsFromEnv = exports.createSamplerFromEnv = void 0;
+const api_1 = require("@opentelemetry/api");
+const core_1 = require("@opentelemetry/core");
+const sdk_trace_1 = require("@opentelemetry/sdk-trace");
+const sdk_trace_2 = require("@opentelemetry/sdk-trace");
+const utils_1 = require("./utils");
+const DEFAULT_RATIO = 1;
+function createSamplerFromEnv() {
+    const samplerName = (0, core_1.getStringFromEnv)('OTEL_TRACES_SAMPLER');
+    if (samplerName === undefined) {
+        return undefined;
+    }
+    switch (samplerName) {
+        case 'always_on':
+            return new sdk_trace_2.AlwaysOnSampler();
+        case 'always_off':
+            return new sdk_trace_2.AlwaysOffSampler();
+        case 'parentbased_always_on':
+            return new sdk_trace_2.ParentBasedSampler({
+                root: new sdk_trace_2.AlwaysOnSampler(),
+            });
+        case 'parentbased_always_off':
+            return new sdk_trace_2.ParentBasedSampler({
+                root: new sdk_trace_2.AlwaysOffSampler(),
+            });
+        case 'traceidratio':
+            return new sdk_trace_2.TraceIdRatioBasedSampler(getSamplerRatioFromEnv());
+        case 'parentbased_traceidratio':
+            return new sdk_trace_2.ParentBasedSampler({
+                root: new sdk_trace_2.TraceIdRatioBasedSampler(getSamplerRatioFromEnv()),
+            });
+        default:
+            api_1.diag.error(`unknown OTEL_TRACES_SAMPLER value "${samplerName}", using default`);
+            return undefined;
+    }
+}
+exports.createSamplerFromEnv = createSamplerFromEnv;
+function getSamplerRatioFromEnv() {
+    const ratio = (0, core_1.getNumberFromEnv)('OTEL_TRACES_SAMPLER_ARG');
+    if (ratio == null) {
+        api_1.diag.error(`OTEL_TRACES_SAMPLER_ARG is blank, defaulting to ${DEFAULT_RATIO}.`);
+        return DEFAULT_RATIO;
+    }
+    if (ratio < 0 || ratio > 1) {
+        api_1.diag.error(`OTEL_TRACES_SAMPLER_ARG=${ratio} was given, but it is out of range ([0..1]), defaulting to ${DEFAULT_RATIO}.`);
+        return DEFAULT_RATIO;
+    }
+    return ratio;
+}
+function createSpanLimitsFromEnv() {
+    return {
+        attributeCountLimit: (0, core_1.getNumberFromEnv)('OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT') ??
+            (0, core_1.getNumberFromEnv)('OTEL_ATTRIBUTE_COUNT_LIMIT'),
+        attributeValueLengthLimit: (0, core_1.getNumberFromEnv)('OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT') ??
+            (0, core_1.getNumberFromEnv)('OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT'),
+        eventCountLimit: (0, core_1.getNumberFromEnv)('OTEL_SPAN_EVENT_COUNT_LIMIT'),
+        linkCountLimit: (0, core_1.getNumberFromEnv)('OTEL_SPAN_LINK_COUNT_LIMIT'),
+        attributePerEventCountLimit: (0, core_1.getNumberFromEnv)('OTEL_SPAN_ATTRIBUTE_PER_EVENT_COUNT_LIMIT'),
+        attributePerLinkCountLimit: (0, core_1.getNumberFromEnv)('OTEL_SPAN_ATTRIBUTE_PER_LINK_COUNT_LIMIT'),
+    };
+}
+exports.createSpanLimitsFromEnv = createSpanLimitsFromEnv;
+function createBatchSpanProcessorFromEnv(exporter, selfObsMeterProvider) {
+    return new sdk_trace_1.BatchSpanProcessor({
+        exporter,
+        selfObsMeterProvider,
+        maxQueueSize: (0, utils_1.getNonNegativeNumberFromEnv)('OTEL_BSP_MAX_QUEUE_SIZE'),
+        scheduledDelayMillis: (0, utils_1.getNonNegativeNumberFromEnv)('OTEL_BSP_SCHEDULE_DELAY'),
+        exportTimeoutMillis: (0, utils_1.getNonNegativeNumberFromEnv)('OTEL_BSP_EXPORT_TIMEOUT'),
+        maxExportBatchSize: (0, utils_1.getNonNegativeNumberFromEnv)('OTEL_BSP_MAX_EXPORT_BATCH_SIZE'),
+    });
+}
+exports.createBatchSpanProcessorFromEnv = createBatchSpanProcessorFromEnv;
+//# sourceMappingURL=create-from-env.js.map

package/build/src/create-from-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-from-env.js","sourceRoot":"","sources":["../../src/create-from-env.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,4CAA0C;AAC1C,8CAAyE;AAMzE,wDAA8D;AAC9D,wDAKkC;AAClC,mCAAsD;AAEtD,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,SAAgB,oBAAoB;IAClC,MAAM,WAAW,GAAG,IAAA,uBAAgB,EAAC,qBAAqB,CAAC,CAAC;IAC5D,IAAI,WAAW,KAAK,SAAS,EAAE;QAC7B,OAAO,SAAS,CAAC;KAClB;IACD,QAAQ,WAAW,EAAE;QACnB,KAAK,WAAW;YACd,OAAO,IAAI,2BAAe,EAAE,CAAC;QAC/B,KAAK,YAAY;YACf,OAAO,IAAI,4BAAgB,EAAE,CAAC;QAChC,KAAK,uBAAuB;YAC1B,OAAO,IAAI,8BAAkB,CAAC;gBAC5B,IAAI,EAAE,IAAI,2BAAe,EAAE;aAC5B,CAAC,CAAC;QACL,KAAK,wBAAwB;YAC3B,OAAO,IAAI,8BAAkB,CAAC;gBAC5B,IAAI,EAAE,IAAI,4BAAgB,EAAE;aAC7B,CAAC,CAAC;QACL,KAAK,cAAc;YACjB,OAAO,IAAI,oCAAwB,CAAC,sBAAsB,EAAE,CAAC,CAAC;QAChE,KAAK,0BAA0B;YAC7B,OAAO,IAAI,8BAAkB,CAAC;gBAC5B,IAAI,EAAE,IAAI,oCAAwB,CAAC,sBAAsB,EAAE,CAAC;aAC7D,CAAC,CAAC;QACL;YACE,UAAI,CAAC,KAAK,CACR,sCAAsC,WAAW,kBAAkB,CACpE,CAAC;YACF,OAAO,SAAS,CAAC;KACpB;AACH,CAAC;AA9BD,oDA8BC;AAED,SAAS,sBAAsB;IAC7B,MAAM,KAAK,GAAG,IAAA,uBAAgB,EAAC,yBAAyB,CAAC,CAAC;IAC1D,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,UAAI,CAAC,KAAK,CACR,mDAAmD,aAAa,GAAG,CACpE,CAAC;QACF,OAAO,aAAa,CAAC;KACtB;IAED,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE;QAC1B,UAAI,CAAC,KAAK,CACR,2BAA2B,KAAK,8DAA8D,aAAa,GAAG,CAC/G,CAAC;QACF,OAAO,aAAa,CAAC;KACtB;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,uBAAuB;IACrC,OAAO;QACL,mBAAmB,EACjB,IAAA,uBAAgB,EAAC,iCAAiC,CAAC;YACnD,IAAA,uBAAgB,EAAC,4BAA4B,CAAC;QAChD,yBAAyB,EACvB,IAAA,uBAAgB,EAAC,wCAAwC,CAAC;YAC1D,IAAA,uBAAgB,EAAC,mCAAmC,CAAC;QACvD,eAAe,EAAE,IAAA,uBAAgB,EAAC,6BAA6B,CAAC;QAChE,cAAc,EAAE,IAAA,uBAAgB,EAAC,4BAA4B,CAAC;QAC9D,2BAA2B,EAAE,IAAA,uBAAgB,EAC3C,2CAA2C,CAC5C;QACD,0BAA0B,EAAE,IAAA,uBAAgB,EAC1C,0CAA0C,CAC3C;KACF,CAAC;AACJ,CAAC;AAjBD,0DAiBC;AAED,SAAgB,+BAA+B,CAC7C,QAAsB,EACtB,oBAAoC;IAEpC,OAAO,IAAI,8BAAkB,CAAC;QAC5B,QAAQ;QACR,oBAAoB;QACpB,YAAY,EAAE,IAAA,mCAA2B,EAAC,yBAAyB,CAAC;QACpE,oBAAoB,EAAE,IAAA,mCAA2B,EAC/C,yBAAyB,CAC1B;QACD,mBAAmB,EAAE,IAAA,mCAA2B,EAAC,yBAAyB,CAAC;QAC3E,kBAAkB,EAAE,IAAA,mCAA2B,EAC7C,gCAAgC,CACjC;KACF,CAAC,CAAC;AACL,CAAC;AAhBD,0EAgBC","sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Create SDK components from environment variable settings.\n * https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/\n */\n\nimport type { MeterProvider } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport { getNumberFromEnv, getStringFromEnv } from '@opentelemetry/core';\nimport type {\n  Sampler,\n  SpanExporter,\n  SpanLimits,\n} from '@opentelemetry/sdk-trace';\nimport { BatchSpanProcessor } from '@opentelemetry/sdk-trace';\nimport {\n  AlwaysOffSampler,\n  AlwaysOnSampler,\n  ParentBasedSampler,\n  TraceIdRatioBasedSampler,\n} from '@opentelemetry/sdk-trace';\nimport { getNonNegativeNumberFromEnv } from './utils';\n\nconst DEFAULT_RATIO = 1;\n\nexport function createSamplerFromEnv(): Sampler | undefined {\n  const samplerName = getStringFromEnv('OTEL_TRACES_SAMPLER');\n  if (samplerName === undefined) {\n    return undefined;\n  }\n  switch (samplerName) {\n    case 'always_on':\n      return new AlwaysOnSampler();\n    case 'always_off':\n      return new AlwaysOffSampler();\n    case 'parentbased_always_on':\n      return new ParentBasedSampler({\n        root: new AlwaysOnSampler(),\n      });\n    case 'parentbased_always_off':\n      return new ParentBasedSampler({\n        root: new AlwaysOffSampler(),\n      });\n    case 'traceidratio':\n      return new TraceIdRatioBasedSampler(getSamplerRatioFromEnv());\n    case 'parentbased_traceidratio':\n      return new ParentBasedSampler({\n        root: new TraceIdRatioBasedSampler(getSamplerRatioFromEnv()),\n      });\n    default:\n      diag.error(\n        `unknown OTEL_TRACES_SAMPLER value \"${samplerName}\", using default`\n      );\n      return undefined;\n  }\n}\n\nfunction getSamplerRatioFromEnv(): number | undefined {\n  const ratio = getNumberFromEnv('OTEL_TRACES_SAMPLER_ARG');\n  if (ratio == null) {\n    diag.error(\n      `OTEL_TRACES_SAMPLER_ARG is blank, defaulting to ${DEFAULT_RATIO}.`\n    );\n    return DEFAULT_RATIO;\n  }\n\n  if (ratio < 0 || ratio > 1) {\n    diag.error(\n      `OTEL_TRACES_SAMPLER_ARG=${ratio} was given, but it is out of range ([0..1]), defaulting to ${DEFAULT_RATIO}.`\n    );\n    return DEFAULT_RATIO;\n  }\n\n  return ratio;\n}\n\nexport function createSpanLimitsFromEnv(): SpanLimits | undefined {\n  return {\n    attributeCountLimit:\n      getNumberFromEnv('OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT') ??\n      getNumberFromEnv('OTEL_ATTRIBUTE_COUNT_LIMIT'),\n    attributeValueLengthLimit:\n      getNumberFromEnv('OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT') ??\n      getNumberFromEnv('OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT'),\n    eventCountLimit: getNumberFromEnv('OTEL_SPAN_EVENT_COUNT_LIMIT'),\n    linkCountLimit: getNumberFromEnv('OTEL_SPAN_LINK_COUNT_LIMIT'),\n    attributePerEventCountLimit: getNumberFromEnv(\n      'OTEL_SPAN_ATTRIBUTE_PER_EVENT_COUNT_LIMIT'\n    ),\n    attributePerLinkCountLimit: getNumberFromEnv(\n      'OTEL_SPAN_ATTRIBUTE_PER_LINK_COUNT_LIMIT'\n    ),\n  };\n}\n\nexport function createBatchSpanProcessorFromEnv(\n  exporter: SpanExporter,\n  selfObsMeterProvider?: MeterProvider\n): BatchSpanProcessor {\n  return new BatchSpanProcessor({\n    exporter,\n    selfObsMeterProvider,\n    maxQueueSize: getNonNegativeNumberFromEnv('OTEL_BSP_MAX_QUEUE_SIZE'),\n    scheduledDelayMillis: getNonNegativeNumberFromEnv(\n      'OTEL_BSP_SCHEDULE_DELAY'\n    ),\n    exportTimeoutMillis: getNonNegativeNumberFromEnv('OTEL_BSP_EXPORT_TIMEOUT'),\n    maxExportBatchSize: getNonNegativeNumberFromEnv(\n      'OTEL_BSP_MAX_EXPORT_BATCH_SIZE'\n    ),\n  });\n}\n"]}

package/build/src/index.d.ts

@@ -3,8 +3,14 @@ export * as contextBase from '@opentelemetry/api';
 export * as core from '@opentelemetry/core';
 export * as logs from '@opentelemetry/sdk-logs';
 export * as metrics from '@opentelemetry/sdk-metrics';
-export * as node from '@opentelemetry/sdk-trace-node';
 export * as resources from '@opentelemetry/resources';
+/**
+ * @deprecated Import directly from `@opentelemetry/sdk-trace` instead.
+ */
+export * as node from '@opentelemetry/sdk-trace-node';
+/**
+ * @deprecated Import directly from `@opentelemetry/sdk-trace` instead.
+ */
 export * as tracing from '@opentelemetry/sdk-trace-base';
 export { NodeSDK } from './sdk';
 export type { LoggerProviderConfig, MeterProviderConfig } from './sdk';

package/build/src/index.js

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startNodeSDK = exports.NodeSDK = exports.tracing = exports.resources = exports.node = exports.metrics = exports.logs = exports.core = exports.contextBase = exports.api = void 0;
+exports.startNodeSDK = exports.NodeSDK = exports.tracing = exports.node = exports.resources = exports.metrics = exports.logs = exports.core = exports.contextBase = exports.api = void 0;
 // This is a meta-package, and these exist in to re-export *all* items from
 // the individual packages as individual _namespaces_, so wildcard exports are
 // appropriate here. Otherwise, it'd be a pain to enumerate and keep things
@@ -15,8 +15,14 @@ exports.contextBase = require("@opentelemetry/api");
 exports.core = require("@opentelemetry/core");
 exports.logs = require("@opentelemetry/sdk-logs");
 exports.metrics = require("@opentelemetry/sdk-metrics");
-exports.node = require("@opentelemetry/sdk-trace-node");
 exports.resources = require("@opentelemetry/resources");
+/**
+ * @deprecated Import directly from `@opentelemetry/sdk-trace` instead.
+ */
+exports.node = require("@opentelemetry/sdk-trace-node");
+/**
+ * @deprecated Import directly from `@opentelemetry/sdk-trace` instead.
+ */
 exports.tracing = require("@opentelemetry/sdk-trace-base");
 /* eslint-enable no-restricted-syntax */
 var sdk_1 = require("./sdk");

package/build/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,0CAA0C;AAE1C,yCAAyC;AACzC,4CAA0C;AAC1C,oDAAkD;AAClD,8CAA4C;AAC5C,kDAAgD;AAChD,wDAAsD;AACtD,wDAAsD;AACtD,wDAAsD;AACtD,2DAAyD;AACzD,wCAAwC;AAExC,6BAAgC;AAAvB,8FAAA,OAAO,OAAA;AAGhB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA","sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n// This is a meta-package, and these exist in to re-export *all* items from\n// the individual packages as individual _namespaces_, so wildcard exports are\n// appropriate here. Otherwise, it'd be a pain to enumerate and keep things\n// in-sync with all the upstream packages.\n\n/* eslint-disable no-restricted-syntax */\nexport * as api from '@opentelemetry/api';\nexport * as contextBase from '@opentelemetry/api';\nexport * as core from '@opentelemetry/core';\nexport * as logs from '@opentelemetry/sdk-logs';\nexport * as metrics from '@opentelemetry/sdk-metrics';\nexport * as node from '@opentelemetry/sdk-trace-node';\nexport * as resources from '@opentelemetry/resources';\nexport * as tracing from '@opentelemetry/sdk-trace-base';\n/* eslint-enable no-restricted-syntax */\n\nexport { NodeSDK } from './sdk';\nexport type { LoggerProviderConfig, MeterProviderConfig } from './sdk';\nexport type { NodeSDKConfiguration } from './types';\nexport { startNodeSDK } from './start';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,0CAA0C;AAE1C,yCAAyC;AACzC,4CAA0C;AAC1C,oDAAkD;AAClD,8CAA4C;AAC5C,kDAAgD;AAChD,wDAAsD;AACtD,wDAAsD;AAEtD;;GAEG;AACH,wDAAsD;AACtD;;GAEG;AACH,2DAAyD;AACzD,wCAAwC;AAExC,6BAAgC;AAAvB,8FAAA,OAAO,OAAA;AAGhB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA","sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n// This is a meta-package, and these exist in to re-export *all* items from\n// the individual packages as individual _namespaces_, so wildcard exports are\n// appropriate here. Otherwise, it'd be a pain to enumerate and keep things\n// in-sync with all the upstream packages.\n\n/* eslint-disable no-restricted-syntax */\nexport * as api from '@opentelemetry/api';\nexport * as contextBase from '@opentelemetry/api';\nexport * as core from '@opentelemetry/core';\nexport * as logs from '@opentelemetry/sdk-logs';\nexport * as metrics from '@opentelemetry/sdk-metrics';\nexport * as resources from '@opentelemetry/resources';\n\n/**\n * @deprecated Import directly from `@opentelemetry/sdk-trace` instead.\n */\nexport * as node from '@opentelemetry/sdk-trace-node';\n/**\n * @deprecated Import directly from `@opentelemetry/sdk-trace` instead.\n */\nexport * as tracing from '@opentelemetry/sdk-trace-base';\n/* eslint-enable no-restricted-syntax */\n\nexport { NodeSDK } from './sdk';\nexport type { LoggerProviderConfig, MeterProviderConfig } from './sdk';\nexport type { NodeSDKConfiguration } from './types';\nexport { startNodeSDK } from './start';\n"]}

package/build/src/sdk.d.ts

@@ -36,7 +36,6 @@ export type LoggerProviderConfig = {
  *    nodeSdk.start(); // registers all configured SDK components
  */
 export declare class NodeSDK {
-    private _tracerProviderConfig?;
     private _loggerProviderConfig?;
     private _meterProviderConfig?;
     private _instrumentations;

package/build/src/sdk.js

@@ -15,11 +15,11 @@ const exporter_logs_otlp_grpc_1 = require("@opentelemetry/exporter-logs-otlp-grp
 const exporter_logs_otlp_proto_1 = require("@opentelemetry/exporter-logs-otlp-proto");
 const exporter_prometheus_1 = require("@opentelemetry/exporter-prometheus");
 const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
-const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
-const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
+const sdk_trace_1 = require("@opentelemetry/sdk-trace");
 const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
 const core_1 = require("@opentelemetry/core");
 const utils_1 = require("./utils");
+const create_from_env_1 = require("./create-from-env");
 /**
  *
  * @returns MetricReader[] if appropriate environment variables are configured
@@ -72,7 +72,6 @@ function getMetricReadersFromEnv() {
  *    nodeSdk.start(); // registers all configured SDK components
  */
 class NodeSDK {
-    _tracerProviderConfig;
     _loggerProviderConfig;
     _meterProviderConfig;
     _instrumentations;
@@ -116,30 +115,8 @@ class NodeSDK {
             this._resourceDetectors = [resources_1.envDetector, resources_1.processDetector, resources_1.hostDetector];
         }
         this._serviceName = configuration.serviceName;
-        // If a tracer provider can be created from manual configuration, create it
-        if (configuration.traceExporter ||
-            configuration.spanProcessor ||
-            configuration.spanProcessors) {
-            const tracerProviderConfig = {};
-            if (configuration.sampler) {
-                tracerProviderConfig.sampler = configuration.sampler;
-            }
-            if (configuration.spanLimits) {
-                tracerProviderConfig.spanLimits = configuration.spanLimits;
-            }
-            if (configuration.idGenerator) {
-                tracerProviderConfig.idGenerator = configuration.idGenerator;
-            }
-            if (configuration.spanProcessor) {
-                api_1.diag.warn("The 'spanProcessor' option is deprecated. Please use 'spanProcessors' instead.");
-            }
-            const spanProcessor = configuration.spanProcessor ??
-                new sdk_trace_base_1.BatchSpanProcessor(configuration.traceExporter);
-            const spanProcessors = configuration.spanProcessors ?? [spanProcessor];
-            this._tracerProviderConfig = {
-                tracerConfig: tracerProviderConfig,
-                spanProcessors,
-            };
+        if (configuration.spanProcessor) {
+            api_1.diag.warn("The 'spanProcessor' option is deprecated. Please use 'spanProcessors' instead.");
         }
         if (configuration.logRecordProcessors) {
             this._loggerProviderConfig = {
@@ -152,9 +129,6 @@ class NodeSDK {
             };
             api_1.diag.warn("The 'logRecordProcessor' option is deprecated. Please use 'logRecordProcessors' instead.");
         }
-        else {
-            this.configureLoggerProviderFromEnv();
-        }
         if (configuration.metricReaders) {
             this._meterProviderConfig = {
                 readers: configuration.metricReaders,
@@ -223,19 +197,40 @@ class NodeSDK {
                 instrumentation.setMeterProvider(api_1.metrics.getMeterProvider());
             }
         }
-        const spanProcessors = this._tracerProviderConfig
-            ? this._tracerProviderConfig.spanProcessors
-            : (0, utils_1.getSpanProcessorsFromEnv)();
+        // Determine `spanProcessors` from multiple possible options.
+        let spanProcessors;
+        if (this._configuration?.spanProcessors) {
+            spanProcessors = this._configuration.spanProcessors;
+        }
+        else if (this._configuration?.spanProcessor) {
+            spanProcessors = [this._configuration.spanProcessor];
+        }
+        else if (this._configuration?.traceExporter) {
+            spanProcessors = [
+                (0, create_from_env_1.createBatchSpanProcessorFromEnv)(this._configuration.traceExporter, sdkMetricsEnabled ? this._meterProvider : undefined),
+            ];
+        }
+        else {
+            spanProcessors = (0, utils_1.getSpanProcessorsFromEnv)(sdkMetricsEnabled ? this._meterProvider : undefined);
+        }
         // Only register if there is a span processor
         if (spanProcessors.length > 0) {
-            this._tracerProvider = new sdk_trace_node_1.NodeTracerProvider({
-                ...this._configuration,
+            this._tracerProvider = new sdk_trace_1.TracerProvider({
+                sampler: this._configuration?.sampler ?? (0, create_from_env_1.createSamplerFromEnv)(),
+                spanLimits: {
+                    ...(0, create_from_env_1.createSpanLimitsFromEnv)(),
+                    ...this._configuration?.spanLimits,
+                },
                 resource: this._resource,
                 meterProvider: sdkMetricsEnabled ? this._meterProvider : undefined,
+                idGenerator: this._configuration?.idGenerator,
                 spanProcessors,
             });
             api_1.trace.setGlobalTracerProvider(this._tracerProvider);
         }
+        if (!this._loggerProviderConfig) {
+            this.configureLoggerProviderFromEnv(sdkMetricsEnabled ? this._meterProvider : undefined);
+        }
         if (this._loggerProviderConfig) {
             const loggerProvider = new sdk_logs_1.LoggerProvider({
                 ...(0, utils_1.getLoggerProviderConfigFromEnv)(),
@@ -262,7 +257,7 @@ class NodeSDK {
             // return void instead of the array from Promise.all
             .then(() => { }));
     }
-    configureLoggerProviderFromEnv() {
+    configureLoggerProviderFromEnv(meterProvider) {
         const enabledExporters = Array.from(new Set((0, core_1.getStringListFromEnv)('OTEL_LOGS_EXPORTER') ?? []));
         if (enabledExporters.length === 0) {
             api_1.diag.debug('OTEL_LOGS_EXPORTER is empty. Using default otlp exporter.');
@@ -303,10 +298,13 @@ class NodeSDK {
             this._loggerProviderConfig = {
                 logRecordProcessors: exporters.map(exporter => {
                     if (exporter instanceof sdk_logs_1.ConsoleLogRecordExporter) {
-                        return new sdk_logs_1.SimpleLogRecordProcessor(exporter);
+                        return new sdk_logs_1.SimpleLogRecordProcessor({
+                            exporter,
+                            selfObsMeterProvider: meterProvider,
+                        });
                     }
                     else {
-                        return (0, utils_1.getBatchLogRecordProcessorFromEnv)(exporter);
+                        return (0, utils_1.getBatchLogRecordProcessorFromEnv)(exporter, meterProvider);
                     }
                 }),
             };