@openclaw/diagnostics-otel 2026.6.8 → 2026.6.9-beta.1

package/node_modules/@opentelemetry/sdk-node/build/src/utils.js

@@ -20,6 +20,7 @@ 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 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");
@@ -33,13 +34,17 @@ const RESOURCE_DETECTOR_PROCESS = 'process';
 const RESOURCE_DETECTOR_SERVICE_INSTANCE_ID = 'serviceinstance';
 function getResourceFromConfiguration(config) {
     if (config.resource && config.resource.attributes) {
-        const attr = {};
+        const attrs = {};
         for (let i = 0; i < config.resource.attributes.length; i++) {
             const a = config.resource.attributes[i];
-            attr[a.name] = a.value;
+            // https://github.com/open-telemetry/opentelemetry-configuration/issues/613
+            // will likely clarify that entries with a `null` value should be ignored.
+            if (a.value !== null) {
+                attrs[a.name] = a.value;
+            }
         }
-        return (0, resources_1.resourceFromAttributes)(attr, {
-            schemaUrl: config.resource.schema_url,
+        return (0, resources_1.resourceFromAttributes)(attrs, {
+            schemaUrl: config.resource.schema_url ?? undefined,
         });
     }
     return undefined;
@@ -74,15 +79,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;
     });
@@ -358,21 +363,44 @@ function getOtlpMetricExporterFromEnv() {
     return new exporter_metrics_otlp_proto_1.OTLPMetricExporter();
 }
 exports.getOtlpMetricExporterFromEnv = getOtlpMetricExporterFromEnv;
+function getMetricProducersFromConfiguration(producers) {
+    if (!producers || producers.length === 0) {
+        return undefined;
+    }
+    const result = [];
+    for (const producer of producers) {
+        if (producer.opencensus) {
+            try {
+                const { OpenCensusMetricProducer,
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                 } = require('@opentelemetry/shim-opencensus');
+                result.push(new OpenCensusMetricProducer());
+            }
+            catch {
+                api_1.diag.warn('OpenCensus metric producer configured but @opentelemetry/shim-opencensus is not installed.');
+            }
+        }
+        else {
+            api_1.diag.warn('Unsupported metric producer configured.');
+        }
+    }
+    return result.length > 0 ? result : undefined;
+}
 function getPeriodicMetricReaderFromConfiguration(periodic) {
     if (periodic.exporter) {
         let exporter;
-        if (periodic.exporter.otlp_http) {
-            const encoding = periodic.exporter.otlp_http.encoding;
+        if (periodic.exporter.otlp_http !== undefined) {
+            const encoding = periodic.exporter.otlp_http?.encoding ?? 'protobuf';
             if (encoding === 'json') {
                 exporter = new exporter_metrics_otlp_http_1.OTLPMetricExporter({
-                    compression: periodic.exporter.otlp_http.compression === 'gzip'
+                    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'
+                    compression: periodic.exporter.otlp_http?.compression === 'gzip'
                         ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
                         : otlp_exporter_base_1.CompressionAlgorithm.NONE,
                 });
@@ -381,28 +409,31 @@ function getPeriodicMetricReaderFromConfiguration(periodic) {
                 api_1.diag.warn(`Unsupported OTLP metrics encoding: ${encoding}.`);
             }
         }
-        if (periodic.exporter.otlp_grpc) {
+        if (periodic.exporter.otlp_grpc !== undefined) {
             exporter = new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({
-                compression: periodic.exporter.otlp_grpc.compression === 'gzip'
+                compression: periodic.exporter.otlp_grpc?.compression === 'gzip'
                     ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
                     : otlp_exporter_base_1.CompressionAlgorithm.NONE,
             });
         }
+        const metricProducers = getMetricProducersFromConfiguration(periodic.producers);
         if (exporter) {
             // TODO(6425): add cardinality_limits
             return new sdk_metrics_1.PeriodicExportingMetricReader({
                 exportIntervalMillis: periodic.interval ?? 60000,
                 exportTimeoutMillis: periodic.timeout ?? 30000,
                 exporter,
+                metricProducers,
             });
         }
-        if (periodic.exporter.console) {
+        if (periodic.exporter.console !== undefined) {
             return new sdk_metrics_1.PeriodicExportingMetricReader({
                 exporter: new sdk_metrics_1.ConsoleMetricExporter(),
+                metricProducers,
             });
         }
     }
-    api_1.diag.warn(`Unsupported Metric Exporter.`);
+    api_1.diag.warn('Unsupported Metric Exporter.');
     return undefined;
 }
 exports.getPeriodicMetricReaderFromConfiguration = getPeriodicMetricReaderFromConfiguration;
@@ -436,40 +467,43 @@ function getBatchLogRecordProcessorFromEnv(exporter) {
 }
 exports.getBatchLogRecordProcessorFromEnv = getBatchLogRecordProcessorFromEnv;
 function getLogRecordExporter(exporter) {
-    if (exporter.otlp_http) {
-        const encoding = exporter.otlp_http.encoding;
+    if (exporter.otlp_http !== undefined) {
+        const cfg = exporter.otlp_http;
+        const commonOpts = {
+            compression: cfg?.compression === 'gzip'
+                ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
+                : otlp_exporter_base_1.CompressionAlgorithm.NONE,
+            url: cfg?.endpoint ?? undefined,
+            headers: getHeadersFromConfiguration(cfg?.headers),
+            timeoutMillis: validateExporterTimeout(cfg?.timeout),
+            httpAgentOptions: getHttpAgentOptionsFromTls(cfg?.tls),
+        };
+        const encoding = cfg?.encoding ?? 'protobuf';
         if (encoding === 'json') {
-            return new exporter_logs_otlp_http_1.OTLPLogExporter({
-                compression: exporter.otlp_http.compression === 'gzip'
-                    ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
-                    : otlp_exporter_base_1.CompressionAlgorithm.NONE,
-            });
+            return new exporter_logs_otlp_http_1.OTLPLogExporter(commonOpts);
         }
         if (encoding === '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,
-            });
+            return new exporter_logs_otlp_proto_1.OTLPLogExporter(commonOpts);
         }
         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,
-        });
+        return new exporter_logs_otlp_proto_1.OTLPLogExporter(commonOpts);
     }
-    else if (exporter.otlp_grpc) {
+    else if (exporter.otlp_grpc !== undefined) {
+        const cfg = exporter.otlp_grpc;
         return new exporter_logs_otlp_grpc_1.OTLPLogExporter({
-            compression: exporter.otlp_grpc.compression === 'gzip'
+            compression: cfg?.compression === 'gzip'
                 ? otlp_exporter_base_1.CompressionAlgorithm.GZIP
                 : otlp_exporter_base_1.CompressionAlgorithm.NONE,
+            url: cfg?.endpoint ?? undefined,
+            timeoutMillis: validateExporterTimeout(cfg?.timeout),
+            credentials: getGrpcCredentialsFromTls(cfg?.tls),
+            metadata: getGrpcMetadataFromHeaders(cfg?.headers),
         });
     }
-    else if (exporter.console) {
+    else if (exporter.console !== undefined) {
         return new sdk_logs_1.ConsoleLogRecordExporter();
     }
-    api_1.diag.warn(`Unsupported Exporter value. No Log Record Exporter registered`);
+    api_1.diag.warn('Unsupported Exporter value. No Log Record Exporter registered');
     return undefined;
 }
 exports.getLogRecordExporter = getLogRecordExporter;
@@ -480,10 +514,10 @@ function getLogRecordProcessorsFromConfiguration(config) {
             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,
+                    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,
                 }));
             }
         }
