debug – Debugging tools for Eventlet
The debug module contains utilities and functions for better
debugging Eventlet-powered applications.
-
eventlet.debug.spew(trace_names=None, show_values=False)
- Install a trace hook which writes incredibly detailed logs
about what code is being executed to stdout.
-
eventlet.debug.unspew()
- Remove the trace hook installed by spew.
-
eventlet.debug.format_hub_listeners()
- Returns a formatted string of the current listeners on the current
hub. This can be useful in determining what’s going on in the event system,
especially when used in conjunction with hub_listener_stacks().
-
eventlet.debug.format_hub_timers()
- Returns a formatted string of the current timers on the current
hub. This can be useful in determining what’s going on in the event system,
especially when used in conjunction with hub_timer_stacks().
-
eventlet.debug.hub_listener_stacks(state=False)
- Toggles whether or not the hub records the stack when clients register
listeners on file descriptors. This can be useful when trying to figure
out what the hub is up to at any given moment. To inspect the stacks
of the current listeners, call format_hub_listeners() at critical
junctures in the application logic.
-
eventlet.debug.hub_exceptions(state=True)
- Toggles whether the hub prints exceptions that are raised from its
timers. This can be useful to see how greenthreads are terminating.
-
eventlet.debug.tpool_exceptions(state=False)
- Toggles whether tpool itself prints exceptions that are raised from
functions that are executed in it, in addition to raising them like
it normally does.
-
eventlet.debug.hub_timer_stacks(state=False)
- Toggles whether or not the hub records the stack when timers are set.
To inspect the stacks of the current timers, call format_hub_timers()
at critical junctures in the application logic.