Need help with inquest?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

yiblet
130 Stars 4 Forks GNU Lesser General Public License v3.0 231 Commits 6 Opened issues

Description

Inquest lets you add log statements to python without restarting your python instance. It helps you quickly uncover what is going wrong.

Services available

!
?

Need anything else?

Contributors list

# 490,258
load-te...
JavaScr...
python3
develop...
220 commits
# 23,704
SQL
html5
angular...
sysops
1 commit

What's Inquest?

Inquest is a logging tool for python programs. It let's you add logs to your running python programs without restarting the program, redeploying the program, or modifying the code in any way. Inquest takes extremely low overhead: the part that's a python library is completely idle unless there is something to log. Inquest is specifically designed to enable you to quickly introspect into Python even in production environments.

Here's a gif of the magic. I'm running a single python instance in the background and I use Inquest to dynamically add log statements to the running code.

Installation

There are two ways to use Inquest:

  1. A simple docker-compose
  2. The Inquest Cloud

Resources

Frequently Asked Questions

How does Inquest work?

Inquest works by bytecode injection. The library sets up a connection with the backend. When you add a new log statment on the dashboard, the backend relays that change the connected python instance. Inside python, inquest finds the affected functions inside the VM.

Then it uses the python interpreter to recompile a newly generated piece of python bytecode with the new log statements inserted. Then inquest pointer-swaps the new bytecode with the old bytecode.

This has 4 benefits:

  1. your underlying code object is never modified
  2. reverting a log statement is always possible and will always result in code behavior identical to the original
  3. it generates extremely efficient python
  4. it has not overhead

Why can't I edit the code in the dashboard?

The dashboard right now cannot persist changes to the files. So modifications to the file on the dashboard wouldn't have been reflected on the underlying file. This opens up an avenue for gotchas where you unintetionally change the IDE but never see those changes in your VCS. In order to avoid that, we made things, simple. The code viewer is read-only.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.