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

Uploaded Python 3

File details

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

File metadata

  • Download URL: runopsy_collector-0.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 4fe74e04ff067ceff76d64c449d9dfbae4801e9d9d5009106b6b66b0d4fde507
MD5 b987579d81582bb94f8b657ccc5cd9d9
BLAKE2b-256 61801b75424f2f68e2e2f9ab9261099478cb351381fd243dd82e8ae126ecfe6c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: runopsy_collector-0.1.5-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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 4b73a1b8008972301513542288f90c80d66ec38cfe75da6ca49b797162b280a5
MD5 ee31fd08c495ec317a672197b68aa751
BLAKE2b-256 277008a1a4ebfb647271b77af269b7ebd9a6c2b13e241016461188bf27359ab1

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