Skip to main content

Append-only local ingest and queryable storage for Runopsy traces

Project description

runopsy-collector

Local, append-only ingest for normalized trace events.

Storage has two layers and they are not equal partners. The JSONL journal is the source of truth: one append-only file per run, written with sorted keys so the same run always serializes to the same bytes. DuckDB is a derived index built from those journals to make runs queryable, and it can be thrown away and rebuilt at any time with Collector.rebuild().

That asymmetry is deliberate. An agent run fails at unpredictable moments, often taking the process with it, and a half-written database is a far more likely outcome than a half-written append. Keeping the plain log authoritative means a crashed run is still diagnosable, a corrupted index is a one-command repair rather than lost history, and a user can read their own trace with nothing but a text editor.

Ingest is idempotent on event_id, so an adapter that retries a write cannot duplicate a step and inflate a loop detector's count.

Nothing here reaches the network. Content is referenced by hash, and the contains_secret flag travels with each event so export and payload minimization can consult it before anything leaves the machine.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

runopsy_collector-0.1.7.tar.gz (23.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

runopsy_collector-0.1.7-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

Details for the file runopsy_collector-0.1.7.tar.gz.

File metadata

  • Download URL: runopsy_collector-0.1.7.tar.gz
  • Upload date:
  • Size: 23.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for runopsy_collector-0.1.7.tar.gz
Algorithm Hash digest
SHA256 97c64d8a0b80f42526505ca0bc760df495db9c858d9bb17d11974158e1f76cf0
MD5 de77e1ed7fe349b72334283e2708aa2d
BLAKE2b-256 7cb6b836dc931f9eb17cf1cc3b07c78483c0641db9d5b1398e771db95c591997

See more details on using hashes here.

File details

Details for the file runopsy_collector-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: runopsy_collector-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 29.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for runopsy_collector-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 b6f92eb27b20434491520752757c8146964cc84408d58642f0ba486bb63e6ca4
MD5 fa4baf48a8a1cd089d91831ca788a6f0
BLAKE2b-256 339301dfe5b908cc4cba9a00275a5e1ba9ff4e8fb1f31284645ad31ea26782f7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page