feat: add opt-in ignoredSpanOps filter for Sentry (2.4.0)

README.md

@@ -96,6 +96,7 @@ All options are passed to `init()` as an `ObservabilityConfig` object.
 | `ignoredRoutes` | `string[]` | `[]` | Routes never sampled by Sentry (e.g. `['/health', '/metrics']`). Trailing slashes and query strings are handled automatically. |
 | `ignoredBreadcrumbCategories` | `string[]` | `['http', 'fetch', 'xhr']` | Breadcrumb categories to apply URL-pattern filtering to. |
 | `ignoredBreadcrumbPatterns` | `RegExp[]` | Pyroscope + PostHog patterns | URL patterns for breadcrumbs that should be dropped entirely. |
+| `ignoredSpanOps` | `string[]` | `[]` | Span ops dropped before sending to Sentry (e.g. `['middleware.express', 'router.express']`). Children are re-parented; OTLP export is unaffected. |
 
 ## API
 

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.5.6/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
   "files": {
     "ignoreUnknown": true,
     "includes": ["**", "!dist", "!node_modules", "!coverage"]

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scope3/observability-js",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Unified observability (Sentry, OpenTelemetry, Pyroscope) for Node.js services",
   "keywords": [
     "observability",

src/__tests__/otel-setup.test.ts

@@ -172,3 +172,26 @@ describe('trace provider registration on the Sentry client', () => {
     }
   }, 2000)
 })
+
+describe('Sentry span filtering', () => {
+  it('passes ignoredSpanOps to Sentry as ignoreSpans', () => {
+    init({
+      serviceName: 'otel-setup-test',
+      environment: 'development',
+      enableOtel: true,
+      sentry: { dsn: SENTRY_DSN, enabled: false },
+      filters: { ignoredSpanOps: ['middleware.express', 'router.express'] },
+    })
+
+    expect(Sentry.getClient()?.getOptions().ignoreSpans).toEqual([
+      { op: 'middleware.express' },
+      { op: 'router.express' },
+    ])
+  })
+
+  it('ignores no spans by default', () => {
+    initWithOtel()
+
+    expect(Sentry.getClient()?.getOptions().ignoreSpans).toEqual([])
+  })
+})

src/config.ts

@@ -81,6 +81,7 @@ export function resolveConfig(config: ObservabilityConfig): ResolvedConfig {
         /posthog\.com/i,
         /i\.posthog\.com/i,
       ],
+      ignoredSpanOps: config.filters?.ignoredSpanOps ?? [],
     },
 
     shouldDropError: config.shouldDropError,

src/provider.ts

@@ -109,6 +109,7 @@ function initializeSentry(config: ResolvedConfig): void {
     ],
     enabled: config.sentry.enabled,
     tracesSampler: buildTracesSampler(config),
+    ignoreSpans: config.filters.ignoredSpanOps.map((op) => ({ op })),
     beforeSend(event, hint) {
       const error = hint?.originalException
 

src/types.ts

@@ -89,6 +89,12 @@ export interface FilterConfig {
    * Defaults to patterns matching Pyroscope and PostHog URLs.
    */
   ignoredBreadcrumbPatterns?: RegExp[]
+  /**
+   * Sentry span ops dropped before spans are sent to Sentry. Children of a
+   * dropped span are re-parented, and OTLP export is unaffected.
+   * Example: `['middleware.express', 'router.express']`. Defaults to `[]`.
+   */
+  ignoredSpanOps?: string[]
 }
 
 /** Top-level configuration passed to {@link init}. */
@@ -177,6 +183,7 @@ export interface ResolvedConfig {
     ignoredRoutes: string[]
     ignoredBreadcrumbCategories: string[]
     ignoredBreadcrumbPatterns: RegExp[]
+    ignoredSpanOps: string[]
   }
 
   shouldDropError?: (error: unknown) => boolean