Class TelemetryError

constructor

• new TelemetryError(options: TelemetryErrorOptions): TelemetryError

  Creates a new TelemetryError instance.

  Parameters

  • options: TelemetryErrorOptions

    Telemetry error construction options including optional exporter type and package name for diagnostic context.

  Returns TelemetryError

  Example

  import { TelemetryError } from '#core/errors/telemetry-error.js';
  
  const error = new TelemetryError({
    message: 'Peer dependency missing: @opentelemetry/sdk-node',
    attempted: 'Dynamic import of @opentelemetry/sdk-node',
    code: 'ERR_TELEMETRY_PEER_DEP_MISSING',
    packageName: '@opentelemetry/sdk-node',
  });
  Copy

ReadonlyexporterType

ReadonlypackageName

toAIContext

• toAIContext(): AIErrorContext & {
      exporterType: string
      | undefined;
      packageName: string | undefined;
  }

  Returns AI-agent-friendly context with telemetry-specific diagnostic fields.

  Returns AIErrorContext & {
      exporterType: string | undefined;
      packageName: string | undefined;
  }

  Base AI context extended with exporter type and package name details.

  Example

  const ctx = error.toAIContext();
  // LLM can use ctx.packageName to suggest install commands
  // and ctx.exporterType to suggest alternative exporters
  Copy

toJSON

• toJSON(): SerializedPramanError & {
      exporterType: string
      | undefined;
      packageName: string | undefined;
  }

  Serializes this error to a JSON-safe object with telemetry-specific fields.

  Returns SerializedPramanError & {
      exporterType: string | undefined;
      packageName: string | undefined;
  }

  Base serialization extended with exporterType and packageName.

  Example

  const json = error.toJSON();
  console.log(json.exporterType); // 'otlp'
  console.log(json.packageName);  // '@opentelemetry/sdk-node'
  Copy