Skip to main content
Opik Documentation

Search documentation

Type to search this documentation.

On this pageOverview

Changelog 2026 09 21

  • opik import can import traces of any age again — The trace importer derived each imported trace's ID from the exported trace's start_time, which bakes that original timestamp into the ID's UUIDv7 prefix. Opik validates that an ingested ID's embedded timestamp falls inside an ingestion window around now — 24 hours by default on Opik Cloud, which is what keeps its storage layer partitioned correctly — so importing anything older failed with Invalid UUID for id ... reason 'too_old'. Imported traces now get IDs minted at import time, which also keeps IDs unique across projects and workspaces. start_time and end_time still carry the original values, spans and feedback scores are remapped onto the new IDs, and each trace records the ID it came from in its metadata as _import_id. Traces are imported in the order the source project listed them, so the destination trace list and thread view keep that order; note that the time-bucketed project metrics key off the ID, so imported traces count at import time. If you hit the error above, upgrade the SDK. See Imported trace and span IDs.
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu