Graphorin API reference v0.1.0
Graphorin API reference / @graphorin/observability / / TracerOptions
Interface: TracerOptions
Defined in: packages/observability/src/tracer/tracer.ts:35
Configuration shape consumed by createTracer.
Stable
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
defaultAttributeSensitivity? | readonly | Sensitivity | Default sensitivity for attributes that omit setAttribute(_, _, { sensitivity }). Defaults to 'internal' per the default-deny non-public posture. | packages/observability/src/tracer/tracer.ts:65 |
exporters | readonly | readonly TraceExporter[] | Configured exporters. Each exporter MUST be wrapped via withValidation(...) before reaching the tracer — pass them through unwrapped to use the tracer-managed validator (set by validation) or pass already-wrapped exporters when you want per-exporter policies. | packages/observability/src/tracer/tracer.ts:45 |
now? | readonly | () => number | Internal Override the wall clock used for span timestamps. Returns milliseconds-since-epoch as a number. Default: Date.now. | packages/observability/src/tracer/tracer.ts:78 |
sampling? | readonly | SamplingOptions | Sampler configuration. | packages/observability/src/tracer/tracer.ts:60 |
serviceName? | readonly | string | Logical service name. Embedded in the OTLP Resource. | packages/observability/src/tracer/tracer.ts:37 |
validation? | readonly | | RedactionValidatorOptions | "off" | Tracer-managed validator policy. - RedactionValidatorOptions (default): the tracer auto-wraps any un-wrapped exporter with withValidation(...) using these options. - 'off': NOT recommended. Skips auto-wrap, and the tracer logs a startup WARN to the supplied warnSink. Pre-wrapped exporters still flow through their validators. Default { minTier: 'public', failOnUnredactedSensitive: false } | packages/observability/src/tracer/tracer.ts:58 |
warnSink? | readonly | (line) => void | Internal Sink used for startup WARNings. Defaults to console.warn. | packages/observability/src/tracer/tracer.ts:71 |