@opentelemetry/sdk-node 0.218.0 → 0.220.0

package/build/src/utils.js

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSamplerFromConfig = exports.getInstanceID = exports.getMeterViewsFromConfiguration = exports.getAggregationType = exports.getInstrumentType = exports.getMeterReadersFromConfiguration = exports.getSpanLimitsFromConfiguration = exports.getSpanProcessorsFromConfiguration = exports.getSpanExporter = exports.getHttpAgentOptionsFromTls = exports.getHeadersFromConfiguration = exports.getLogRecordProcessorsFromConfiguration = exports.getLogRecordExporter = exports.getBatchLogRecordProcessorFromEnv = exports.getBatchLogRecordProcessorConfigFromEnv = exports.getLoggerProviderConfigFromEnv = exports.getPeriodicMetricReaderFromConfiguration = exports.getOtlpMetricExporterFromEnv = exports.getPeriodicExportingMetricReaderFromEnv = exports.getNonNegativeNumberFromEnv = exports.getKeyListFromObjectArray = exports.setupPropagator = exports.setupContextManager = exports.getPropagatorFromConfiguration = exports.getPropagatorFromEnv = exports.getSpanProcessorsFromEnv = exports.getOtlpProtocolFromEnv = exports.getResourceDetectorsFromConfiguration = exports.getResourceDetectorsFromEnv = exports.getResourceFromConfiguration = void 0;
+exports.buildSamplerFromConfig = exports.getSamplerFromConfiguration = exports.getInstanceID = exports.getMeterViewsFromConfiguration = exports.getAggregationType = exports.getInstrumentType = exports.getMeterReadersFromConfiguration = exports.getIdGeneratorFromConfiguration = exports.getSpanProcessorsFromConfiguration = exports.getSpanExporter = exports.getHttpAgentOptionsFromTls = exports.getHeadersFromConfiguration = exports.createLogRecordProcessorFromConfig = exports.createLogRecordExporterFromConfig = exports.createLoggerProviderFromConfig = exports.getBatchLogRecordProcessorFromEnv = exports.getBatchLogRecordProcessorConfigFromEnv = exports.getLoggerProviderConfigFromEnv = exports.getPeriodicMetricReaderFromConfiguration = exports.getMetricExporter = exports.getOtlpMetricExporterFromEnv = exports.getPeriodicExportingMetricReaderFromEnv = exports.getNonNegativeNumberFromEnv = exports.getKeyListFromObjectArray = exports.setupPropagator = exports.setupContextManager = exports.getPropagatorFromConfiguration = exports.getPropagatorFromEnv = exports.getSpanProcessorsFromEnv = exports.getOtlpProtocolFromEnv = exports.getResourceDetectorsFromConfiguration = exports.getResourceDetectorsFromEnv = exports.getResourceFromConfiguration = void 0;
 const api_1 = require("@opentelemetry/api");
 const core_1 = require("@opentelemetry/core");
 const exporter_trace_otlp_proto_1 = require("@opentelemetry/exporter-trace-otlp-proto");
@@ -12,7 +12,7 @@ const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-h
 const exporter_trace_otlp_grpc_1 = require("@opentelemetry/exporter-trace-otlp-grpc");
 const exporter_zipkin_1 = require("@opentelemetry/exporter-zipkin");
 const resources_1 = require("@opentelemetry/resources");
-const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const sdk_trace_1 = require("@opentelemetry/sdk-trace");
 const propagator_b3_1 = require("@opentelemetry/propagator-b3");
 const propagator_jaeger_1 = require("@opentelemetry/propagator-jaeger");
 const context_async_hooks_1 = require("@opentelemetry/context-async-hooks");
