@ogcio/o11y-sdk-node 0.1.0-beta.6 → 0.1.0-beta.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.1.0-beta.7](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-node@v0.1.0-beta.6...@ogcio/o11y-sdk-node@v0.1.0-beta.7) (2025-02-18)
+
+
+### Features
+
+* **sdk-node:** add span customization AB[#25358](https://github.com/ogcio/o11y/issues/25358) ([46ba97b](https://github.com/ogcio/o11y/commit/46ba97bac4004ff326a954592f45213ce0e4d683))
+
 ## [0.1.0-beta.6](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-node@v0.1.0-beta.5...@ogcio/o11y-sdk-node@v0.1.0-beta.6) (2025-02-06)
 
 

package/README.md

@@ -27,6 +27,15 @@ import("@ogcio/o11y-sdk-node/lib/index").then((sdk) =>
   sdk.instrumentNode({
     serviceName: "node-microservice",
     collectorUrl: "http://localhost:4317",
+    resourceAttributes: {
+      "team.infra.cluster": "dev-01",
+      "team.infra.pod": "01",
+      "team.service.type": "fastify",
+    },
+    spanAttributes: {
+      "signal.namespace": "documentation",
+    },
+    ignoreUrls: [{ type: "equals", url: "/api/health" }],
   }),
 );
 ```
@@ -47,6 +56,56 @@ Or setup inside your package.json
 }
 ```
 
+## Span Customization
+
+It is possible to customize spans such as traces and logs globally or in a single code statement using predefined functions.
+
+### Global Configuration
+
+In the SDK configuration, you can set the following properties:
+
+- `spanAttributes` Object containing static properties or functions used to evaluate custom attributes for every logs and traces.
+- `resourceAttributes` Object containing static properties used as resources attributes for any signal.
+- `traceRatio` Faction value from 0 to 1, used by TraceIdRatioBasedSampler which it deterministically samples a percentage of traces that you pass in as a parameter.
+
+```typescript
+function generateRandomString(): string {
+  return Math.random() + "_" + Date.now();
+}
+
+instrumentNode({
+  resourceAttributes: {
+    "property.name.one": "value_one",
+    "property.name.two": "value_two",
+  },
+  spanAttributes: {
+    "custom.span.value": "example",
+    "custom.span.value_with_function": generateRandomString,
+  },
+});
+```
+
+### Edit Active Span
+
+Using `getActiveSpan` function, you can access to current transaction span and customize it.
+
+You can use the function everywhere in your code, and set some custom attributes that are enabled for that single span
+
+```typescript
+import { getActiveSpan } from "@ogcio/o11y-sdk-node";
+
+async function routes(app: FastifyInstance) {
+  app.get("/", async (req, reply) => {
+    // validation and business logic
+
+    // set span attribute
+    getActiveSpan()?.setAttribute("business.info", "dummy");
+
+    reply.status(200).send(response);
+  });
+}
+```
+
 ## Sending Custom Metrics
 
 This package gives the possibility to send custom metrics and define them as desired in the code, you can choose between sync metrics and observable async metrics.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import type { NodeSDK } from "@opentelemetry/sdk-node";
-import type { NodeSDKConfig } from "./lib/index.js";
 import buildNodeInstrumentation from "./lib/instrumentation.node.js";
 export type * from "./lib/index.js";
-export type { NodeSDKConfig, NodeSDK };
+export type { NodeSDK };
 export { buildNodeInstrumentation as instrumentNode };
 export * from "./lib/metrics.js";
+export * from "./lib/traces.js";

package/dist/index.js

@@ -1,3 +1,4 @@
 import buildNodeInstrumentation from "./lib/instrumentation.node.js";
 export { buildNodeInstrumentation as instrumentNode };
 export * from "./lib/metrics.js";
+export * from "./lib/traces.js";

package/dist/lib/exporter/console.d.ts

@@ -0,0 +1,3 @@
+import { NodeSDKConfig } from "../index.js";
+import { Exporters } from "../options.js";
+export default function buildConsoleExporters(config: NodeSDKConfig): Exporters;

package/dist/lib/exporter/console.js

@@ -0,0 +1,16 @@
+import { ConsoleLogRecordExporter, SimpleLogRecordProcessor, } from "@opentelemetry/sdk-logs";
+import { metrics } from "@opentelemetry/sdk-node";
+import { ConsoleSpanExporter, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
+export default function buildConsoleExporters(config) {
+    return {
+        spans: [
+            new SimpleSpanProcessor(new ConsoleSpanExporter()),
+            new EnrichSpanProcessor(config.spanAttributes),
+        ],
+        metrics: new metrics.PeriodicExportingMetricReader({
+            exporter: new metrics.ConsoleMetricExporter(),
+        }),
+        logs: [new SimpleLogRecordProcessor(new ConsoleLogRecordExporter())],
+    };
+}

package/dist/lib/exporter/grpc.d.ts

@@ -0,0 +1,3 @@
+import { NodeSDKConfig } from "../index.js";
+import { Exporters } from "../options.js";
+export default function buildGrpcExporters(config: NodeSDKConfig): Exporters;

package/dist/lib/{grpc.js → exporter/grpc.js}

@@ -1,15 +1,19 @@
-import { LogRecordProcessorMap } from "./utils.js";
 import { metrics } from "@opentelemetry/sdk-node";
 import { CompressionAlgorithm } from "@opentelemetry/otlp-exporter-base";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-grpc";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-grpc";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-grpc";
+import { LogRecordProcessorMap, SpanProcessorMap } from "../utils.js";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
 export default function buildGrpcExporters(config) {
     return {
-        traces: new OTLPTraceExporter({
-            url: `${config.collectorUrl}`,
-            compression: CompressionAlgorithm.GZIP,
-        }),
+        spans: [
+            new SpanProcessorMap[config.collectorMode ?? "batch"](new OTLPTraceExporter({
+                url: `${config.collectorUrl}`,
+                compression: CompressionAlgorithm.GZIP,
+            })),
+            new EnrichSpanProcessor(config.spanAttributes),
+        ],
         metrics: new metrics.PeriodicExportingMetricReader({
             exporter: new OTLPMetricExporter({
                 url: `${config.collectorUrl}`,

package/dist/lib/exporter/http.d.ts

@@ -0,0 +1,3 @@
+import { Exporters } from "../options.js";
+import { NodeSDKConfig } from "../index.js";
+export default function buildHttpExporters(config: NodeSDKConfig): Exporters;

package/dist/lib/{http.js → exporter/http.js}

@@ -1,18 +1,22 @@
-import { LogRecordProcessorMap } from "./utils.js";
 import { metrics } from "@opentelemetry/sdk-node";
 import { CompressionAlgorithm } from "@opentelemetry/otlp-exporter-base";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { LogRecordProcessorMap, SpanProcessorMap } from "../utils.js";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
 export default function buildHttpExporters(config) {
     if (config.collectorUrl.endsWith("/")) {
         config.collectorUrl = config.collectorUrl.slice(0, -1);
     }
     return {
-        traces: new OTLPTraceExporter({
-            url: `${config.collectorUrl}/v1/traces`,
-            compression: CompressionAlgorithm.GZIP,
-        }),
+        spans: [
+            new SpanProcessorMap[config.collectorMode ?? "batch"](new OTLPTraceExporter({
+                url: `${config.collectorUrl}/v1/traces`,
+                compression: CompressionAlgorithm.GZIP,
+            })),
+            new EnrichSpanProcessor(config.spanAttributes),
+        ],
         metrics: new metrics.PeriodicExportingMetricReader({
             exporter: new OTLPMetricExporter({
                 url: `${config.collectorUrl}/v1/metrics`,

package/dist/lib/index.d.ts

@@ -1,4 +1,4 @@
-interface SDKConfig {
+export interface NodeSDKConfig {
     /**
      * The opentelemetry collector entrypoint GRPC url.
      * If the collectoUrl is null or undefined, the instrumentation will not be activated.
@@ -32,8 +32,20 @@ interface SDKConfig {
      * @default []
      */
     ignoreUrls?: SamplerCondition[];
-}
-export interface NodeSDKConfig extends SDKConfig {
+    /**
+     * Object containing static properties or functions used to evaluate custom attributes for every logs and traces.
+     */
+    spanAttributes?: Record<string, SignalAttributeValue | (() => SignalAttributeValue)>;
+    /**
+     * Object containing static properties used as resources attributes for the Node SDK initialization.
+     */
+    resourceAttributes?: Record<string, SignalAttributeValue>;
+    /**
+     * Faction value from 0 to 1, used by TraceIdRatioBasedSampler which it deterministically samples a percentage of traces that you pass in as a parameter.
+     *
+     * @default 1
+     */
+    traceRatio?: number;
     /**
      * Flag to enable or disable the tracing for node:fs module
      *
@@ -41,7 +53,7 @@ export interface NodeSDKConfig extends SDKConfig {
      */
     enableFS?: boolean;
     /**
-     * protocol used to send signals.
+     * Protocol used to send signals.
      *
      * @default grpc
      */
@@ -51,7 +63,7 @@ export interface SamplerCondition {
     type: "endsWith" | "includes" | "equals";
     url: string;
 }
+export type SignalAttributeValue = string | number | boolean;
 export type SDKCollectorMode = "single" | "batch";
 export type SDKProtocol = "grpc" | "http" | "console";
 export type SDKLogLevel = "NONE" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "VERBOSE" | "ALL";
-export {};

package/dist/lib/instrumentation.node.js

@@ -1,11 +1,12 @@
-import { NodeSDK, resources } from "@opentelemetry/sdk-node";
-import buildHttpExporters from "./http.js";
-import buildGrpcExporters from "./grpc.js";
-import buildConsoleExporters from "./console.js";
-import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
+import { diag, DiagConsoleLogger, DiagLogLevel, } from "@opentelemetry/api";
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";
+import { NodeSDK, resources } from "@opentelemetry/sdk-node";
+import { AlwaysOffSampler, ParentBasedSampler, TraceIdRatioBasedSampler, } from "@opentelemetry/sdk-trace-base";
 import packageJson from "../package.json" with { type: "json" };
+import buildConsoleExporters from "./exporter/console.js";
+import buildGrpcExporters from "./exporter/grpc.js";
+import buildHttpExporters from "./exporter/http.js";
 import { UrlSampler } from "./url-sampler.js";
 export default function buildNodeInstrumentation(config) {
     if (!config) {
@@ -30,6 +31,14 @@ export default function buildNodeInstrumentation(config) {
     else {
         exporter = buildGrpcExporters(config);
     }
+    const urlSampler = new UrlSampler(config.ignoreUrls, new TraceIdRatioBasedSampler(config.traceRatio ?? 1));
+    const mainSampler = new ParentBasedSampler({
+        root: urlSampler,
+        remoteParentSampled: urlSampler,
+        remoteParentNotSampled: new AlwaysOffSampler(),
+        localParentSampled: urlSampler,
+        localParentNotSampled: new AlwaysOffSampler(),
+    });
     try {
         diag.setLogger(new DiagConsoleLogger(), config.diagLogLevel
             ? DiagLogLevel[config.diagLogLevel]
@@ -38,18 +47,28 @@ export default function buildNodeInstrumentation(config) {
             resource: new resources.Resource({
                 "o11y.sdk.name": packageJson.name,
                 "o11y.sdk.version": packageJson.version,
+                ...config.resourceAttributes,
             }),
+            spanProcessors: exporter.spans,
             serviceName: config.serviceName,
-            traceExporter: exporter.traces,
             metricReader: exporter.metrics,
             logRecordProcessors: exporter.logs,
-            sampler: new UrlSampler(config.ignoreUrls),
+            sampler: mainSampler,
             textMapPropagator: new W3CTraceContextPropagator(),
             instrumentations: [
                 getNodeAutoInstrumentations({
                     "@opentelemetry/instrumentation-fs": {
                         enabled: config.enableFS ?? false,
                     },
+                    "@opentelemetry/instrumentation-pino": {
+                        logHook: (_span, record, _level) => {
+                            if (config.spanAttributes != undefined) {
+                                for (const [key, value] of Object.entries(config.spanAttributes)) {
+                                    record[key] = typeof value === "function" ? value() : value;
+                                }
+                            }
+                        },
+                    },
                 }),
             ],
         });

package/dist/lib/options.d.ts

@@ -1,6 +1,8 @@
-import type { logs, tracing, metrics } from "@opentelemetry/sdk-node";
+import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import type { metrics } from "@opentelemetry/sdk-node";
+import { SpanProcessor } from "@opentelemetry/sdk-trace-base";
 export type Exporters = {
-    traces: tracing.SpanExporter;
+    spans: SpanProcessor[];
     metrics: metrics.MetricReader;
-    logs: logs.LogRecordProcessor[];
+    logs: LogRecordProcessor[];
 };

package/dist/lib/processor/enrich-span-processor.d.ts

@@ -0,0 +1,11 @@
+import { Context } from "@opentelemetry/api";
+import { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { SignalAttributeValue } from "../index.js";
+export declare class EnrichSpanProcessor implements SpanProcessor {
+    private _spanAttributes;
+    constructor(spanAttributes?: Record<string, SignalAttributeValue | (() => SignalAttributeValue)>);
+    forceFlush(): Promise<void>;
+    onStart(span: Span, _context: Context): void;
+    onEnd(_span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+}

package/dist/lib/processor/enrich-span-processor.js

@@ -0,0 +1,22 @@
+export class EnrichSpanProcessor {
+    _spanAttributes;
+    constructor(spanAttributes) {
+        this._spanAttributes = spanAttributes;
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+    onStart(span, _context) {
+        if (this._spanAttributes != undefined) {
+            for (const [key, value] of Object.entries(this._spanAttributes)) {
+                span.setAttribute(key, typeof value === "function" ? value() : value);
+            }
+        }
+    }
+    onEnd(_span) {
+        return;
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+}

package/dist/lib/traces.d.ts

@@ -0,0 +1 @@
+export declare function getActiveSpan(): import("@opentelemetry/api").Span | undefined;

package/dist/lib/traces.js

@@ -0,0 +1,4 @@
+import { trace } from "@opentelemetry/api";
+export function getActiveSpan() {
+    return trace.getActiveSpan();
+}

package/dist/lib/url-sampler.d.ts

@@ -1,9 +1,10 @@
-import { Context, SpanKind, Link, Attributes } from "@opentelemetry/api";
+import { Attributes, Context, Link, SpanKind } from "@opentelemetry/api";
 import { Sampler, SamplingResult } from "@opentelemetry/sdk-trace-base";
 import { SamplerCondition } from "./index.js";
 export declare class UrlSampler implements Sampler {
     private _samplerCondition;
-    constructor(samplerCondition?: SamplerCondition[]);
+    private _nextSampler;
+    constructor(samplerCondition: SamplerCondition[] | undefined, nextSampler: Sampler);
     shouldSample(_context: Context, traceId: string, _spanName: string, _spanKind: SpanKind, attributes: Attributes, _links: Link[]): SamplingResult;
     toString(): string;
 }

package/dist/lib/url-sampler.js

@@ -1,9 +1,10 @@
-import { isValidTraceId, } from "@opentelemetry/api";
 import { SamplingDecision, } from "@opentelemetry/sdk-trace-base";
 export class UrlSampler {
     _samplerCondition;
-    constructor(samplerCondition = []) {
+    _nextSampler;
+    constructor(samplerCondition = [], nextSampler) {
         this._samplerCondition = samplerCondition;
+        this._nextSampler = nextSampler;
     }
     shouldSample(_context, traceId, _spanName, _spanKind, attributes, _links) {
         const url = attributes["http.target"]?.toString();
@@ -16,13 +17,9 @@ export class UrlSampler {
                 }
             }
         }
-        return {
-            decision: isValidTraceId(traceId)
-                ? SamplingDecision.RECORD_AND_SAMPLED
-                : SamplingDecision.NOT_RECORD,
-        };
+        return this._nextSampler.shouldSample(_context, traceId, _spanName, _spanKind, attributes, _links);
     }
     toString() {
-        throw "UrlSampler";
+        return "UrlSampler";
     }
 }

package/dist/lib/utils.d.ts

@@ -1,3 +1,5 @@
+import { BatchLogRecordProcessor, SimpleLogRecordProcessor } from "@opentelemetry/sdk-logs";
 import { SDKCollectorMode } from "./index.js";
-import { logs } from "@opentelemetry/sdk-node";
-export declare const LogRecordProcessorMap: Record<SDKCollectorMode, typeof logs.SimpleLogRecordProcessor | typeof logs.BatchLogRecordProcessor>;
+import { tracing } from "@opentelemetry/sdk-node";
+export declare const LogRecordProcessorMap: Record<SDKCollectorMode, typeof SimpleLogRecordProcessor | typeof BatchLogRecordProcessor>;
+export declare const SpanProcessorMap: Record<SDKCollectorMode, typeof tracing.SimpleSpanProcessor | typeof tracing.BatchSpanProcessor>;

package/dist/lib/utils.js

@@ -1,5 +1,10 @@
-import { logs } from "@opentelemetry/sdk-node";
+import { BatchLogRecordProcessor, SimpleLogRecordProcessor, } from "@opentelemetry/sdk-logs";
+import { tracing } from "@opentelemetry/sdk-node";
 export const LogRecordProcessorMap = {
-    single: logs.SimpleLogRecordProcessor,
-    batch: logs.BatchLogRecordProcessor,
+    single: SimpleLogRecordProcessor,
+    batch: BatchLogRecordProcessor,
+};
+export const SpanProcessorMap = {
+    single: tracing.SimpleSpanProcessor,
+    batch: tracing.BatchSpanProcessor,
 };

package/dist/package.json

@@ -1,13 +1,16 @@
 {
     "name": "@ogcio/o11y-sdk-node",
-    "version": "0.1.0-beta.6",
+    "version": "0.1.0-beta.7",
     "description": "Opentelemetry standard instrumentation SDK for NodeJS based project",
     "main": "dist/index.js",
     "type": "module",
     "scripts": {
         "build": "rm -rf dist && tsc -p tsconfig.json",
         "test": "vitest",
-        "prepublishOnly": "pnpm i && pnpm build"
+        "prepublishOnly": "pnpm i && pnpm build",
+        "test:unit": "vitest --project unit",
+        "test:integration": "pnpm --filter @ogcio/o11y run prepare:integration && vitest --project integration",
+        "test:integration:dryrun": "vitest --project integration"
     },
     "exports": {
         ".": "./dist/index.js",
@@ -27,23 +30,24 @@
         "@opentelemetry/api": "^1.9.0",
         "@opentelemetry/auto-instrumentations-node": "^0.56.0",
         "@opentelemetry/core": "1.30.1",
-        "@opentelemetry/exporter-logs-otlp-grpc": "^0.57.1",
-        "@opentelemetry/exporter-logs-otlp-http": "^0.57.1",
-        "@opentelemetry/exporter-metrics-otlp-grpc": "^0.57.1",
-        "@opentelemetry/exporter-metrics-otlp-http": "^0.57.1",
-        "@opentelemetry/exporter-trace-otlp-grpc": "^0.57.1",
-        "@opentelemetry/exporter-trace-otlp-http": "^0.57.1",
-        "@opentelemetry/instrumentation": "^0.57.1",
-        "@opentelemetry/otlp-exporter-base": "^0.57.1",
+        "@opentelemetry/exporter-logs-otlp-grpc": "^0.57.2",
+        "@opentelemetry/exporter-logs-otlp-http": "^0.57.2",
+        "@opentelemetry/exporter-metrics-otlp-grpc": "^0.57.2",
+        "@opentelemetry/exporter-metrics-otlp-http": "^0.57.2",
+        "@opentelemetry/exporter-trace-otlp-grpc": "^0.57.2",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.57.2",
+        "@opentelemetry/instrumentation": "^0.57.2",
+        "@opentelemetry/otlp-exporter-base": "^0.57.2",
+        "@opentelemetry/sdk-logs": "^0.57.2",
         "@opentelemetry/sdk-metrics": "^1.30.1",
-        "@opentelemetry/sdk-node": "^0.57.1",
+        "@opentelemetry/sdk-node": "^0.57.2",
         "@opentelemetry/sdk-trace-base": "^1.30.1"
     },
     "devDependencies": {
-        "@types/node": "^22.12.0",
-        "@vitest/coverage-v8": "^3.0.4",
+        "@types/node": "^22.13.4",
+        "@vitest/coverage-v8": "^3.0.5",
         "tsx": "^4.19.2",
         "typescript": "^5.7.3",
-        "vitest": "^3.0.4"
+        "vitest": "^3.0.5"
     }
 }

package/dist/vitest.config.js

@@ -3,7 +3,6 @@ export default defineConfig({
     test: {
         globals: true,
         watch: false,
-        include: ["**/test/*.test.ts", "**/test/integration/*.test.ts"],
         exclude: ["**/fixtures/**", "**/dist/**"],
         poolOptions: {
             threads: {
@@ -21,5 +20,20 @@ export default defineConfig({
         },
         reporters: ["default", ["junit", { outputFile: "test-report.xml" }]],
         environment: "node",
+        pool: "threads",
+        workspace: [
+            {
+                test: {
+                    include: ["**/test/*.test.ts"],
+                    name: "unit",
+                },
+            },
+            {
+                test: {
+                    include: ["**/test/integration/*.test.ts"],
+                    name: "integration",
+                },
+            },
+        ],
     },
 });

package/index.ts

@@ -1,9 +1,9 @@
 import type { NodeSDK } from "@opentelemetry/sdk-node";
-import type { NodeSDKConfig } from "./lib/index.js";
 import buildNodeInstrumentation from "./lib/instrumentation.node.js";
 
 export type * from "./lib/index.js";
-export type { NodeSDKConfig, NodeSDK };
+export type { NodeSDK };
 export { buildNodeInstrumentation as instrumentNode };
 
 export * from "./lib/metrics.js";
+export * from "./lib/traces.js";

package/lib/exporter/console.ts

@@ -0,0 +1,27 @@
+import {
+  ConsoleLogRecordExporter,
+  SimpleLogRecordProcessor,
+} from "@opentelemetry/sdk-logs";
+import { metrics } from "@opentelemetry/sdk-node";
+import {
+  ConsoleSpanExporter,
+  SimpleSpanProcessor,
+} from "@opentelemetry/sdk-trace-base";
+import { NodeSDKConfig } from "../index.js";
+import { Exporters } from "../options.js";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
+
+export default function buildConsoleExporters(
+  config: NodeSDKConfig,
+): Exporters {
+  return {
+    spans: [
+      new SimpleSpanProcessor(new ConsoleSpanExporter()),
+      new EnrichSpanProcessor(config.spanAttributes),
+    ],
+    metrics: new metrics.PeriodicExportingMetricReader({
+      exporter: new metrics.ConsoleMetricExporter(),
+    }),
+    logs: [new SimpleLogRecordProcessor(new ConsoleLogRecordExporter())],
+  };
+}

package/lib/{grpc.ts → exporter/grpc.ts}

@@ -1,18 +1,24 @@
-import type { NodeSDKConfig } from "./index.js";
-import type { Exporters } from "./options.js";
-import { LogRecordProcessorMap } from "./utils.js";
 import { metrics } from "@opentelemetry/sdk-node";
 import { CompressionAlgorithm } from "@opentelemetry/otlp-exporter-base";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-grpc";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-grpc";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-grpc";
+import { NodeSDKConfig } from "../index.js";
+import { Exporters } from "../options.js";
+import { LogRecordProcessorMap, SpanProcessorMap } from "../utils.js";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
 
 export default function buildGrpcExporters(config: NodeSDKConfig): Exporters {
   return {
-    traces: new OTLPTraceExporter({
-      url: `${config.collectorUrl}`,
-      compression: CompressionAlgorithm.GZIP,
-    }),
+    spans: [
+      new SpanProcessorMap[config.collectorMode ?? "batch"](
+        new OTLPTraceExporter({
+          url: `${config.collectorUrl}`,
+          compression: CompressionAlgorithm.GZIP,
+        }),
+      ),
+      new EnrichSpanProcessor(config.spanAttributes),
+    ],
     metrics: new metrics.PeriodicExportingMetricReader({
       exporter: new OTLPMetricExporter({
         url: `${config.collectorUrl}`,

package/lib/{http.ts → exporter/http.ts}

@@ -1,11 +1,12 @@
-import type { NodeSDKConfig } from "./index.js";
-import type { Exporters } from "./options.js";
-import { LogRecordProcessorMap } from "./utils.js";
 import { metrics } from "@opentelemetry/sdk-node";
 import { CompressionAlgorithm } from "@opentelemetry/otlp-exporter-base";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { LogRecordProcessorMap, SpanProcessorMap } from "../utils.js";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
+import { Exporters } from "../options.js";
+import { NodeSDKConfig } from "../index.js";
 
 export default function buildHttpExporters(config: NodeSDKConfig): Exporters {
   if (config.collectorUrl.endsWith("/")) {
@@ -13,10 +14,15 @@ export default function buildHttpExporters(config: NodeSDKConfig): Exporters {
   }
 
   return {
-    traces: new OTLPTraceExporter({
-      url: `${config.collectorUrl}/v1/traces`,
-      compression: CompressionAlgorithm.GZIP,
-    }),
+    spans: [
+      new SpanProcessorMap[config.collectorMode ?? "batch"](
+        new OTLPTraceExporter({
+          url: `${config.collectorUrl}/v1/traces`,
+          compression: CompressionAlgorithm.GZIP,
+        }),
+      ),
+      new EnrichSpanProcessor(config.spanAttributes),
+    ],
     metrics: new metrics.PeriodicExportingMetricReader({
       exporter: new OTLPMetricExporter({
         url: `${config.collectorUrl}/v1/metrics`,