@atrim/instrument-node 0.4.1 → 0.5.0-14fdea7-20260108232035

package/README.md

@@ -1,42 +1,43 @@
 # @atrim/instrument-node
 
-**One-line OpenTelemetry for Node.js**
+**Configuration layer for OpenTelemetry Node.js**
 
 [![npm version](https://badge.fury.io/js/%40atrim%2Finstrument-node.svg)](https://www.npmjs.com/package/@atrim/instrument-node)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-OpenTelemetry instrumentation for Node.js with centralized YAML configuration. Works with any Node.js framework (Express, Fastify, Koa, Hono) and runtime (Node.js, Bun, Deno).
+Built on [@opentelemetry/auto-instrumentations-node](https://www.npmjs.com/package/@opentelemetry/auto-instrumentations-node), this package adds centralized YAML configuration, pattern-based span filtering, and first-class Effect-TS integration.
 
-## Quick Start
-
-**1. Install**
+## What This Package Adds
 
-```bash
-npm install @atrim/instrument-node
-```
+| Feature | Description |
+|---------|-------------|
+| **Pattern-based span filtering** | Control which spans are created via YAML config (unique to this package) |
+| **Centralized configuration** | Load instrumentation config from file, URL, or environment variable |
+| **Effect-TS integration** | Typed layers, annotation helpers for Effect users |
+| **Smart defaults** | Auto-detects service name, configures graceful shutdown |
 
-**2. Initialize** (at the top of your app)
+**Note:** Auto-instrumentation for Express, HTTP, Fastify, etc. comes from the underlying OpenTelemetry packages. This library configures and extends that functionality.
 
-### Promise API (Traditional)
+## Installation
 
-```typescript
-import { initializeInstrumentation } from '@atrim/instrument-node'
+```bash
+# Required
+npm install @atrim/instrument-node @opentelemetry/api
 
-await initializeInstrumentation()
+# Optional: Effect-TS integration
+npm install effect @effect/opentelemetry @effect/platform @effect/platform-node
 ```
 
-### Effect API (Recommended)
+## Quick Start
 
 ```typescript
-import { Effect } from 'effect'
-import { initializeInstrumentationEffect } from '@atrim/instrument-node'
+import { initializeInstrumentation } from '@atrim/instrument-node'
 
-await Effect.runPromise(initializeInstrumentationEffect())
+await initializeInstrumentation()
+// Done! Traces go to http://localhost:4318
 ```
 
-**3. Done!** Your app is now sending traces to OpenTelemetry.
-
-By default, traces go to `http://localhost:4318`. To send to a remote collector:
+**Remote collector:**
 
 ```typescript
 await initializeInstrumentation({
@@ -44,308 +45,135 @@ await initializeInstrumentation({
 })
 ```
 
-### What just happened?
-
-Auto-detected and configured:
-- ✅ Service name from `package.json`
-- ✅ OTLP endpoint (local or remote)
-- ✅ Auto-instrumentation for Express, HTTP, Fastify, etc.
-- ✅ Graceful shutdown on SIGTERM/SIGINT
-
-## Optional: Control What Gets Traced
-
-Create `instrumentation.yaml` in your project root:
-
-```yaml
-version: "1.0"
-instrumentation:
-  enabled: true
-  instrument_patterns:
-    - pattern: "^app\\."      # ✅ Trace application operations
-  ignore_patterns:
-    - pattern: "^health\\."   # ❌ Skip health checks
-```
-
-That's it!
-
-## Features
-
-- **Zero-config** - Works out of the box with sensible defaults
-- **Universal** - Node.js 20+, Bun 1.0+, Deno 1.40+
-- **Framework-agnostic** - Express, Fastify, Koa, Hono, vanilla HTTP
-- **Effect-TS first** - Typed error handling with Effect (optional)
-- **Pattern-based filtering** - Control which spans are created via YAML
-- **HTTP filtering** - Prevent noisy health checks and metrics endpoints
-- **Centralized config** - YAML file, URL, or environment variable
-- **Production-ready** - Graceful shutdown, error handling, performance optimized
-
-## Documentation
-
-Full documentation is available in the [main repository](https://github.com/atrim-ai/instrumentation):
-
-### Core Docs
-
-- 📖 [Getting Started](../../docs/getting-started.md) - 5-minute setup guide
-- ⚙️ [Configuration](../../docs/configuration.md) - YAML configuration reference
-- 📋 [Examples](../../docs/EXAMPLES.md) - 8+ working examples
-- 🔧 [Troubleshooting](../../docs/TROUBLESHOOTING.md) - Common issues and solutions
-- 📚 [API Reference](../../docs/api-reference.md) - Complete API documentation
-
-### Specialized Guides
-
-- 🌐 [HTTP Filtering](../../docs/HTTP_FILTERING_INVESTIGATION.md) - Prevent noisy traces
-- 🔄 [Effect Integration](../../examples/effect-ts/README.md) - Effect-TS patterns
-- 🧪 [Testing Guide](../../docs/TESTING.md) - How to test instrumented apps
-
-## Installation
-
-### npm
-
-```bash
-npm install @atrim/instrument-node
-```
-
-### yarn
-
-```bash
-yarn add @atrim/instrument-node
-```
-
-### pnpm
-
-```bash
-pnpm add @atrim/instrument-node
-```
-
-### Bun
-
-```bash
-bun add @atrim/instrument-node
-```
-
-## Usage Examples
-
-### Express Application
+**What gets auto-configured:**
 
-```typescript
-import express from 'express'
-import { initializeInstrumentation } from '@atrim/instrument-node'
-
-// Initialize at startup
-await initializeInstrumentation()
-
-const app = express()
-
-app.get('/users', async (req, res) => {
-  // Automatically traced!
-  const users = await fetchUsers()
-  res.json(users)
-})
+- Service name from `package.json`
+- OTLP endpoint
+- Auto-instrumentation (HTTP, Express, Fastify, etc.)
+- Graceful shutdown
 
-app.listen(3000)
-```
-
-### Effect-TS Application
+## Effect-TS Integration
 
 ```typescript
 import { Effect, Layer } from 'effect'
 import { EffectInstrumentationLive } from '@atrim/instrument-node/effect'
 
 const program = Effect.gen(function* () {
-  // Automatically traced with Effect.withSpan()
   yield* myOperation.pipe(Effect.withSpan('app.operation'))
-}).pipe(
-  Effect.provide(EffectInstrumentationLive)
-)
+}).pipe(Effect.provide(EffectInstrumentationLive))
 
 await Effect.runPromise(program)
 ```
 
-### Bun Runtime
+**Span annotation helpers:**
 
 ```typescript
-import { initializeInstrumentation } from '@atrim/instrument-node'
+import { annotateUser, annotateBatch, annotateCache } from '@atrim/instrument-node/effect'
 
-// Works exactly the same as Node.js
-await initializeInstrumentation()
-
-Bun.serve({
-  port: 3000,
-  fetch(req) {
-    return new Response('Hello from Bun!')
-  }
-})
+const process = Effect.gen(function* () {
+  yield* annotateUser('user-123', 'user@example.com')
+  yield* annotateBatch(100, 10)
+  yield* annotateCache(true, 'user:123')
+  // ...
+}).pipe(Effect.withSpan('batch.process'))
 ```
 
-### Remote Configuration
+Available: `annotateUser`, `annotateBatch`, `annotateDataSize`, `annotateLLM`, `annotateQuery`, `annotateHttpRequest`, `annotateError`, `annotatePriority`, `annotateCache`
 
-```typescript
-import { initializeInstrumentation } from '@atrim/instrument-node'
+### Effect Fiber Metadata Extraction
 
-await initializeInstrumentation({
-  configUrl: 'https://config.company.com/instrumentation.yaml',
-  cacheTimeout: 300_000 // 5 minutes
-})
+To add Effect fiber metadata (fiber ID, status, parent span info) to your spans, you must **explicitly call** the enrichment functions:
+
+```typescript
+import { autoEnrichSpan, withAutoEnrichedSpan } from '@atrim/instrument-node/effect'
+
+// Option 1: Call autoEnrichSpan() inside a span
+const operation = Effect.gen(function* () {
+  yield* autoEnrichSpan()  // Adds fiber metadata to current span
+  // ... your logic
+}).pipe(Effect.withSpan('app.operation'))
+
+// Option 2: Use the convenience wrapper
+const operation = withAutoEnrichedSpan('app.operation')(
+  Effect.gen(function* () {
+    // ... your logic (fiber metadata added automatically)
+  })
+)
 ```
 
-## Configuration
+**Extracted metadata:**
+- `effect.fiber.id` - Unique fiber thread name
+- `effect.fiber.status` - Current fiber status
+- `effect.operation.root` / `effect.operation.nested` - Operation hierarchy
+- `effect.parent.span.id`, `effect.parent.span.name`, `effect.parent.trace.id` - Parent span info
 
-### Priority Order (Highest to Lowest)
+> **Note:** The `auto_extract_metadata` config option is currently not implemented. Metadata extraction requires explicit calls as shown above. See [#issue] for tracking automatic extraction support.
 
-1. **Explicit Config Object** - Passed programmatically
-2. **Environment Variable** - `ATRIM_INSTRUMENTATION_CONFIG`
-3. **Project Root File** - `./instrumentation.yaml`
-4. **Default Config** - Built-in defaults
+## Configuration (Optional)
 
-### instrumentation.yaml Example
+Create `instrumentation.yaml` in your project root:
 
 ```yaml
 version: "1.0"
-
 instrumentation:
   enabled: true
-  logging: "on"
-
-  # Pattern-based span filtering
   instrument_patterns:
-    - pattern: "^app\\."
-      enabled: true
-      description: "Application operations"
-    - pattern: "^storage\\."
-      enabled: true
-      description: "Storage layer"
-
+    - pattern: "^app\\."      # Trace app operations
   ignore_patterns:
-    - pattern: "^health\\."
-      description: "Health checks"
-    - pattern: "^metrics\\."
-      description: "Metrics endpoints"
-
-# Effect-TS specific (optional)
-effect:
-  auto_extract_metadata: true
-```
-
-See [Configuration Guide](../../docs/configuration.md) for complete reference.
-
-## HTTP Request Filtering
-
-**IMPORTANT:** HTTP filtering requires explicit configuration to prevent noisy traces.
-
-### Add HTTP Filtering Patterns
-
-```yaml
-# instrumentation.yaml
-instrumentation:
+    - pattern: "^health\\."   # Skip health checks
   http_filtering:
     enabled: true
     ignore_routes:
       - pattern: "^/health$"
       - pattern: "^/metrics$"
-      - pattern: "^/api/internal/"
-      - pattern: "http://.*:4318/v1/traces"  # Prevent OTLP trace loops!
 ```
 
-See [HTTP Filtering Guide](../../docs/HTTP_FILTERING_INVESTIGATION.md) for details.
-
-## API Reference
-
-### Standard API (Promise-based)
+**Priority order:** Explicit config > `ATRIM_INSTRUMENTATION_CONFIG` env var > `./instrumentation.yaml` > defaults
 
-```typescript
-// Main initialization
-initializeInstrumentation(options?: SdkInitializationOptions): Promise<NodeSDK | null>
-
-// Pattern matching only (skip SDK)
-initializePatternMatchingOnly(options?: ConfigLoaderOptions): Promise<void>
+## Runtimes & Frameworks
 
-// Configuration
-loadConfig(options?: ConfigLoaderOptions): Promise<InstrumentationConfig>
+| Runtime | Version |
+|---------|---------|
+| Node.js | 20+ |
+| Bun | 1.0+ |
+| Deno | 1.40+ |
 
-// Service detection
-detectServiceInfo(): Promise<ServiceInfo>
-getServiceName(): Promise<string>
-getServiceVersion(): Promise<string>
-```
+| Framework | Support |
+|-----------|---------|
+| Express | Auto-instrumented (via OTel) |
+| Fastify | Auto-instrumented (via OTel) |
+| Koa | Auto-instrumented (via OTel) |
+| Hono | Manual spans |
+| Effect-TS | First-class integration (unique) |
 
-### Effect API
+## Version Compatibility
 
-```typescript
-// Main initialization (Effect)
-initializeInstrumentationEffect(options?: SdkInitializationOptions): Effect.Effect<NodeSDK | null, InitializationError | ConfigError>
-
-// Effect-TS Layer
-EffectInstrumentationLive: Layer.Layer<Tracer.Tracer, ConfigError, never>
-
-// Service detection (Effect)
-detectServiceInfoEffect: Effect.Effect<ServiceInfo, ServiceDetectionError>
-getServiceNameEffect: Effect.Effect<string, ServiceDetectionError>
-getServiceVersionEffect: Effect.Effect<string, never>
-```
+| @atrim/instrument-node | @opentelemetry/api | effect |
+|------------------------|--------------------| -------|
+| 0.6.x                  | ^1.0.0 (1.0 - 1.9+) | ^3.0.0 (optional) |
 
-See [API Reference](../../docs/api-reference.md) for complete documentation.
+**Notes:**
 
-## Runtimes Supported
-
-- ✅ **Node.js** 20.0.0+
-- ✅ **Bun** 1.0.0+
-- ✅ **Deno** 1.40.0+ (via npm compatibility)
-
-## Frameworks Supported
-
-- ✅ **Express** - Auto-instrumentation included
-- ✅ **Fastify** - Auto-instrumentation included
-- ✅ **Koa** - Auto-instrumentation included
-- ✅ **Hono** - Works with manual spans
-- ✅ **Vanilla HTTP** - Works with any Node.js HTTP server
-- ✅ **Effect-TS** - First-class integration with Effect.withSpan()
-
-## Examples
-
-See the [examples directory](../../examples/) for complete working examples:
-
-- [Express](../../examples/express/) - Basic Express app
-- [Effect-TS](../../examples/effect-ts/) - Advanced Effect patterns
-- [Effect Platform](../../examples/effect-platform/) - Pure Effect HTTP server
-- [Vanilla TypeScript](../../examples/vanilla/) - Standard Node.js
-- [Bun Runtime](../../examples/bun/) - Bun-specific example
-- [Remote Config](../../examples/remote-config/) - Load config from URL
-- [Multi-Service](../../examples/multi-service/) - Distributed tracing
+- `@opentelemetry/api` is the only required peer dependency
+- Effect packages are optional - core features work without them
+- The library is tested with @opentelemetry/api 1.9.x in CI
 
 ## Troubleshooting
 
-See [Troubleshooting Guide](../../docs/TROUBLESHOOTING.md) for common issues and solutions.
-
-### Quick Fixes
+**No traces?** Check collector: `docker run -p 4318:4318 otel/opentelemetry-collector`
 
-**No traces appearing?**
-- Check collector is running: `docker run -p 4318:4318 otel/opentelemetry-collector`
-- Check endpoint: `OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318`
+**Too many traces?** Add HTTP filtering patterns for health checks, metrics, OTLP exports.
 
-**Too many traces?**
-- Add HTTP filtering patterns (health checks, metrics, OTLP exports)
-- See [HTTP Filtering Guide](../../docs/HTTP_FILTERING_INVESTIGATION.md)
+**Effect spans missing?** Ensure you're using `Effect.withSpan()` and providing `EffectInstrumentationLive`.
 
-**Effect-TS spans not appearing?**
-- Make sure you're using `Effect.withSpan()`
-- Provide `EffectInstrumentationLive` layer
-
-## Contributing
+## Documentation
 
-Contributions welcome! See [main repository](https://github.com/atrim-ai/instrumentation) for guidelines.
+- [Getting Started](../../docs/getting-started.md)
+- [Configuration Reference](../../docs/configuration.md)
+- [API Reference](../../docs/api-reference.md)
+- [Examples](../../examples/)
+- [Troubleshooting](../../docs/TROUBLESHOOTING.md)
 
 ## License
 
-MIT © Atrim AI
-
-## Related Packages
-
-- [@atrim/instrument-core](../core) - Internal shared logic (private)
-- @atrim/instrument-web - Browser/web support _(Phase 1)_
-
-## Links
-
-- 📦 [npm package](https://www.npmjs.com/package/@atrim/instrument-node)
-- 🐙 [GitHub repository](https://github.com/atrim-ai/instrumentation)
-- 🐛 [Issue tracker](https://github.com/atrim-ai/instrumentation/issues)
-- 📖 [Documentation](https://github.com/atrim-ai/instrumentation#readme)
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atrim/instrument-node",
-  "version": "0.4.1",
+  "version": "0.5.0-14fdea7-20260108232035",
   "description": "OpenTelemetry instrumentation for Node.js with centralized YAML configuration",
   "type": "module",
   "license": "MIT",
@@ -43,6 +43,11 @@
       "types": "./target/dist/integrations/effect/index.d.ts",
       "import": "./target/dist/integrations/effect/index.js",
       "require": "./target/dist/integrations/effect/index.cjs"
+    },
+    "./effect/auto": {
+      "types": "./target/dist/integrations/effect/auto/index.d.ts",
+      "import": "./target/dist/integrations/effect/auto/index.js",
+      "require": "./target/dist/integrations/effect/auto/index.cjs"
     }
   },
   "main": "./target/dist/index.js",
@@ -54,50 +59,48 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@effect/opentelemetry": "^0.59.0",
-    "@effect/platform": "^0.93.0",
-    "@effect/platform-node": "latest",
-    "@opentelemetry/auto-instrumentations-node": "^0.67.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.67.3",
     "@opentelemetry/exporter-trace-otlp-http": "^0.208.0",
     "@opentelemetry/instrumentation": "^0.208.0",
+    "@opentelemetry/resources": "^2.2.0",
     "@opentelemetry/sdk-node": "^0.208.0",
     "@opentelemetry/sdk-trace-base": "^2.2.0",
-    "effect": "^3.19.0",
+    "@opentelemetry/sdk-trace-node": "^2.2.0",
+    "@opentelemetry/semantic-conventions": "^1.38.0",
     "yaml": "^2.3.0",
     "zod": "^3.22.0"
   },
   "devDependencies": {
+    "@effect/opentelemetry": "^0.60.0",
+    "@effect/platform": "^0.94.1",
+    "@effect/platform-node": "^0.104.0",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/resources": "^2.2.0",
     "@opentelemetry/sdk-logs": "^0.208.0",
     "@opentelemetry/sdk-metrics": "^2.2.0",
     "@opentelemetry/sdk-trace-node": "^2.2.0",
     "@opentelemetry/sdk-trace-web": "^2.2.0",
     "@opentelemetry/semantic-conventions": "^1.38.0",
-    "@types/node": "^20.10.0",
-    "@vitest/coverage-v8": "^4.0.8",
-    "effect": "^3.19.0",
-    "testcontainers": "^11.8.1",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "effect": "^3.19.14",
+    "testcontainers": "^11.11.0",
     "tsup": "^8.0.1",
     "tsx": "^4.7.0",
     "typescript": "^5.7.2",
-    "vitest": "^4.0.8",
-    "@atrim/instrument-core": "0.4.1"
+    "vitest": "^4.0.16",
+    "@atrim/instrument-core": "0.6.0"
   },
   "peerDependencies": {
+    "@opentelemetry/api": "^1.0.0",
+    "effect": "^3.0.0",
     "@effect/opentelemetry": ">=0.40.0",
     "@effect/platform": ">=0.70.0",
-    "@opentelemetry/api": "^1.0.0",
-    "@opentelemetry/sdk-trace-base": "^1.0.0",
-    "effect": "^3.0.0"
+    "@effect/platform-node": ">=0.60.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {
       "optional": false
     },
-    "@opentelemetry/sdk-trace-base": {
-      "optional": true
-    },
     "effect": {
       "optional": true
     },
@@ -106,6 +109,9 @@
     },
     "@effect/platform": {
       "optional": true
+    },
+    "@effect/platform-node": {
+      "optional": true
     }
   },
   "scripts": {
@@ -122,10 +128,10 @@
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
     "clean": "rm -rf target",
-    "publish:dev:version": "npm version $(git describe --tags --abbrev=0 | sed 's/^.*@//' | sed 's/^v//')-$(git rev-parse --short HEAD)-$(date -u +%Y%m%d%H%M%S) --no-git-tag-version",
+    "publish:dev:version": "pnpm version $(node -p \"require('./package.json').version\")-$(git rev-parse --short HEAD)-$(date -u +%Y%m%d%H%M%S) --no-git-tag-version",
     "publish:dev:save": "node -p \"require('./package.json').version\" > .version",
     "publish:dev:publish": "pnpm build && pnpm publish --tag dev --access public --no-git-checks",
-    "publish:dev:reset": "npm version 1.0.0 --no-git-tag-version",
+    "publish:dev:reset": "pnpm version 0.5.0 --no-git-tag-version",
     "publish:dev": "pnpm publish:dev:version && pnpm publish:dev:save && pnpm publish:dev:publish && pnpm publish:dev:reset"
   }
 }

package/target/dist/index.d.cts

@@ -46,35 +46,33 @@ declare function createOtlpExporter(options?: OtlpExporterOptions): OTLPTraceExp
 declare function getOtlpEndpoint(options?: OtlpExporterOptions): string;
 
 /**
- * Node.js configuration loader using Effect Platform
+ * Node.js configuration loader
  *
- * Provides FileSystem and HttpClient layers for the core ConfigLoader service
+ * Provides configuration loading using native Node.js APIs (fs, fetch)
+ * This module doesn't require Effect Platform, making it work without Effect installed.
  */
 
 /**
- * Reset the cached loader (for testing purposes)
- * @internal
- */
-declare function _resetConfigLoaderCache(): void;
-/**
- * Load configuration from URI (Promise-based convenience API)
- *
- * Automatically provides Node.js platform layers (FileSystem + HttpClient)
+ * Load configuration from URI (file path or URL)
  *
  * @param uri - Configuration URI (file://, http://, https://, or relative path)
- * @param options - Optional loading options (e.g., to disable caching)
  * @returns Promise that resolves to validated configuration
  */
-declare function loadConfig(uri: string, options?: {
+declare function loadConfig(uri: string, _options?: {
     cacheTimeout?: number;
 }): Promise<InstrumentationConfig>;
 /**
- * Load configuration from inline content (Promise-based convenience API)
+ * Load configuration from inline content
  *
  * @param content - YAML string, JSON string, or plain object
  * @returns Promise that resolves to validated configuration
  */
 declare function loadConfigFromInline(content: string | unknown): Promise<InstrumentationConfig>;
+/**
+ * Reset the config loader cache (no-op for native implementation)
+ * @internal
+ */
+declare function _resetConfigLoaderCache(): void;
 /**
  * Legacy options interface for backward compatibility
  */
@@ -548,6 +546,10 @@ declare function getServiceVersionAsync(): Promise<string | undefined>;
  * This processor filters spans based on configured patterns before they are exported.
  * It wraps another processor (typically BatchSpanProcessor) and only forwards spans
  * that match the instrumentation patterns.
+ *
+ * Filtering is applied at two levels:
+ * 1. Span name patterns (instrument_patterns / ignore_patterns)
+ * 2. HTTP path patterns (http.ignore_incoming_paths) - for HTTP spans
  */
 
 /**
@@ -570,6 +572,7 @@ declare function getServiceVersionAsync(): Promise<string | undefined>;
 declare class PatternSpanProcessor implements SpanProcessor {
     private matcher;
     private wrappedProcessor;
+    private httpIgnorePatterns;
     constructor(config: InstrumentationConfig, wrappedProcessor: SpanProcessor);
     /**
      * Called when a span is started
@@ -582,8 +585,20 @@ declare class PatternSpanProcessor implements SpanProcessor {
      * Called when a span is ended
      *
      * This is where we make the final decision on whether to export the span.
+     * We check both span name patterns and HTTP path patterns.
      */
     onEnd(span: ReadableSpan): void;
+    /**
+     * Check if span should be ignored based on HTTP path attributes
+     *
+     * This checks the span's url.path, http.route, or http.target attributes
+     * against the configured http.ignore_incoming_paths patterns.
+     *
+     * This enables filtering of Effect HTTP spans (and any other HTTP spans)
+     * based on path patterns, which is essential for filtering out OTLP
+     * endpoint requests like /v1/traces, /v1/logs, /v1/metrics.
+     */
+    private shouldIgnoreHttpSpan;
     /**
      * Shutdown the processor
      */