@snokam/application-insights 1.3.1 → 1.3.3

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.3.3](https://github.com/snokam/components/compare/%40snokam%2Fapplication-insights%401.3.1...%40snokam%2Fapplication-insights%401.3.3) (2026-11-11)
+
+### Bug Fixes
+
+- error pipeline noise filters, burst alerts, telemetry roles and per-activity fan-out logs ([#3496](https://github.com/snokam/components/issues/3496)) ([e41e941](https://github.com/snokam/components/commit/e41e9415a899f075585923989c87b2ea4f27f273))
+- **web:** prod error cluster: story swiper crash, scanner noise, stale-deployment reload ([#3530](https://github.com/snokam/components/issues/3530)) ([f3a6c67](https://github.com/snokam/components/commit/f3a6c6713acfda5e087c4ed74881ecb95f0b76b1))
+
+## [1.3.2](https://github.com/snokam/components/compare/%40snokam%2Fapplication-insights%401.3.1...%40snokam%2Fapplication-insights%401.3.2) (2026-11-10)
+
+### Bug Fixes
+
+- error pipeline noise filters, burst alerts, telemetry roles and per-activity fan-out logs ([#3496](https://github.com/snokam/components/issues/3496)) ([e41e941](https://github.com/snokam/components/commit/e41e9415a899f075585923989c87b2ea4f27f273))
+
 ## [1.3.1](https://github.com/snokam/components/compare/%40snokam%2Fapplication-insights%401.3.0...%40snokam%2Fapplication-insights%401.3.1) (2026-11-09)
 
 ### Bug Fixes

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@snokam/application-insights",
   "description": "Snøkam core components",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "main": "src/index.tsx",
   "sideEffects": false,
   "types": "src/index.tsx",

package/src/Provider.tsx

@@ -11,10 +11,11 @@ import {
   IConfiguration,
   ITelemetryPlugin,
 } from "@microsoft/applicationinsights-web";
+import { withCloudRole } from "./telemetry/cloudRole";
 
 export interface ProviderProps {
   children: ReactNode;
-  config: IConfiguration & IConfig;
+  config: IConfiguration & IConfig & { cloudRole?: string };
 }
 
 export const Provider = ({ children, config }: ProviderProps) => {
@@ -28,6 +29,7 @@ export const Provider = ({ children, config }: ProviderProps) => {
 
   useEffect(() => {
     if (!appInsightsRef.current) {
+      const { cloudRole, ...sdkConfig } = config;
       appInsightsRef.current = new ApplicationInsights({
         config: {
           maxBatchSizeInBytes: 10000,
@@ -37,11 +39,12 @@ export const Provider = ({ children, config }: ProviderProps) => {
           extensionConfig: {
             [reactPluginRef.current.identifier]: { history: browserHistory },
           },
-          ...config,
+          ...sdkConfig,
         },
       });
 
       appInsightsRef.current.loadAppInsights();
+      appInsightsRef.current.addTelemetryInitializer(withCloudRole(cloudRole));
 
       appInsightsRef.current.addTelemetryInitializer((envelope) => {
         const baseType = envelope.baseType || "";

package/src/app-router.tsx

@@ -13,10 +13,11 @@ import {
   IConfiguration,
   ITelemetryPlugin,
 } from "@microsoft/applicationinsights-web";
+import { withCloudRole } from "./telemetry/cloudRole";
 
 export interface ProviderProps {
   children: ReactNode;
-  config: IConfiguration & IConfig;
+  config: IConfiguration & IConfig & { cloudRole?: string };
 }
 
 function PageViewTracker({
@@ -45,6 +46,7 @@ function AppRouterProvider({ children, config }: ProviderProps) {
     if (started.current) return;
     started.current = true;
     const browserHistory = createBrowserHistory();
+    const { cloudRole, ...sdkConfig } = config;
     const appInsights = new ApplicationInsights({
       config: {
         maxBatchSizeInBytes: 10000,
@@ -55,11 +57,12 @@ function AppRouterProvider({ children, config }: ProviderProps) {
         extensionConfig: {
           [reactPluginRef.current.identifier]: { history: browserHistory },
         },
-        ...config,
+        ...sdkConfig,
       },
     });
 
     appInsights.loadAppInsights();
+    appInsights.addTelemetryInitializer(withCloudRole(cloudRole));
 
     appInsights.addTelemetryInitializer((envelope) => {
       const baseType = envelope.baseType || "";

package/src/server.ts

@@ -4,6 +4,8 @@ import {
   type RequestLocation,
   type ServerError,
 } from "./telemetry/exceptionEnvelope";
+import { operationIdFrom } from "./telemetry/operationId";
+import { isRequestNoise } from "./telemetry/requestNoise";
 
 type ErrorRequest = {
   path?: string;
@@ -57,14 +59,20 @@ export async function onRequestError(
     routePath: context.routePath,
     routeType: context.routeType,
     renderSource: context.renderSource,
+    operationId: operationIdFrom(request.headers?.["traceparent"], () =>
+      crypto.randomUUID().replaceAll("-", "")
+    ),
   };
-  console.error(
-    "[server-error]",
+  const noise = isRequestNoise(error, location);
+  const log = noise ? console.warn : console.error;
+  log(
+    noise ? "[server-request-noise]" : "[server-error]",
     JSON.stringify({
       ...location,
       message: error instanceof Error ? error.message : String(error),
       stack: error instanceof Error ? error.stack : undefined,
     })
   );
+  if (noise) return;
   await trackException({ error, location });
 }

package/src/telemetry/cloudRole.ts

@@ -0,0 +1,8 @@
+import type { ITelemetryItem } from "@microsoft/applicationinsights-web";
+
+export function withCloudRole(cloudRole: string | undefined) {
+  return (envelope: ITelemetryItem) => {
+    if (!cloudRole) return;
+    envelope.tags = { ...envelope.tags, "ai.cloud.role": cloudRole };
+  };
+}

package/src/telemetry/exceptionEnvelope.ts

@@ -5,6 +5,7 @@ export type RequestLocation = {
   routePath?: string;
   routeType?: string;
   renderSource?: string;
+  operationId?: string;
 };
 
 export type ServerError = {
@@ -86,6 +87,7 @@ export function exceptionEnvelope(
       "ai.cloud.role": role.name,
       "ai.cloud.roleInstance": role.instance,
       "ai.operation.name": operationName || undefined,
+      "ai.operation.id": location.operationId,
     }),
     data: {
       baseType: "ExceptionData",

package/src/telemetry/operationId.ts

@@ -0,0 +1,10 @@
+const TRACEPARENT = /^[\da-f]{2}-([\da-f]{32})-[\da-f]{16}-[\da-f]{2}$/;
+const INVALID_TRACE_ID = "0".repeat(32);
+
+export function operationIdFrom(
+  traceparent: string | undefined,
+  newId: () => string
+) {
+  const traceId = traceparent?.match(TRACEPARENT)?.[1];
+  return traceId && traceId !== INVALID_TRACE_ID ? traceId : newId();
+}

package/src/telemetry/requestNoise.test.ts

@@ -0,0 +1,73 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { isRequestNoise } from "./requestNoise.ts";
+
+const page = {
+  method: "POST",
+  path: "/",
+  routePath: "/(public)/www/[host]/page",
+};
+
+test("a server action from another deployment or a scanner is not a server error", () => {
+  const error = new Error(
+    "Failed to find Server Action. This request might be from an older or newer deployment.\nRead more: https://nextjs.org/docs/messages/failed-to-find-server-action"
+  );
+
+  assert.equal(isRequestNoise(error, page), true);
+});
+
+test("a visitor who leaves before the page finished streaming is not a server error", () => {
+  const error = new Error("The destination stream closed early.");
+
+  assert.equal(
+    isRequestNoise(error, {
+      method: "GET",
+      path: "/?_rsc=abc",
+      routePath: "/minside/[host]",
+    }),
+    true
+  );
+});
+
+test("a server action posted to a page that does not exist is not a server error", () => {
+  const error = Object.assign(
+    new Error(
+      "Invariant: Expected RSC response, got text/plain. This is a bug in Next.js."
+    ),
+    { name: "InvariantError" }
+  );
+
+  assert.equal(
+    isRequestNoise(error, {
+      method: "POST",
+      path: "/login",
+      routePath: "/_not-found/page",
+    }),
+    true
+  );
+});
+
+test("the same invariant on a real page is still reported", () => {
+  const error = new Error(
+    "Invariant: Expected RSC response, got text/plain. This is a bug in Next.js."
+  );
+
+  assert.equal(isRequestNoise(error, page), false);
+  assert.equal(
+    isRequestNoise(error, { method: "GET", routePath: "/_not-found/page" }),
+    false
+  );
+});
+
+test("failed api calls and render crashes are still reported", () => {
+  const failed = Object.assign(new Error("Response returned an error code"), {
+    name: "ResponseError",
+  });
+
+  assert.equal(isRequestNoise(failed, page), false);
+  assert.equal(
+    isRequestNoise(new ReferenceError("TRACK_BAR is not defined"), page),
+    false
+  );
+  assert.equal(isRequestNoise("boom", page), false);
+});

package/src/telemetry/requestNoise.ts

@@ -0,0 +1,27 @@
+import type { RequestLocation } from "./exceptionEnvelope";
+
+const UNKNOWN_SERVER_ACTION = "Failed to find Server Action";
+const CLIENT_LEFT = "The destination stream closed early";
+const ACTION_ON_MISSING_PAGE = "Expected RSC response, got text/plain";
+const NOT_FOUND_ROUTE = "/_not-found/page";
+
+function messageOf(error: unknown) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+function isActionOnMissingPage(message: string, location: RequestLocation) {
+  return (
+    message.includes(ACTION_ON_MISSING_PAGE) &&
+    location.method === "POST" &&
+    location.routePath === NOT_FOUND_ROUTE
+  );
+}
+
+export function isRequestNoise(error: unknown, location: RequestLocation) {
+  const message = messageOf(error);
+  return (
+    message.startsWith(UNKNOWN_SERVER_ACTION) ||
+    message.startsWith(CLIENT_LEFT) ||
+    isActionOnMissingPage(message, location)
+  );
+}

package/src/telemetry/telemetry.test.ts

@@ -2,6 +2,8 @@ import { test } from "node:test";
 import assert from "node:assert/strict";
 import { parseConnectionString } from "./connectionString.ts";
 import { exceptionEnvelope } from "./exceptionEnvelope.ts";
+import { operationIdFrom } from "./operationId.ts";
+import { withCloudRole } from "./cloudRole.ts";
 
 const connectionString =
   "InstrumentationKey=7e4c6e13-0000-0000-0000-000000000000;IngestionEndpoint=https://norwayeast-0.in.applicationinsights.azure.com/;LiveEndpoint=https://norwayeast.livediagnostics.monitor.azure.com/;ApplicationId=abc";
@@ -31,6 +33,7 @@ test("a render crash becomes an error-level exception for the site", () => {
         path: "/skjer/julebord",
         routePath: "/[host]/skjer/[slug]",
         routeType: "render",
+        operationId: "4bf92f3577b34da6a3ce929d0e0e4736",
       },
     },
     { name: "app-plfm-web-t", instance: "web-1" },
@@ -42,6 +45,10 @@ test("a render crash becomes an error-level exception for the site", () => {
   assert.equal(envelope.time, "2026-11-08T10:00:00.000Z");
   assert.equal(envelope.tags["ai.cloud.role"], "app-plfm-web-t");
   assert.equal(envelope.tags["ai.operation.name"], "GET /[host]/skjer/[slug]");
+  assert.equal(
+    envelope.tags["ai.operation.id"],
+    "4bf92f3577b34da6a3ce929d0e0e4736"
+  );
   const data = envelope.data.baseData;
   assert.equal(data.severityLevel, 3);
   assert.equal(data.problemId, "ReferenceError at /[host]/skjer/[slug]");
@@ -49,6 +56,7 @@ test("a render crash becomes an error-level exception for the site", () => {
   assert.equal(data.exceptions[0].message, "localStorage is not defined");
   assert.equal(data.exceptions[0].hasFullStack, true);
   assert.equal(data.properties.path, "/skjer/julebord");
+  assert.equal(data.properties.routePath, "/[host]/skjer/[slug]");
 });
 
 test("a thrown value that is not an Error is still reported", () => {
@@ -107,3 +115,49 @@ test("a request that never got a response names its cause", () => {
     "TimeoutError: The operation was aborted due to timeout"
   );
 });
+
+test("a server error joins the trace of the request that caused it", () => {
+  const id = operationIdFrom(
+    "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
+    () => "fresh"
+  );
+
+  assert.equal(id, "4bf92f3577b34da6a3ce929d0e0e4736");
+});
+
+test("a server error without a usable trace gets its own operation id", () => {
+  assert.equal(
+    operationIdFrom(undefined, () => "fresh"),
+    "fresh"
+  );
+  assert.equal(
+    operationIdFrom("garbage", () => "fresh"),
+    "fresh"
+  );
+  assert.equal(
+    operationIdFrom(
+      "00-00000000000000000000000000000000-00f067aa0ba902b7-01",
+      () => "fresh"
+    ),
+    "fresh"
+  );
+});
+
+test("browser telemetry carries the configured role", () => {
+  const envelope = { name: "PageView", tags: { "ai.session.id": "s" } };
+
+  withCloudRole("web-browser")(envelope);
+
+  assert.deepEqual(envelope.tags, {
+    "ai.session.id": "s",
+    "ai.cloud.role": "web-browser",
+  });
+});
+
+test("browser telemetry is left alone without a role", () => {
+  const envelope = { name: "PageView", tags: {} };
+
+  withCloudRole(undefined)(envelope);
+
+  assert.deepEqual(envelope.tags, {});
+});