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.6.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.6-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: runopsy_collector-0.1.6.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.6.tar.gz
Algorithm Hash digest
SHA256 d4e631559b08fdd8070066f24268e3f3ee326d1b9450120c952a14544f65ffd4
MD5 35a0bcdd99e89cde59cf6867f13fa1f5
BLAKE2b-256 41d1e4d7515bcb319aebd26678ba7a65dfc63757fd688ae801a1bfe415fc41dc

See more details on using hashes here.

File details

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

File metadata

  • Download URL: runopsy_collector-0.1.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 9f20d672d819bf28396d2962a86a468453f5923914a77bb37801998c4dc74580
MD5 7a8865cfc7887d9130c464667e126c08
BLAKE2b-256 0747029b60223535e87d14785cc5921d117018cdebe9a69ec0fdd3554254ef99

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