@@ -506,84 +540,121 @@ function getHeadersFromConfiguration(headers) {
     }
     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}`);
-            }
-        }
-        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}`);
-            }
-        }
-        return httpsAgentOptions;
+        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);
+        }
+        catch (e) {
+            api_1.diag.warn(`Failed to create gRPC SSL credentials: ${e}`);
+            return undefined;
+        }
+    }
+    return undefined;
+}
+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) {
+    else if (exporter.console !== undefined) {
         return new sdk_trace_base_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;
@@ -594,10 +665,10 @@ function getSpanProcessorsFromConfiguration(config) {
             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,
+                    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,
                 }));
             }
         }
@@ -699,8 +770,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 +786,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;
@@ -802,18 +874,18 @@ const DEFAULT_RATIO = 1;
  * 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) {
+function buildSamplerFromConfig(samplerConfig) {
+    if (samplerConfig.always_on !== undefined) {
         return new sdk_trace_base_1.AlwaysOnSampler();
     }
-    if (config.always_off !== undefined) {
+    if (samplerConfig.always_off !== undefined) {
         return new sdk_trace_base_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_base_1.TraceIdRatioBasedSampler(samplerConfig.trace_id_ratio_based?.ratio ?? DEFAULT_RATIO);
     }
-    if (config.parent_based !== undefined) {
-        const pb = config.parent_based;
+    if (samplerConfig.parent_based !== undefined) {
+        const pb = samplerConfig.parent_based ?? {};
         return new sdk_trace_base_1.ParentBasedSampler({
             root: pb.root ? buildSamplerFromConfig(pb.root) : new sdk_trace_base_1.AlwaysOnSampler(),
             remoteParentSampled: pb.remote_parent_sampled