SDKs

SDK configuration

Configure delivery, bounds, durability, fetch enrichment, health samples, and diagnostics.

configureSightglass() accepts these options:

OptionPurpose
serviceRequired service name attached to telemetry.
endpointSightglass server origin.
environmentDeployment environment label.
apiKeyBearer credential for ingestion.
batchSizeMaximum records sent per batch.
flushIntervalMsMaximum ordinary batching delay.
maxQueueSizeIn-memory occurrence queue bound.
requestTimeoutMsDelivery request deadline.
retryBaseMs and retryMaxMsExponential retry bounds.
meterSpoolDirectoryDurable meter spool path, or false to opt out.
metersDeclared meter units.
fetchInstrumentationNative fetch attribution inside active operations.
healthIntervalMsProcess and host health sampling interval.
onTelemetryErrorIsolated diagnostic callback for delivery failures.

Context and event attributes accept at most 32 entries. Keys are limited to 64 characters, strings to 512 characters, and event or step names to 128 characters. Request bodies, headers, cookies, SQL, bind values, and query results are never captured automatically.