Configuration - Visceral

The SDK is configured entirely through the environment (or the corresponding wrap() arguments). Explicit arguments win over environment variables, which win over defaults.

Connection

Variable	Default	Purpose
`VISCERAL_API_KEY`	—	Workspace API key (`vsc_live_...`). Without it, `wrap()` returns the client uninstrumented.
`VISCERAL_BASE_URL`	`https://api.visceralai.dev`	Backend base URL.

Export tuning

Telemetry is batched and exported in the background; these bound how long Visceral will ever wait on the network.

Variable	Default	Purpose
`VISCERAL_EXPORT_TIMEOUT`	`5`	Export timeout, seconds. Also bounds the flush at process exit.
`VISCERAL_EXPORT_INTERVAL`	`5`	How often the batch exporter ships spans, seconds.

Behavior switches

Variable	Default	Purpose
`VISCERAL_HEURISTIC_STRIP`	`1` (on)	Third-tier heuristic content stripping — removes attributes whose names look like content (`.text`, `.body`, `.query`, …) on top of the exact-match redaction vocabulary. Leave on unless a preserved metadata field is being over-stripped.
`VISCERAL_STREAM_USAGE`	`1` (on)	On OpenAI streaming calls, asks the API to include token usage and strips that extra bookkeeping chunk before your code sees the stream. Output is unchanged; without it, streamed calls report no token counts.
`VISCERAL_APPLY_RULES_TTL_SECONDS`	`60`	How often the SDK refreshes optimization rules when `apply=True`.
`VISCERAL_TOOL_APPLY`	`1` (on)	Turns off just `@tool` reuse while leaving cache-layout rewrites active. Only relevant under `apply=True`.
`VISCERAL_TOOL_SUPPRESS`	unset (off)	Master dial for serving `suppress_dead` tool rules: calls whose result the backend proved no consuming call actually reads. Must be set to an explicit truthy value (`1`, `true`, `yes`, `on`) to arm; anything else keeps it off while identity reuse continues unaffected. Only relevant under `apply=True`, and only for tools attested `readonly=True, replay_safe=True`.
`VISCERAL_TOOL_SUPPRESS_TOOLS`	unset (all tools)	Comma-separated tool names narrowing `VISCERAL_TOOL_SUPPRESS` to just those tools. Unset or empty means every attested tool once the master dial is on.
`VISCERAL_TOOL_SERVE_TIMEOUT_SECONDS`	`0.15`	Bounds each `@tool` serve fetch. On timeout the real tool runs.
`VISCERAL_ALLOW_PROXY_AND_SDK`	unset	The SDK skips instrumenting a client that is already routed through a Visceral capture proxy, to avoid double-counting. Set to `1` to force both.

Redaction itself has no off switch. The exact-match content vocabulary is always stripped before export — VISCERAL_HEURISTIC_STRIP only controls the extra pattern-based backstop on top of it. See Privacy & data.