---
id: aiodebug
version: "2.3.0"
license: Apache 2.0
license_treatment: permissive
maintenance: abandoned
---

# aiodebug — A tiny library for monitoring and testing asyncio programs

License: permissive · Maintenance: abandoned · Downloads: 270.6K/mo

## What it is and what it does

aiodebug is a small library for observing and testing asyncio event loops. It provides four main tools: log_slow_callbacks warns when tasks block the event loop beyond a threshold, monitor_loop_lag tracks scheduling delays and sends them to StatsD, hang_inspection dumps stack traces when the event loop stalls, and TimeDilatedLoop speeds up or slows down time for testing. The library is designed to run in production with minimal overhead, though it can also be used for development and testing.

The package depends only on typing-extensions and optionally uses logwood for structured logging if available, falling back to Python's standard logging. It supports Python 3.8, 3.9, and 3.10 but has not been maintained since 2022-01-04, meaning it may not work correctly with newer Python releases or asyncio behavior changes.

Use it for:

- Detect and log when asyncio tasks block the event loop beyond a threshold in production.
- Track event loop scheduling lag and send metrics to StatsD for monitoring system responsiveness.
- Diagnose which thread is blocking the event loop by dumping stack traces when hangs occur.
- Speed up or slow down time in event loops during unit tests to verify timeout and delay behavior.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

aiodebug provides monitoring and testing utilities for asyncio programs, including event loop lag tracking, slow callback detection, hang inspection, and time manipulation for tests.

No. While the library is lightweight and addresses real asyncio debugging needs, it is abandoned (last release 2022-01-04) with no active maintenance. Given the rapid evolution of Python and asyncio since then, compatibility with current Python versions is uncertain. Use only if you are already running an older codebase that depends on it; for new projects, seek actively maintained alternatives.

## Install

pip install aiodebug
uv add aiodebug
poetry add aiodebug

## Installing aiodebug

Before you install: Low install friction with a single lightweight dependency (typing-extensions). However, the package is abandoned—last release was 2022-01-04, over 1683 days ago. No active maintenance or security updates.

License in practice: Licensed under Apache 2.0 (permissive), which allows commercial and private use with minimal restrictions. No licensing concerns for adoption.

Quickstart:

pip install aiodebug

import aiodebug.log_slow_callbacks
aiodebug.log_slow_callbacks.enable(0.05)

Requires Python 3.8 or higher; no support for older versions.

Verify before relying:

- Whether the package works reliably with current Python 3.10+ asyncio implementations given the 1683-day gap since last release.
- Whether hang_inspection's stack trace dumping works correctly on modern Python and threading implementations.
- Compatibility with modern async frameworks that may have evolved since 2022-01-04.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 270.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

asyncio debugging and monitoring, event loop performance monitoring, detect slow asyncio callbacks, asyncio testing utilities, event loop hang detection, asyncio profiling tools, asyncio-debugging, event-loop-monitoring, abandoned

[View on SkillFed](https://skillfed.io/packages/aiodebug) · [View on PyPI](https://pypi.org/project/aiodebug/)