rollout
Sign up free

CLI

CLI — imports

Bring historical observability data into Rollout. The import commands preview a source, transform it into Rollout events on disk, let you inspect and validate the result, and send it through the ingest path — with checkpointing so a large import can resume.

Note

The Raindrop importer reads from a Raindrop query key. Imports land in a local workspace under .rollout/imports/<run> before they are sent, so you can review everything first.

Preview

See what an import would pull without writing anything:

shell
rollout import raindrop preview \  --raindrop-query-key rdq_... \  --since 2026-05-01 \  --limit 10

Dry run & send

Transform the source into a local import workspace without sending (--dry-run), then run for real, choosing which record types to include:

shell
# transform only, nothing sentrollout import raindrop run \  --raindrop-query-key rdq_... \  --since 2026-05-01 \  --dry-run# run and send to Rolloutrollout import raindrop run \  --raindrop-query-key rdq_... \  --since 2026-05-01 \  --include users,conversations,traces,events,signals

Inspect & validate

Inspect a local import workspace and validate a transformed events file before sending:

shell
rollout import report .rollout/imports/<run>rollout import validate .rollout/imports/<run>/transformed/events.jsonl

Resume & send

Resume a partially-sent import from its checkpoint, or send a transformed JSONL file manually:

shell
rollout import resume .rollout/imports/<run>rollout import send .rollout/imports/<run>/transformed/events.jsonl --provider raindrop