@@ -20,29 +20,40 @@ const exporter_logs_otlp_http_1 = require("@opentelemetry/exporter-logs-otlp-htt
 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 otlp_grpc_exporter_base_1 = require("@opentelemetry/otlp-grpc-exporter-base");
+const configuration_1 = require("@opentelemetry/configuration");
 const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
 const exporter_metrics_otlp_grpc_1 = require("@opentelemetry/exporter-metrics-otlp-grpc");
 const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-otlp-http");
+const exporter_metrics_otlp_http_2 = require("@opentelemetry/exporter-metrics-otlp-http");
 const exporter_metrics_otlp_proto_1 = require("@opentelemetry/exporter-metrics-otlp-proto");
 const sdk_logs_1 = require("@opentelemetry/sdk-logs");
 const fs = require("fs");
+const util_1 = require("util");
+const create_from_env_1 = require("./create-from-env");
 const RESOURCE_DETECTOR_ENVIRONMENT = 'env';
 const RESOURCE_DETECTOR_HOST = 'host';
 const RESOURCE_DETECTOR_OS = 'os';
 const RESOURCE_DETECTOR_PROCESS = 'process';
 const RESOURCE_DETECTOR_SERVICE_INSTANCE_ID = 'serviceinstance';
 function getResourceFromConfiguration(config) {
-    if (config.resource && config.resource.attributes) {
-        const attr = {};
-        for (let i = 0; i < config.resource.attributes.length; i++) {
-            const a = config.resource.attributes[i];
-            attr[a.name] = a.value;
+    if (!config.resource) {
+        return undefined;
+    }
+    const configAttrs = (0, configuration_1.mergeResourceAttributesConfig)(config.resource.attributes, config.resource.attributes_list);
+    if (!configAttrs) {
+        return undefined;
+    }
+    const attrs = {};
+    for (let i = 0; i < configAttrs.length; i++) {
+        const a = configAttrs[i];
+        if (a.value !== null) {
+            attrs[a.name] = a.value;
         }
-        return (0, resources_1.resourceFromAttributes)(attr, {
-            schemaUrl: config.resource.schema_url,
-        });
     }
-    return undefined;
+    return (0, resources_1.resourceFromAttributes)(attrs, {
+        schemaUrl: config.resource.schema_url ?? undefined,
+    });
 }
 exports.getResourceFromConfiguration = getResourceFromConfiguration;
 function getResourceDetectorsFromEnv() {
@@ -74,15 +85,15 @@ function getResourceDetectorsFromConfiguration(config) {
     const detectors = config.resource?.['detection/development']?.detectors ?? [];
     return detectors.flatMap(detector => {
         const result = [];
-        if (detector.host != null)
+        if (detector.host !== undefined)
             result.push(resources_1.hostDetector);
-        if (detector.os != null)
+        if (detector.os !== undefined)
             result.push(resources_1.osDetector);
-        if (detector.process != null)
+        if (detector.process !== undefined)
             result.push(resources_1.processDetector);
-        if (detector.service != null)
+        if (detector.service !== undefined)
             result.push(resources_1.serviceInstanceIdDetector);
-        if (detector.env != null)
+        if (detector.env !== undefined)
             result.push(resources_1.envDetector);
         return result;
     });
@@ -108,11 +119,11 @@ function getOtlpExporterFromEnv() {
             return new exporter_trace_otlp_proto_1.OTLPTraceExporter();
     }
 }
-function getSpanProcessorsFromEnv() {
+function getSpanProcessorsFromEnv(selfObsMeterProvider) {
     const exportersMap = new Map([
         ['otlp', () => getOtlpExporterFromEnv()],
         ['zipkin', () => new exporter_zipkin_1.ZipkinExporter()],
-        ['console', () => new sdk_trace_base_1.ConsoleSpanExporter()],
+        ['console', () => new sdk_trace_1.ConsoleSpanExporter()],
     ]);
     const exporters = [];
     const processors = [];
@@ -140,11 +151,11 @@ function getSpanProcessorsFromEnv() {
         }
     }
     for (const exp of exporters) {
-        if (exp instanceof sdk_trace_base_1.ConsoleSpanExporter) {
-            processors.push(new sdk_trace_base_1.SimpleSpanProcessor(exp));
+        if (exp instanceof sdk_trace_1.ConsoleSpanExporter) {
+            processors.push(new sdk_trace_1.SimpleSpanProcessor({ exporter: exp, selfObsMeterProvider }));
         }
         else {
-            processors.push(new sdk_trace_base_1.BatchSpanProcessor(exp));
+            processors.push((0, create_from_env_1.createBatchSpanProcessorFromEnv)(exp, selfObsMeterProvider));
         }
     }
     if (exporters.length === 0) {
@@ -207,13 +218,50 @@ exports.getPropagatorFromEnv = getPropagatorFromEnv;
  * Get a propagator as defined by configuration model from configuration
  */
 function getPropagatorFromConfiguration(config) {
-    const propagatorsValue = getKeyListFromObjectArray(config.propagator?.composite);
-    if (propagatorsValue == null) {
-        // return undefined to fall back to default
+    if (!config.propagator) {
         return undefined;
     }
-    if (propagatorsValue.includes('none')) {
-        return null;
+    const configComposite = (0, configuration_1.mergePropagatorCompositeConfig)(config.propagator.composite, config.propagator.composite_list);
+    if (!configComposite) {
+        return undefined;
+    }
+    // TextMapPropagator config items are objects with a single key (the name).
+    // Transform this into a more convenient `(name, value)` 2-tuple.
+    //
+    // As well, guard against two cases where the TypeScript type
+    // `TextMapPropagatorConfigModel` does not exactly represent the JSON schema:
+    // 1. `"minProperties": 1, "maxProperties": 1,`
+    // 2. The type allows keys with an `undefined` value, but the JSON schema
+    //    does not.
+    const kvFromItem = (item) => {
+        const keys = [];
+        let value = undefined;
+        for (const key of Object.keys(item)) {
+            value = item[key];
+            if (value === undefined) {
+                continue;
+            }
+            keys.push(key);
+        }
+        if (keys.length !== 1) {
+            throw new Error(`invalid "propagator" entry in configuration, there must be exactly one key (with a non-undefined value): ${(0, util_1.inspect)(item)}`);
+        }
+        return [keys[0], value];
+    };
+    // First pass: handle 'none', remove dupes.
+    const names = new Set();
+    const kvs = [];
+    for (const item of configComposite) {
+        const kv = kvFromItem(item);
+        const k = kv[0];
+        if (names.has(k)) {
+            continue;
+        }
+        names.add(k);
+        kvs.push(kv);
+        if (k === 'none') {
+            return undefined;
+        }
     }
     // Implementation note: this only contains specification required propagators that are actually hosted in this repo.
     // Any other propagators (like aws, aws-lambda, should go into `@opentelemetry/auto-configuration-propagators` instead).
@@ -227,22 +275,19 @@ function getPropagatorFromConfiguration(config) {
         ],
         ['jaeger', () => new propagator_jaeger_1.JaegerPropagator()],
     ]);
-    // Values MUST be deduplicated in order to register a Propagator only once.
-    const uniquePropagatorNames = Array.from(new Set(propagatorsValue));
     const validPropagators = [];
-    uniquePropagatorNames.forEach(name => {
+    for (const [name] of kvs) {
         const propagator = propagatorsFactory.get(name)?.();
         if (!propagator) {
             api_1.diag.warn(`Propagator "${name}" requested through configuration is unavailable.`);
-            return;
+            continue;
         }
         validPropagators.push(propagator);
-    });
+    }
     if (validPropagators.length === 0) {
-        // null to signal that the default should **not** be used in its place.
-        return null;
+        return undefined;
     }
-    else if (uniquePropagatorNames.length === 1) {
+    else if (validPropagators.length === 1) {
         return validPropagators[0];
     }
     else {
@@ -358,53 +403,126 @@ function getOtlpMetricExporterFromEnv() {
     return new exporter_metrics_otlp_proto_1.OTLPMetricExporter();
 }
 exports.getOtlpMetricExporterFromEnv = getOtlpMetricExporterFromEnv;
-function getPeriodicMetricReaderFromConfiguration(periodic) {
-    if (periodic.exporter) {
-        let exporter;
-        if (periodic.exporter.otlp_http) {
-            const encoding = periodic.exporter.otlp_http.encoding;
-            if (encoding === 'json') {
-                exporter = new exporter_metrics_otlp_http_1.OTLPMetricExporter({
-                    compression: periodic.exporter.otlp_http.compression === 'gzip'
-                        ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
-                        : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-                });
-            }
-            else if (encoding === 'protobuf') {
-                exporter = new exporter_metrics_otlp_proto_1.OTLPMetricExporter({
-                    compression: periodic.exporter.otlp_http.compression === 'gzip'
-                        ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
-                        : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-                });
-            }
-            else {
-                api_1.diag.warn(`Unsupported OTLP metrics encoding: ${encoding}.`);
-            }
-        }
-        if (periodic.exporter.otlp_grpc) {
-            exporter = new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({
-                compression: periodic.exporter.otlp_grpc.compression === 'gzip'
-                    ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
-                    : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-            });
-        }
-        if (exporter) {
-            // TODO(6425): add cardinality_limits
-            return new sdk_metrics_1.PeriodicExportingMetricReader({
-                exportIntervalMillis: periodic.interval ?? 60000,
-                exportTimeoutMillis: periodic.timeout ?? 30000,
-                exporter,
-            });
-        }
-        if (periodic.exporter.console) {
-            return new sdk_metrics_1.PeriodicExportingMetricReader({
-                exporter: new sdk_metrics_1.ConsoleMetricExporter(),
-            });
-        }
+function getMetricProducersFromConfiguration(producers) {
+    if (!producers || producers.length === 0) {
+        return undefined;
+    }
+    const result = [];
+    for (const producer of producers) {
+        // Note: The "opencensus" MetricProducer is intentionally not supported.
+        // It is deprecated in OpenTelemetry Configuration v1.2.0.
+        api_1.diag.warn(`Unsupported metric producer in configuration: "${producer}". Skipping.`);
+    }
+    return result.length > 0 ? result : undefined;
+}
+/**
+ * Map a declarative-config `temporality_preference` value to the enum the OTLP
+ * metric exporters expect. Returns undefined for an unspecified preference so
+ * the exporter falls back to its own default (cumulative).
+ */
+function getMetricTemporalityPreference(preference) {
+    switch (preference) {
+        case 'delta':
+            return exporter_metrics_otlp_http_2.AggregationTemporalityPreference.DELTA;
+        case 'low_memory':
+            return exporter_metrics_otlp_http_2.AggregationTemporalityPreference.LOWMEMORY;
+        case 'cumulative':
+            return exporter_metrics_otlp_http_2.AggregationTemporalityPreference.CUMULATIVE;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Map a declarative-config `default_histogram_aggregation` value to an
+ * AggregationSelector that applies the requested aggregation to histogram
+ * instruments and leaves all other instrument types at their default. Returns
+ * undefined for an unspecified value so the exporter uses its own default.
+ */
+function getMetricAggregationPreference(aggregation) {
+    let histogramAggregation;
+    switch (aggregation) {
+        case 'base2_exponential_bucket_histogram':
+            histogramAggregation = { type: sdk_metrics_1.AggregationType.EXPONENTIAL_HISTOGRAM };
+            break;
+        case 'explicit_bucket_histogram':
+            histogramAggregation = {
+                type: sdk_metrics_1.AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
+            };
+            break;
+        default:
+            return undefined;
+    }
+    return (instrumentType) => instrumentType === sdk_metrics_1.InstrumentType.HISTOGRAM
+        ? histogramAggregation
+        : { type: sdk_metrics_1.AggregationType.DEFAULT };
+}
+function getOtlpHttpMetricExporter(otlpHttp) {
+    const encoding = otlpHttp?.encoding ?? 'protobuf';
+    const options = {
+        compression: otlpHttp?.compression === 'gzip'
+            ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
+            : otlp_exporter_base_1.CompressionAlgorithm.NONE,
+        url: otlpHttp?.endpoint ?? undefined,
+        headers: getHeadersFromConfiguration(otlpHttp?.headers),
+        timeoutMillis: validateExporterTimeout(otlpHttp?.timeout),
+        httpAgentOptions: getHttpAgentOptionsFromTls(otlpHttp?.tls),
+        temporalityPreference: getMetricTemporalityPreference(otlpHttp?.temporality_preference),
+        aggregationPreference: getMetricAggregationPreference(otlpHttp?.default_histogram_aggregation),
+    };
+    if (encoding === 'json') {
+        return new exporter_metrics_otlp_http_1.OTLPMetricExporter(options);
+    }
+    else if (encoding === 'protobuf') {
+        return new exporter_metrics_otlp_proto_1.OTLPMetricExporter(options);
+    }
+    api_1.diag.warn(`Unsupported OTLP metrics encoding: ${encoding}.`);
+    return undefined;
+}
+function getOtlpGrpcMetricExporter(otlpGrpc) {
+    return new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({
+        compression: otlpGrpc?.compression === 'gzip'
+            ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
+            : otlp_exporter_base_1.CompressionAlgorithm.NONE,
+        url: otlpGrpc?.endpoint ?? undefined,
+        timeoutMillis: validateExporterTimeout(otlpGrpc?.timeout),
+        credentials: getGrpcCredentialsFromTls(otlpGrpc?.tls),
+        metadata: getGrpcMetadataFromHeaders(otlpGrpc?.headers),
+        temporalityPreference: getMetricTemporalityPreference(otlpGrpc?.temporality_preference),
+        aggregationPreference: getMetricAggregationPreference(otlpGrpc?.default_histogram_aggregation),
+    });
+}
+function getMetricExporter(exporter) {
+    if (exporter.otlp_http !== undefined) {
+        return getOtlpHttpMetricExporter(exporter.otlp_http);
+    }
+    if (exporter.otlp_grpc !== undefined) {
+        return getOtlpGrpcMetricExporter(exporter.otlp_grpc);
     }
-    api_1.diag.warn(`Unsupported Metric Exporter.`);
+    if (exporter.console !== undefined) {
+        return new sdk_metrics_1.ConsoleMetricExporter();
+    }
+    api_1.diag.warn('Unsupported Metric Exporter.');
     return undefined;
 }
+exports.getMetricExporter = getMetricExporter;
+function getPeriodicMetricReaderFromConfiguration(periodic) {
+    if (!periodic.exporter) {
+        api_1.diag.warn('Unsupported Metric Exporter.');
+        return undefined;
+    }
+    const exporter = getMetricExporter(periodic.exporter);
+    if (!exporter) {
+        return undefined;
+    }
+    const metricProducers = getMetricProducersFromConfiguration(periodic.producers);
+    // TODO(6425): add cardinality_limits
+    return new sdk_metrics_1.PeriodicExportingMetricReader({
+        exportIntervalMillis: periodic.interval ?? 60000,
+        exportTimeoutMillis: periodic.timeout ?? 30000,
+        exporter,
+        metricProducers,
+    });
+}
 exports.getPeriodicMetricReaderFromConfiguration = getPeriodicMetricReaderFromConfiguration;
 /**
  * Get LoggerProviderConfig from environment variables.
@@ -432,158 +550,224 @@ function getBatchLogRecordProcessorConfigFromEnv() {
 }
 exports.getBatchLogRecordProcessorConfigFromEnv = getBatchLogRecordProcessorConfigFromEnv;
 function getBatchLogRecordProcessorFromEnv(exporter) {
-    return new sdk_logs_1.BatchLogRecordProcessor(exporter, getBatchLogRecordProcessorConfigFromEnv());
+    return new sdk_logs_1.BatchLogRecordProcessor({
+        exporter,
+        ...getBatchLogRecordProcessorConfigFromEnv(),
+    });
 }
 exports.getBatchLogRecordProcessorFromEnv = getBatchLogRecordProcessorFromEnv;
-function getLogRecordExporter(exporter) {
-    if (exporter.otlp_http) {
-        const encoding = exporter.otlp_http.encoding;
-        if (encoding === 'json') {
-            return new exporter_logs_otlp_http_1.OTLPLogExporter({
-                compression: exporter.otlp_http.compression === 'gzip'
+function createLogRecordLimitsFromConfig(limits, attribute_limits) {
+    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,
+    };
+}
+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 createLogRecordExporterFromConfig(exporter) {
+    const [name, properties] = mustSingleEntry(exporter, 'LogRecordExporter');
+    switch (name) {
+        case 'otlp_http': {
+            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: getHeadersFromConfiguration(props?.headers),
+                timeoutMillis: validateExporterTimeout(props?.timeout),
+                httpAgentOptions: 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}"`);
+            }
         }
-        if (encoding === 'protobuf') {
-            return new exporter_logs_otlp_proto_1.OTLPLogExporter({
-                compression: exporter.otlp_http.compression === 'gzip'
+        case 'otlp_grpc': {
+            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: validateExporterTimeout(props?.timeout),
+                credentials: getGrpcCredentialsFromTls(props?.tls),
+                metadata: getGrpcMetadataFromHeaders(props?.headers),
             });
         }
-        api_1.diag.warn(`Unsupported OTLP logs encoding: ${encoding}. Using http/protobuf.`);
-        return new exporter_logs_otlp_proto_1.OTLPLogExporter({
-            compression: exporter.otlp_http.compression === 'gzip'
-                ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
-                : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-        });
-    }
-    else if (exporter.otlp_grpc) {
-        return new exporter_logs_otlp_grpc_1.OTLPLogExporter({
-            compression: exporter.otlp_grpc.compression === 'gzip'
-                ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
-                : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-        });
-    }
-    else if (exporter.console) {
-        return new sdk_logs_1.ConsoleLogRecordExporter();
+        case 'console':
+            return new sdk_logs_1.ConsoleLogRecordExporter();
+        default:
+            throw new Error(`unknown LogRecordExporter name in configuration: "${name}"`);
     }
-    api_1.diag.warn(`Unsupported Exporter value. No Log Record Exporter registered`);
-    return undefined;
 }
-exports.getLogRecordExporter = getLogRecordExporter;
-function getLogRecordProcessorsFromConfiguration(config) {
-    const logRecordProcessors = [];
-    config.logger_provider?.processors?.forEach(processor => {
-        if (processor.batch) {
-            const exporter = getLogRecordExporter(processor.batch.exporter);
-            if (exporter) {
-                logRecordProcessors.push(new sdk_logs_1.BatchLogRecordProcessor(exporter, {
-                    maxQueueSize: processor.batch.max_queue_size,
-                    maxExportBatchSize: processor.batch.max_export_batch_size,
-                    scheduledDelayMillis: processor.batch.schedule_delay,
-                    exportTimeoutMillis: processor.batch.export_timeout,
-                }));
-            }
+exports.createLogRecordExporterFromConfig = createLogRecordExporterFromConfig;
+function createLogRecordProcessorFromConfig(processor) {
+    const [name, properties] = mustSingleEntry(processor, 'LogRecordProcessor');
+    switch (name) {
+        case 'batch': {
+            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,
+            });
         }
-        if (processor.simple) {
-            const exporter = getLogRecordExporter(processor.simple.exporter);
-            if (exporter) {
-                logRecordProcessors.push(new sdk_logs_1.SimpleLogRecordProcessor(exporter));
-            }
+        case 'simple': {
+            const props = properties;
+            const exporter = createLogRecordExporterFromConfig(props.exporter);
+            return new sdk_logs_1.SimpleLogRecordProcessor({ exporter });
         }
-    });
-    if (logRecordProcessors.length > 0) {
-        return logRecordProcessors;
+        default:
+            throw new Error(`unknown LogRecordProcessor name: "${name}"`);
     }
-    return undefined;
 }
-exports.getLogRecordProcessorsFromConfiguration = getLogRecordProcessorsFromConfiguration;
+exports.createLogRecordProcessorFromConfig = createLogRecordProcessorFromConfig;
 function getHeadersFromConfiguration(headers) {
     if (!headers) {
         return undefined;
     }
     const result = {};
     headers.forEach(header => {
-        result[header.name] = header.value;
+        if (header.value !== null) {
+            result[header.name] = header.value;
+        }
     });
     return result;
 }
 exports.getHeadersFromConfiguration = getHeadersFromConfiguration;
+/**
+ * Validate an exporter timeout value. The spec says 0 means "no limit
+ * (infinity)" but the JS exporters don't support that yet (see #6617).
+ * Warn and return undefined so the exporter falls back to its default.
+ */
+function validateExporterTimeout(timeout) {
+    if (timeout === null) {
+        return undefined;
+    }
+    else if (timeout === 0) {
+        api_1.diag.warn('Exporter timeout of 0 (infinite) is not supported. Using default timeout.');
+        return undefined;
+    }
+    return timeout;
+}
 function getHttpAgentOptionsFromTls(tls) {
     if (tls && (tls.ca_file || tls.cert_file || tls.key_file)) {
-        const httpsAgentOptions = {};
-        if (tls.ca_file) {
-            try {
-                httpsAgentOptions.ca = fs.readFileSync(tls.ca_file);
-            }
-            catch (e) {
-                api_1.diag.warn(`Failed to read TLS CA file at ${tls.ca_file}: ${e}`);
-            }
-        }
-        if (tls.cert_file) {
-            try {
-                httpsAgentOptions.cert = fs.readFileSync(tls.cert_file);
-            }
-            catch (e) {
-                api_1.diag.warn(`Failed to read TLS cert file at ${tls.cert_file}: ${e}`);
-            }
+        return {
+            ca: readFileOrWarn(tls.ca_file, 'TLS CA'),
+            cert: readFileOrWarn(tls.cert_file, 'TLS cert'),
+            key: readFileOrWarn(tls.key_file, 'TLS key'),
+        };
+    }
+    return undefined;
+}
+exports.getHttpAgentOptionsFromTls = getHttpAgentOptionsFromTls;
+function getGrpcCredentialsFromTls(tls) {
+    if (tls?.insecure) {
+        return (0, otlp_grpc_exporter_base_1.createInsecureCredentials)();
+    }
+    const rootCert = readFileOrWarn(tls?.ca_file, 'TLS CA');
+    const privateKey = readFileOrWarn(tls?.key_file, 'TLS key');
+    const certChain = readFileOrWarn(tls?.cert_file, 'TLS cert');
+    if (rootCert || privateKey || certChain) {
+        try {
+            return (0, otlp_grpc_exporter_base_1.createSslCredentials)(rootCert, privateKey, certChain);
         }
-        if (tls.key_file) {
-            try {
-                httpsAgentOptions.key = fs.readFileSync(tls.key_file);
-            }
-            catch (e) {
-                api_1.diag.warn(`Failed to read TLS key file at ${tls.key_file}: ${e}`);
-            }
+        catch (e) {
+            api_1.diag.warn(`Failed to create gRPC SSL credentials: ${e}`);
+            return undefined;
         }
-        return httpsAgentOptions;
     }
     return undefined;
 }
-exports.getHttpAgentOptionsFromTls = getHttpAgentOptionsFromTls;
+function getGrpcMetadataFromHeaders(headers) {
+    if (!headers || headers.length === 0) {
+        return undefined;
+    }
+    const metadata = (0, otlp_grpc_exporter_base_1.createEmptyMetadata)();
+    for (const header of headers) {
+        if (header.value !== null) {
+            metadata.set(header.name, header.value);
+        }
+    }
+    return metadata;
+}
+function readFileOrWarn(filePath, label) {
+    if (!filePath)
+        return undefined;
+    try {
+        return fs.readFileSync(filePath);
+    }
+    catch (e) {
+        api_1.diag.warn(`Failed to read ${label} file at ${filePath}: ${e}`);
+        return undefined;
+    }
+}
 function getSpanExporter(exporter) {
-    if (exporter.otlp_http) {
-        const encoding = exporter.otlp_http.encoding;
+    if (exporter.otlp_http !== undefined) {
+        const encoding = exporter.otlp_http?.encoding ?? 'protobuf';
         if (encoding === 'json') {
             return new exporter_trace_otlp_http_1.OTLPTraceExporter({
-                compression: exporter.otlp_http.compression === 'gzip'
+                compression: exporter.otlp_http?.compression === 'gzip'
                     ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
                     : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-                url: exporter.otlp_http.endpoint,
-                headers: getHeadersFromConfiguration(exporter.otlp_http.headers),
-                timeoutMillis: exporter.otlp_http.timeout,
-                httpAgentOptions: getHttpAgentOptionsFromTls(exporter.otlp_http.tls),
+                url: exporter.otlp_http?.endpoint ?? undefined,
+                headers: getHeadersFromConfiguration(exporter.otlp_http?.headers),
+                timeoutMillis: validateExporterTimeout(exporter.otlp_http?.timeout),
+                httpAgentOptions: getHttpAgentOptionsFromTls(exporter.otlp_http?.tls),
             });
         }
         else {
             return new exporter_trace_otlp_proto_1.OTLPTraceExporter({
-                compression: exporter.otlp_http.compression === 'gzip'
+                compression: exporter.otlp_http?.compression === 'gzip'
                     ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
                     : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-                url: exporter.otlp_http.endpoint,
-                headers: getHeadersFromConfiguration(exporter.otlp_http.headers),
-                timeoutMillis: exporter.otlp_http.timeout,
-                httpAgentOptions: getHttpAgentOptionsFromTls(exporter.otlp_http.tls),
+                url: exporter.otlp_http?.endpoint ?? undefined,
+                headers: getHeadersFromConfiguration(exporter.otlp_http?.headers),
+                timeoutMillis: validateExporterTimeout(exporter.otlp_http?.timeout),
+                httpAgentOptions: getHttpAgentOptionsFromTls(exporter.otlp_http?.tls),
             });
         }
     }
-    else if (exporter.otlp_grpc) {
+    else if (exporter.otlp_grpc !== undefined) {
         return new exporter_trace_otlp_grpc_1.OTLPTraceExporter({
-            compression: exporter.otlp_grpc.compression === 'gzip'
+            compression: exporter.otlp_grpc?.compression === 'gzip'
                 ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
                 : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-            url: exporter.otlp_grpc.endpoint,
-            timeoutMillis: exporter.otlp_grpc.timeout,
-            // TODO (6614): add support for credentials
-            // TODO (6615): add metadata (headers) support
+            url: exporter.otlp_grpc?.endpoint ?? undefined,
+            timeoutMillis: validateExporterTimeout(exporter.otlp_grpc?.timeout),
+            credentials: getGrpcCredentialsFromTls(exporter.otlp_grpc?.tls),
+            metadata: getGrpcMetadataFromHeaders(exporter.otlp_grpc?.headers),
         });
     }
-    else if (exporter.console) {
-        return new sdk_trace_base_1.ConsoleSpanExporter();
+    else if (exporter.console !== undefined) {
+        return new sdk_trace_1.ConsoleSpanExporter();
     }
-    api_1.diag.warn(`Unsupported Exporter value. No Span Exporter registered`);
+    api_1.diag.warn('Unsupported Exporter value. No Span Exporter registered');
     return undefined;
 }
 exports.getSpanExporter = getSpanExporter;
@@ -593,18 +777,19 @@ function getSpanProcessorsFromConfiguration(config) {
         if (processor.batch) {
             const exporter = getSpanExporter(processor.batch.exporter);
             if (exporter) {
-                spanProcessors.push(new sdk_trace_base_1.BatchSpanProcessor(exporter, {
-                    maxQueueSize: processor.batch.max_queue_size,
-                    maxExportBatchSize: processor.batch.max_export_batch_size,
-                    scheduledDelayMillis: processor.batch.schedule_delay,
-                    exportTimeoutMillis: processor.batch.export_timeout,
+                spanProcessors.push(new sdk_trace_1.BatchSpanProcessor({
+                    exporter,
+                    maxQueueSize: processor.batch.max_queue_size ?? undefined,
+                    maxExportBatchSize: processor.batch.max_export_batch_size ?? undefined,
+                    scheduledDelayMillis: processor.batch.schedule_delay ?? undefined,
+                    exportTimeoutMillis: processor.batch.export_timeout ?? undefined,
                 }));
             }
         }
         if (processor.simple) {
             const exporter = getSpanExporter(processor.simple.exporter);
             if (exporter) {
-                spanProcessors.push(new sdk_trace_base_1.SimpleSpanProcessor(exporter));
+                spanProcessors.push(new sdk_trace_1.SimpleSpanProcessor({ exporter }));
             }
         }
     });
@@ -614,26 +799,23 @@ function getSpanProcessorsFromConfiguration(config) {
     return undefined;
 }
 exports.getSpanProcessorsFromConfiguration = getSpanProcessorsFromConfiguration;
-function getSpanLimitsFromConfiguration(config) {
-    if (config.tracer_provider?.limits) {
-        const limitsConfig = config.tracer_provider.limits;
-        const spanLimits = {};
-        spanLimits.attributeCountLimit = limitsConfig.attribute_count_limit ?? 128;
-        spanLimits.eventCountLimit = limitsConfig.event_count_limit ?? 128;
-        spanLimits.linkCountLimit = limitsConfig.link_count_limit ?? 128;
-        spanLimits.attributePerLinkCountLimit =
-            limitsConfig.link_attribute_count_limit ?? 128;
-        spanLimits.attributePerEventCountLimit =
-            limitsConfig.event_attribute_count_limit ?? 128;
-        if (limitsConfig.attribute_value_length_limit != null) {
-            spanLimits.attributeValueLengthLimit =
-                limitsConfig.attribute_value_length_limit;
-        }
-        return spanLimits;
+function getIdGeneratorFromConfiguration(config) {
+    const idGenerator = config.tracer_provider?.id_generator;
+    if (!idGenerator) {
+        return undefined;
+    }
+    if (idGenerator.random !== undefined) {
+        return new sdk_trace_1.RandomIdGenerator();
+    }
+    // Any other key is a third-party / custom id_generator type which we
+    // don't currently support. Warn and fall back to SDK default.
+    const unknownKeys = Object.keys(idGenerator).filter(k => k !== 'random');
+    if (unknownKeys.length > 0) {
+        api_1.diag.warn(`Unsupported id_generator type(s): ${unknownKeys.join(', ')}. Using default.`);
     }
     return undefined;
 }
-exports.getSpanLimitsFromConfiguration = getSpanLimitsFromConfiguration;
+exports.getIdGeneratorFromConfiguration = getIdGeneratorFromConfiguration;
 function getMeterReadersFromConfiguration(config) {
     const metricReaders = [];
     config.meter_provider?.readers?.forEach(reader => {
@@ -699,8 +881,9 @@ function getAggregationType(aggregation) {
         return {
             type: sdk_metrics_1.AggregationType.EXPONENTIAL_HISTOGRAM,
             options: {
-                recordMinMax: aggregation.base2_exponential_bucket_histogram.record_min_max ?? true,
-                maxSize: aggregation.base2_exponential_bucket_histogram.max_size,
+                recordMinMax: aggregation.base2_exponential_bucket_histogram.record_min_max ??
+                    undefined,
+                maxSize: aggregation.base2_exponential_bucket_histogram.max_size ?? undefined,
             },
         };
     }
@@ -714,7 +897,7 @@ function getAggregationType(aggregation) {
             type: sdk_metrics_1.AggregationType.SUM,
         };
     }
-    api_1.diag.warn(`Unsupported aggregation type`);
+    api_1.diag.warn('Unsupported aggregation type');
     return undefined;
 }
 exports.getAggregationType = getAggregationType;
@@ -798,24 +981,37 @@ function getInstanceID(config) {
 }
 exports.getInstanceID = getInstanceID;
 const DEFAULT_RATIO = 1;
+/**
+ * Returns the {@link Sampler} configured under `tracer_provider.sampler` in
+ * the declarative configuration, or `undefined` if none is set (in which case
+ * the SDK applies its default sampler).
+ */
+function getSamplerFromConfiguration(config) {
+    const samplerConfig = config.tracer_provider?.sampler;
+    if (!samplerConfig) {
+        return undefined;
+    }
+    return buildSamplerFromConfig(samplerConfig);
+}
+exports.getSamplerFromConfiguration = getSamplerFromConfiguration;
 /**
  * Builds a {@link Sampler} from a {@link SamplerConfigModel} data model.
  * This allows sampler construction from declarative configuration.
  */
-function buildSamplerFromConfig(config) {
-    if (config.always_on !== undefined) {
-        return new sdk_trace_base_1.AlwaysOnSampler();
+function buildSamplerFromConfig(samplerConfig) {
+    if (samplerConfig.always_on !== undefined) {
+        return new sdk_trace_1.AlwaysOnSampler();
     }
-    if (config.always_off !== undefined) {
-        return new sdk_trace_base_1.AlwaysOffSampler();
+    if (samplerConfig.always_off !== undefined) {
+        return new sdk_trace_1.AlwaysOffSampler();
     }
-    if (config.trace_id_ratio_based !== undefined) {
-        return new sdk_trace_base_1.TraceIdRatioBasedSampler(config.trace_id_ratio_based.ratio ?? DEFAULT_RATIO);
+    if (samplerConfig.trace_id_ratio_based !== undefined) {
+        return new sdk_trace_1.TraceIdRatioBasedSampler(samplerConfig.trace_id_ratio_based?.ratio ?? DEFAULT_RATIO);
     }
-    if (config.parent_based !== undefined) {
-        const pb = config.parent_based;
-        return new sdk_trace_base_1.ParentBasedSampler({
-            root: pb.root ? buildSamplerFromConfig(pb.root) : new sdk_trace_base_1.AlwaysOnSampler(),
+    if (samplerConfig.parent_based !== undefined) {
+        const pb = samplerConfig.parent_based ?? {};
+        return new sdk_trace_1.ParentBasedSampler({
+            root: pb.root ? buildSamplerFromConfig(pb.root) : new sdk_trace_1.AlwaysOnSampler(),
             remoteParentSampled: pb.remote_parent_sampled
                 ? buildSamplerFromConfig(pb.remote_parent_sampled)
                 : undefined,
@@ -830,8 +1026,55 @@ function buildSamplerFromConfig(config) {
                 : undefined,
         });
     }
-    api_1.diag.error('Unknown sampler config, defaulting to ParentBased(AlwaysOn).');
-    return new sdk_trace_base_1.ParentBasedSampler({ root: new sdk_trace_base_1.AlwaysOnSampler() });
+    api_1.diag.warn('Unknown sampler config, defaulting to ParentBased(AlwaysOn).');
+    return new sdk_trace_1.ParentBasedSampler({ root: new sdk_trace_1.AlwaysOnSampler() });
 }
 exports.buildSamplerFromConfig = buildSamplerFromConfig;
+/**
+ * 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];
+}
 //# sourceMappingURL=utils.js.map