@loglayer/plugin-datadog-apm-trace-injector 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Theo Gravity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# Datadog APM Trace Injector Plugin for LogLayer
+
+[![NPM Version](https://img.shields.io/npm/v/%40loglayer%2Fplugin-datadog-apm-trace-injector)](https://www.npmjs.com/package/@loglayer/plugin-datadog-apm-trace-injector)
+[![NPM Downloads](https://img.shields.io/npm/dm/%40loglayer%2Fplugin-datadog-apm-trace-injector)](https://www.npmjs.com/package/@loglayer/plugin-datadog-apm-trace-injector)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+
+A plugin for [LogLayer](https://loglayer.dev) that automatically injects Datadog APM trace context into your logs. This enables correlation between your application logs and distributed traces in Datadog.
+
+## Installation
+
+This plugin requires the [`dd-trace`](https://github.com/DataDog/dd-trace-js) library to be installed in your project:
+
+```bash
+npm install @loglayer/plugin-datadog-apm-trace-injector dd-trace
+```
+
+## Usage
+
+```typescript
+// dd-trace generally needs to be the first import of any project
+// as it needs to patch node_module packages before they are imported
+import tracer from 'dd-trace';
+import { LogLayer } from 'loglayer';
+import { datadogTraceInjectorPlugin } from '@loglayer/plugin-datadog-apm-trace-injector';
+
+// Initialize dd-trace (must be done before any other imports)
+tracer.init();
+
+// Create the plugin
+const traceInjector = datadogTraceInjectorPlugin({
+  tracerInstance: tracer,
+  // Enable the plugin only if the Datadog API key is set
+  enabled: !!process.env.DD_API_KEY
+});
+
+// Add to your LogLayer instance
+const log = new LogLayer({
+  plugins: [traceInjector],
+});
+
+// Your logs will now automatically include trace context
+log.info('User action completed');
+```
+
+### Configuration
+
+The plugin accepts the following configuration options:
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `id` | `string` | Optional. Unique identifier for the plugin |
+| `tracerInstance` | `Tracer` | Required. The dd-trace tracer instance |
+| `disabled` | `boolean` | Optional. Disable the plugin |
+| `onError` | `(error: Error, data?: Record<string, any>) => void` | Optional. Error handler for tracer operation failures |
+
+## Documentation
+
+For more details, visit [https://loglayer.dev/plugins/datadog-apm-trace-injector](https://loglayer.dev/plugins/datadog-apm-trace-injector) 

package/dist/index.cjs

@@ -0,0 +1,28 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/plugin.ts
+function datadogTraceInjectorPlugin(config) {
+  const tracer = config.tracerInstance;
+  return {
+    id: config.id,
+    disabled: config.disabled,
+    onBeforeDataOut({ data }) {
+      if (!data) {
+        data = {};
+      }
+      try {
+        const span = tracer.scope().active();
+        if (span) {
+          tracer.inject(span.context(), "log", data);
+        }
+      } catch (error) {
+        if (config.onError && error instanceof Error) {
+          config.onError(error, data);
+        }
+      }
+      return data;
+    }
+  };
+}
+
+
+exports.datadogTraceInjectorPlugin = datadogTraceInjectorPlugin;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/loglayer/loglayer/packages/plugins/datadog-apm-trace-injector/dist/index.cjs","../src/plugin.ts"],"names":[],"mappings":"AAAA;ACWO,SAAS,0BAAA,CAA2B,MAAA,EAA0D;AACnG,EAAA,MAAM,OAAA,EAAS,MAAA,CAAO,cAAA;AAEtB,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,MAAA,CAAO,EAAA;AAAA,IACX,QAAA,EAAU,MAAA,CAAO,QAAA;AAAA,IACjB,eAAA,CAAgB,EAAE,KAAK,CAAA,EAAmD;AACxE,MAAA,GAAA,CAAI,CAAC,IAAA,EAAM;AACT,QAAA,KAAA,EAAO,CAAC,CAAA;AAAA,MACV;AAEA,MAAA,IAAI;AAGF,QAAA,MAAM,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,CAAA,CAAE,MAAA,CAAO,CAAA;AAEnC,QAAA,GAAA,CAAI,IAAA,EAAM;AACR,UAAA,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,OAAA,CAAQ,CAAA,EAAG,KAAA,EAAO,IAAI,CAAA;AAAA,QAC3C;AAAA,MACF,EAAA,MAAA,CAAS,KAAA,EAAO;AAEd,QAAA,GAAA,CAAI,MAAA,CAAO,QAAA,GAAW,MAAA,WAAiB,KAAA,EAAO;AAC5C,UAAA,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,IAAI,CAAA;AAAA,QAC5B;AAAA,MAGF;AAEA,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA;AACF;ADlBA;AACE;AACF,gEAAC","file":"/home/runner/work/loglayer/loglayer/packages/plugins/datadog-apm-trace-injector/dist/index.cjs","sourcesContent":[null,"import type { LogLayerPlugin, PluginBeforeDataOutParams } from \"@loglayer/plugin\";\nimport type { DatadogTraceInjectorPluginParams } from \"./types.js\";\n\n/**\n * Creates a new Datadog trace injector plugin.\n *\n * This plugin injects the current Datadog APM trace context into the log data.\n *\n * @param config - The datadog trace injector plugin configuration\n * @returns A LogLayer plugin instance\n */\nexport function datadogTraceInjectorPlugin(config: DatadogTraceInjectorPluginParams): LogLayerPlugin {\n  const tracer = config.tracerInstance;\n\n  return {\n    id: config.id,\n    disabled: config.disabled,\n    onBeforeDataOut({ data }: PluginBeforeDataOutParams): Record<string, any> {\n      if (!data) {\n        data = {};\n      }\n\n      try {\n        // Associates log with APM trace\n        // https://docs.datadoghq.com/tracing/other_telemetry/connect_logs_and_traces/nodejs/\n        const span = tracer.scope().active();\n\n        if (span) {\n          tracer.inject(span.context(), \"log\", data);\n        }\n      } catch (error) {\n        // Call error handler if provided, otherwise silently continue\n        if (config.onError && error instanceof Error) {\n          config.onError(error, data);\n        }\n        // Continue logging even if tracer operations fail\n        // This ensures logging doesn't break if dd-trace has issues\n      }\n\n      return data;\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,30 @@
+import { LogLayerPluginParams, LogLayerPlugin } from '@loglayer/plugin';
+import { Tracer } from 'dd-trace';
+
+/**
+ * Configuration parameters for the datadog trace injector plugin.
+ */
+interface DatadogTraceInjectorPluginParams extends LogLayerPluginParams {
+    /**
+     * dd-trace tracer instance
+     */
+    tracerInstance: Tracer;
+    /**
+     * Optional error handler for tracer operation failures
+     * @param error - The error that occurred during tracer operations
+     * @param data - The log data that was being processed when the error occurred
+     */
+    onError?: (error: Error, data?: Record<string, any>) => void;
+}
+
+/**
+ * Creates a new Datadog trace injector plugin.
+ *
+ * This plugin injects the current Datadog APM trace context into the log data.
+ *
+ * @param config - The datadog trace injector plugin configuration
+ * @returns A LogLayer plugin instance
+ */
+declare function datadogTraceInjectorPlugin(config: DatadogTraceInjectorPluginParams): LogLayerPlugin;
+
+export { type DatadogTraceInjectorPluginParams, datadogTraceInjectorPlugin };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { LogLayerPluginParams, LogLayerPlugin } from '@loglayer/plugin';
+import { Tracer } from 'dd-trace';
+
+/**
+ * Configuration parameters for the datadog trace injector plugin.
+ */
+interface DatadogTraceInjectorPluginParams extends LogLayerPluginParams {
+    /**
+     * dd-trace tracer instance
+     */
+    tracerInstance: Tracer;
+    /**
+     * Optional error handler for tracer operation failures
+     * @param error - The error that occurred during tracer operations
+     * @param data - The log data that was being processed when the error occurred
+     */
+    onError?: (error: Error, data?: Record<string, any>) => void;
+}
+
+/**
+ * Creates a new Datadog trace injector plugin.
+ *
+ * This plugin injects the current Datadog APM trace context into the log data.
+ *
+ * @param config - The datadog trace injector plugin configuration
+ * @returns A LogLayer plugin instance
+ */
+declare function datadogTraceInjectorPlugin(config: DatadogTraceInjectorPluginParams): LogLayerPlugin;
+
+export { type DatadogTraceInjectorPluginParams, datadogTraceInjectorPlugin };

package/dist/index.js

@@ -0,0 +1,28 @@
+// src/plugin.ts
+function datadogTraceInjectorPlugin(config) {
+  const tracer = config.tracerInstance;
+  return {
+    id: config.id,
+    disabled: config.disabled,
+    onBeforeDataOut({ data }) {
+      if (!data) {
+        data = {};
+      }
+      try {
+        const span = tracer.scope().active();
+        if (span) {
+          tracer.inject(span.context(), "log", data);
+        }
+      } catch (error) {
+        if (config.onError && error instanceof Error) {
+          config.onError(error, data);
+        }
+      }
+      return data;
+    }
+  };
+}
+export {
+  datadogTraceInjectorPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { LogLayerPlugin, PluginBeforeDataOutParams } from \"@loglayer/plugin\";\nimport type { DatadogTraceInjectorPluginParams } from \"./types.js\";\n\n/**\n * Creates a new Datadog trace injector plugin.\n *\n * This plugin injects the current Datadog APM trace context into the log data.\n *\n * @param config - The datadog trace injector plugin configuration\n * @returns A LogLayer plugin instance\n */\nexport function datadogTraceInjectorPlugin(config: DatadogTraceInjectorPluginParams): LogLayerPlugin {\n  const tracer = config.tracerInstance;\n\n  return {\n    id: config.id,\n    disabled: config.disabled,\n    onBeforeDataOut({ data }: PluginBeforeDataOutParams): Record<string, any> {\n      if (!data) {\n        data = {};\n      }\n\n      try {\n        // Associates log with APM trace\n        // https://docs.datadoghq.com/tracing/other_telemetry/connect_logs_and_traces/nodejs/\n        const span = tracer.scope().active();\n\n        if (span) {\n          tracer.inject(span.context(), \"log\", data);\n        }\n      } catch (error) {\n        // Call error handler if provided, otherwise silently continue\n        if (config.onError && error instanceof Error) {\n          config.onError(error, data);\n        }\n        // Continue logging even if tracer operations fail\n        // This ensures logging doesn't break if dd-trace has issues\n      }\n\n      return data;\n    },\n  };\n}\n"],"mappings":";AAWO,SAAS,2BAA2B,QAA0D;AACnG,QAAM,SAAS,OAAO;AAEtB,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,UAAU,OAAO;AAAA,IACjB,gBAAgB,EAAE,KAAK,GAAmD;AACxE,UAAI,CAAC,MAAM;AACT,eAAO,CAAC;AAAA,MACV;AAEA,UAAI;AAGF,cAAM,OAAO,OAAO,MAAM,EAAE,OAAO;AAEnC,YAAI,MAAM;AACR,iBAAO,OAAO,KAAK,QAAQ,GAAG,OAAO,IAAI;AAAA,QAC3C;AAAA,MACF,SAAS,OAAO;AAEd,YAAI,OAAO,WAAW,iBAAiB,OAAO;AAC5C,iBAAO,QAAQ,OAAO,IAAI;AAAA,QAC5B;AAAA,MAGF;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@loglayer/plugin-datadog-apm-trace-injector",
+  "description": "Injects DataDog APM traces to logs in LogLayer.",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loglayer/loglayer.git",
+    "directory": "packages/plugins/datadog-apm-trace-injector"
+  },
+  "author": "Theo Gravity <theo@suteki.nu>",
+  "keywords": [
+    "logging",
+    "log",
+    "loglayer",
+    "plugin",
+    "datadog",
+    "trace",
+    "injector",
+    "stamp",
+    "apm",
+    "dd-trace"
+  ],
+  "dependencies": {
+    "@loglayer/plugin": "2.1.1",
+    "@loglayer/shared": "2.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.2.1",
+    "express": "5.1.0",
+    "dd-trace": "5.62.0",
+    "tsup": "8.5.0",
+    "tsx": "4.20.4",
+    "typescript": "5.9.2",
+    "vitest": "3.2.4",
+    "@internal/tsconfig": "2.1.0",
+    "loglayer": "6.6.0"
+  },
+  "bugs": "https://github.com/loglayer/loglayer/issues",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://loglayer.dev",
+  "scripts": {
+    "build": "tsup src/index.ts",
+    "test": "vitest --run",
+    "livetest": "tsx src/__tests__/livetest.ts",
+    "clean": "rm -rf .turbo node_modules dist",
+    "lint": "biome check --no-errors-on-unmatched --write --unsafe src",
+    "lint:staged": "biome check --no-errors-on-unmatched --write --unsafe --staged src",
+    "verify-types": "tsc --noEmit"
+  }
+}