pidprobe

Structured JSON snapshots of running CPython 3.14+ processes via PEP 768 - no agent, no restart, no gdb

Installation

pipuv

pip install pidprobe

uv add pidprobe

Quick Example

pidprobe snap 12345 | jq '.stacks.threads[0].frames[0]'

from pidprobe import take_snapshot

snapshot = take_snapshot(12345)
print(snapshot["meta"]["stop_duration_ms"])

Next Steps

• Getting Started — setup and first steps
• Demo — a deliberately broken FastAPI app in Docker to try it on
• API Reference — the commands, their options and the Python API
• Output Schema — every field of the JSON pidprobe prints
• Collector Plugins — add your own snapshot section
• Troubleshooting — one section per pidprobe doctor check
• Contributing — how to contribute