@ogcio/o11y-sdk-node 0.1.0-beta.11 → 0.1.0-beta.13

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.1.0-beta.13](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-node@v0.1.0-beta.12...@ogcio/o11y-sdk-node@v0.1.0-beta.13) (2025-06-16)
+
+
+### Bug Fixes
+
+* **sdk-node:** allow graceful shutdown of instrumentation on SIGTERM AB[#28329](https://github.com/ogcio/o11y/issues/28329) ([#151](https://github.com/ogcio/o11y/issues/151)) ([991ee15](https://github.com/ogcio/o11y/commit/991ee1559898b721823cb9d1e0490e2ad82e6d0a))
+
+## [0.1.0-beta.12](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-node@v0.1.0-beta.11...@ogcio/o11y-sdk-node@v0.1.0-beta.12) (2025-06-04)
+
+
+### Features
+
+* add custom log processor for span enrich ([#102](https://github.com/ogcio/o11y/issues/102)) ([bbf8334](https://github.com/ogcio/o11y/commit/bbf83340940ed651dff63bbe7aaa52881d1e8c8c))
+* add opentelemetry sampler ([#66](https://github.com/ogcio/o11y/issues/66)) ([48a1761](https://github.com/ogcio/o11y/commit/48a1761d68fbccf7b63e4232a62376caecf01fbc))
+* april depedency upgrade AB[#27200](https://github.com/ogcio/o11y/issues/27200) ([#116](https://github.com/ogcio/o11y/issues/116)) ([d792fe5](https://github.com/ogcio/o11y/commit/d792fe5a783b0b495912b5bef2babfe11ef5e01d))
+* june deps update ([#147](https://github.com/ogcio/o11y/issues/147)) ([b365a40](https://github.com/ogcio/o11y/commit/b365a4099cdfd8533ffa4948620d29f0044bbd70))
+* may deps update ([#136](https://github.com/ogcio/o11y/issues/136)) ([3edd8b1](https://github.com/ogcio/o11y/commit/3edd8b1d823740d555fc4d93be427e9dc1438a95))
+* o11y sdk repo setup ([#15](https://github.com/ogcio/o11y/issues/15)) ([c5816ba](https://github.com/ogcio/o11y/commit/c5816baff1454353f12539949959e84964ed6401))
+* o11y showcase AB[#25895](https://github.com/ogcio/o11y/issues/25895) ([#84](https://github.com/ogcio/o11y/issues/84)) ([f8f10af](https://github.com/ogcio/o11y/commit/f8f10af97d9f5c188e3e65f7d62d5c673edce25a))
+* remove pnpm test on prepublishOnly script ([#68](https://github.com/ogcio/o11y/issues/68)) ([41f6f57](https://github.com/ogcio/o11y/commit/41f6f57fa415c4f7adc29f49f983539274ef7320))
+* **sdk-node:** add span customization AB[#25358](https://github.com/ogcio/o11y/issues/25358) ([46ba97b](https://github.com/ogcio/o11y/commit/46ba97bac4004ff326a954592f45213ce0e4d683))
+* **sdk-node:** custom metrics ([#53](https://github.com/ogcio/o11y/issues/53)) ([3cb40b1](https://github.com/ogcio/o11y/commit/3cb40b1add3d80615c8d123d233724094559c7ff))
+* **sdk-node:** renaming MetricsParams interface properties AB[#26188](https://github.com/ogcio/o11y/issues/26188) ([#96](https://github.com/ogcio/o11y/issues/96)) ([244aee0](https://github.com/ogcio/o11y/commit/244aee01ae6e7f319ae7f9fdeff27eb40ee3c863))
+* upgrade to opentelemetry 2 AB[#25863](https://github.com/ogcio/o11y/issues/25863) ([#106](https://github.com/ogcio/o11y/issues/106)) ([3ff0314](https://github.com/ogcio/o11y/commit/3ff0314fef9f4d7b5db76da3b94e9035801384c7))
+
+
+### Bug Fixes
+
+* add readme file inside submodule ([#27](https://github.com/ogcio/o11y/issues/27)) ([dc518d5](https://github.com/ogcio/o11y/commit/dc518d5dde573368443bc0f8619e80e331880c78))
+* default attributes in resource ([#112](https://github.com/ogcio/o11y/issues/112)) ([f0f0b9d](https://github.com/ogcio/o11y/commit/f0f0b9d555ef321d31f7171e25dc4b8a5b044522))
+* improve getMetric attributes types ([#76](https://github.com/ogcio/o11y/issues/76)) ([243649c](https://github.com/ogcio/o11y/commit/243649c4bfe750687a729fbd836772cce16e0cb1))
+* prepublishOnly hook ([#60](https://github.com/ogcio/o11y/issues/60)) ([9fbd3ad](https://github.com/ogcio/o11y/commit/9fbd3ad0b45a1604cf2eccc26b2f8855640417a1))
+* **sdk-node:** add waitForReady for grpc-client to handle transient init connection errors AB[#28329](https://github.com/ogcio/o11y/issues/28329) ([#144](https://github.com/ogcio/o11y/issues/144)) ([6f260da](https://github.com/ogcio/o11y/commit/6f260da15fcbcd2c629ec6d4bb9fb3592803f399))
+* **sdk-node:** update sdk init examples AB[#28329](https://github.com/ogcio/o11y/issues/28329) ([#146](https://github.com/ogcio/o11y/issues/146)) ([81de295](https://github.com/ogcio/o11y/commit/81de2957a7bef7430a46c6677f3c876255ef7c88))
+
 ## [0.1.0-beta.11](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-node@v0.1.0-beta.10...@ogcio/o11y-sdk-node@v0.1.0-beta.11) (2025-05-21)
 
 

package/dist/lib/instrumentation.node.js

@@ -1,3 +1,4 @@
+import process from "process";
 import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";
@@ -60,6 +61,16 @@ export default async function buildNodeInstrumentation(config) {
         });
         sdk.start();
         console.log("NodeJS OpenTelemetry instrumentation started successfully.");
+        process.on("SIGTERM", async () => {
+            try {
+                // Flushing before shutdown is implemented on a per-exporter basis.
+                await sdk.shutdown();
+                console.log("NodeJS OpenTelemetry instrumentation shutdown successfully");
+            }
+            catch (error) {
+                console.error("Error shutting down NodeJS OpenTelemetry instrumentation:", error);
+            }
+        });
         return sdk;
     }
     catch (error) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ogcio/o11y-sdk-node",
-    "version": "0.1.0-beta.11",
+    "version": "0.1.0-beta.13",
     "description": "Opentelemetry standard instrumentation SDK for NodeJS based project",
     "main": "dist/index.js",
     "type": "module",
@@ -46,11 +46,11 @@
         "@opentelemetry/sdk-trace-base": "^2.0.1"
     },
     "devDependencies": {
-        "@types/node": "^22.15.29",
-        "@vitest/coverage-v8": "^3.2.1",
+        "@types/node": "^22.15.30",
+        "@vitest/coverage-v8": "^3.2.2",
         "tsx": "^4.19.4",
         "typescript": "^5.8.3",
-        "vitest": "^3.2.1"
+        "vitest": "^3.2.2"
     },
     "engines": {
         "node": ">=20.6.0"

package/dist/vitest.config.js

@@ -21,7 +21,7 @@ export default defineConfig({
         reporters: ["default", ["junit", { outputFile: "test-report.xml" }]],
         environment: "node",
         pool: "threads",
-        workspace: [
+        projects: [
             {
                 test: {
                     include: ["**/test/*.test.ts", "**/test/processor/*.test.ts"],

package/lib/instrumentation.node.ts

@@ -1,3 +1,4 @@
+import process from "process";
 import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";
@@ -89,6 +90,22 @@ export default async function buildNodeInstrumentation(
 
     sdk.start();
     console.log("NodeJS OpenTelemetry instrumentation started successfully.");
+
+    process.on("SIGTERM", async () => {
+      try {
+        // Flushing before shutdown is implemented on a per-exporter basis.
+        await sdk.shutdown();
+        console.log(
+          "NodeJS OpenTelemetry instrumentation shutdown successfully",
+        );
+      } catch (error) {
+        console.error(
+          "Error shutting down NodeJS OpenTelemetry instrumentation:",
+          error,
+        );
+      }
+    });
+
     return sdk;
   } catch (error) {
     console.error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogcio/o11y-sdk-node",
-  "version": "0.1.0-beta.11",
+  "version": "0.1.0-beta.13",
   "description": "Opentelemetry standard instrumentation SDK for NodeJS based project",
   "main": "dist/index.js",
   "type": "module",
@@ -38,11 +38,11 @@
     "@opentelemetry/sdk-trace-base": "^2.0.1"
   },
   "devDependencies": {
-    "@types/node": "^22.15.29",
-    "@vitest/coverage-v8": "^3.2.1",
+    "@types/node": "^22.15.30",
+    "@vitest/coverage-v8": "^3.2.2",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.1"
+    "vitest": "^3.2.2"
   },
   "engines": {
     "node": ">=20.6.0"

package/test/index.test.ts

@@ -1,10 +1,19 @@
-import { describe, test, expect, vi, beforeEach } from "vitest";
+import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
 import { NodeSDKConfig } from "../index";
 import { instrumentNode } from "../index";
 import * as buildNodeInstrumentationModule from "../lib/instrumentation.node";
+import { metrics } from "@opentelemetry/sdk-node";
 
 describe("instrumentNode", () => {
   beforeEach(() => {
+    // @ts-ignore Avoid actually running exporters at any time in tests (overriding private method)
+    vi.spyOn(
+      metrics.PeriodicExportingMetricReader.prototype,
+      "_doRun",
+    ).mockImplementation(vi.fn());
+  });
+
+  afterEach(() => {
     vi.restoreAllMocks();
   });
 
@@ -33,7 +42,29 @@ describe("instrumentNode", () => {
     expect(instrumentationMock).toHaveBeenCalledWith(config);
   });
 
-  test("should not throw when called without arguments", () => {
-    expect(instrumentNode()).resolves.not.toThrow();
+  test("should not throw when called without arguments", async () => {
+    await expect(instrumentNode()).resolves.not.toThrow();
+  });
+
+  test("should invoke instrumentation shutdown on SIGTERM", async () => {
+    const config: NodeSDKConfig = {
+      serviceName: "custom-service",
+      collectorUrl: "http://custom-collector.com",
+      protocol: "grpc",
+      resourceAttributes: {
+        "team.infra.cluster": "dev-01",
+        "team.infra.pod": "01",
+        "team.service.type": "fastify",
+      },
+      spanAttributes: {
+        "signal.namespace": "example",
+        "signal.number": () => "callback",
+      },
+    };
+
+    const sdk = await instrumentNode(config);
+    const shutdownMock = vi.spyOn(sdk, "shutdown");
+    process.emit("SIGTERM");
+    expect(shutdownMock).toHaveBeenCalled();
   });
 });

package/vitest.config.ts

@@ -22,7 +22,7 @@ export default defineConfig({
     reporters: ["default", ["junit", { outputFile: "test-report.xml" }]],
     environment: "node",
     pool: "threads",
-    workspace: [
+    projects: [
       {
         test: {
           include: ["**/test/*.test.ts", "**/test/processor/*.test.ts"],