different-ai/openwork · error · ObservabilityConfigError

must be a standard OpenTelemetry sampler

Error message

must be a standard OpenTelemetry sampler

What it means

Error "must be a standard OpenTelemetry sampler" thrown in different-ai/openwork.

Source

Thrown at ee/packages/utils/src/observability.ts:241

  }
}

function parseOtelSamplerName(env: ObservabilityEnv): OTelSampler {
  const sampler = envValue(env, "OTEL_TRACES_SAMPLER")
  if (sampler === undefined) {
    return "parentbased_always_on"
  }

  switch (sampler) {
    case "always_on":
    case "always_off":
    case "traceidratio":
    case "parentbased_always_on":
    case "parentbased_always_off":
    case "parentbased_traceidratio":
      return sampler
    default:
      throw new ObservabilityConfigError(
        "must be a standard OpenTelemetry sampler",
        "OTEL_TRACES_SAMPLER",
      )
  }
}

function isRatioSampler(sampler: OTelSampler): boolean {
  return sampler === "traceidratio" || sampler === "parentbased_traceidratio"
}

function parseOtelSampler(env: ObservabilityEnv): OTelSamplerConfig {
  const name = parseOtelSamplerName(env)
  const rawArgument = envValue(env, "OTEL_TRACES_SAMPLER_ARG")

  if (isRatioSampler(name)) {
    const ratio = rawArgument === undefined ? 1 : parseUnitInterval(rawArgument, "OTEL_TRACES_SAMPLER_ARG")
    return { name, ratio, argument: String(ratio) }
  }

View on GitHub (pinned to 2b7df46e8a)

When it happens

Trigger: Thrown at ee/packages/utils/src/observability.ts:241 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of different-ai/openwork@2b7df46e8a (2026-09-01). Data as JSON: /api/errors/eeb2bcbf1bcaee4e. Report an issue: GitHub.