> ## Documentation Index > Fetch the complete documentation index at: https://docs-omnicoreagent.omnirexfloralabs.com/llms.txt > Use this file to discover all available pages before exploring further. # Telemetry settings > Every key telemetry_config takes, its default, and what it does # Telemetry settings Everything `OmniCoreAgent(telemetry_config={...})` takes: what a trace records, where it is kept, and for how long. Each description is the comment above the setting in the code. | Setting | Type | Default | What it does | | ----------------------------- | --------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `storage` | `str` | `"auto"` | `auto` (like `jsonl`) keeps every trace on local disk, in telemetry/traces.jsonl under the workspace directory (./workspace unless configured), even when the workspace itself is S3 or R2. `memory` keeps them in this process only. No external exporter is required. | | `storage_path` | `str \| None` | `None` | Where the jsonl store writes; None is telemetry/traces.jsonl in the workspace. | | `retention_days` | `int \| None` | `7` | Finished traces older than this are pruned automatically; `None` keeps every trace. | | `payload_retention_days` | `int \| None` | `7` | The same for offloaded payloads, on their own window; a payload a kept trace still refers to is never pruned. | | `memory_max_traces` | `int \| None` | `1000` | Upper bound on finished traces kept by an in-memory store. | | `capture` | `str` | `"full"` | A preset fills every `record_*` field left unset (`None`); a field set explicitly always wins. After construction all are booleans. `full` is the default (the maintainer's decision, 2026-09-22): a trace is worth keeping only if it holds what the model was sent, and a trainer or an evaluator cannot use one that does not. `default` is the privacy-first preset for a deployment that must not record prompts. | | `record_inputs` | `bool \| None` | `None` | What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset's value. | | `record_outputs` | `bool \| None` | `None` | What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset's value. | | `record_model_prompts` | `bool \| None` | `None` | What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset's value. | | `record_model_responses` | `bool \| None` | `None` | What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset's value. | | `record_tool_results` | `bool \| None` | `None` | What a trace keeps of each part of a run: inputs, outputs, what the model was sent and what it answered, and what tools returned. None takes the capture preset's value. | | `record_token_details` | `bool` | `False` | The tokens a model chose and their probabilities, when the provider returns them (`logprobs`). Off: they are large, and only a trainer reusing the run needs them. | | `max_payload_bytes` | `int` | `64_000` | A recorded payload larger than this is replaced by a truncated marker with its size and checksum, unless offload\_large\_payloads keeps it whole. | | `redact_keys` | `list[str]` | see below | Keys whose values are replaced with \[REDACTED] wherever they appear in a recorded payload, at any depth. | | `offload_large_payloads` | `bool` | `False` | Keep payloads over max\_payload\_bytes whole, in the workspace or object storage, referenced from the trace, instead of truncating them. | | `offload_target` | `str` | `"workspace"` | Keep payloads over max\_payload\_bytes whole, in the workspace or object storage, referenced from the trace, instead of truncating them. | | `archive_index_url` | `str \| None` | `None` | Where the archive of finished traces keeps its index and its bodies. Unset is a SQLite file and a directory beside the log, which is what one process needs. A database URL makes the index shared, and `archive_target="object_storage"` puts the bodies in the deployment's bucket, so several server processes can read one archive. | | `archive_target` | `str` | `"local"` | Where the archive of finished traces keeps its index and its bodies. Unset is a SQLite file and a directory beside the log, which is what one process needs. A database URL makes the index shared, and `archive_target="object_storage"` puts the bodies in the deployment's bucket, so several server processes can read one archive. | | `archive_bodies_path` | `str \| None` | `None` | A directory the processes share, for a deployment that shares one host rather than a bucket. Ignored when `archive_target` is object storage. | | `strict` | `bool` | `False` | Raise when a record cannot be made safely (redaction or persistence failed) instead of recording a marker and carrying on. | | `persistence_timeout_seconds` | `float \| None` | `5.0` | Seconds a write to the trace store, or an export to an external exporter, may take before it is given up and reported. | | `export_timeout_seconds` | `float \| None` | `5.0` | Seconds a write to the trace store, or an export to an external exporter, may take before it is given up and reported. | ## Defaults in full ### `redact_keys` Keys whose values are replaced with \[REDACTED] wherever they appear in a recorded payload, at any depth. ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} [ "access_token", "api_key", "apikey", "authorization", "client_secret", "cookie", "password", "refresh_token", "secret", "set-cookie", "token" ] ```