aiodogstatsd

What it is and what it does

aiodogstatsd is an async Python client for sending application metrics to StatsD-compatible servers. It wraps the StatsD protocol in an asyncio-friendly interface, letting you emit gauges, counters, histograms, distributions, and timing metrics without blocking your event loop. The library defaults to port 9125 (matching statsd_exporter) rather than the standard StatsD port 8125, so you'll need to configure the port if you're targeting a different backend.

The package has no runtime dependencies and is designed to integrate into async web frameworks. It uses a context-manager pattern for clean resource management. With no known vulnerabilities and permissive MIT licensing, the main consideration is its dormant maintenance status: the last release was in late 2021, and there have been no commits since mid-2024, so it will not receive updates for new Python versions or async runtime changes.

Use it for:

• Emit application metrics from an async web service to a Prometheus statsd_exporter without blocking the event loop.
• Track custom business metrics in real time from an asyncio application.
• Monitor async task performance by recording timing and distribution metrics to a centralized StatsD server.
• Integrate metrics collection into async middleware for automatic instrumentation.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

An asyncio-based client for sending metrics to StatsD and DogStatsD, supporting gauge, counter, histogram, distribution, and timing metric types.

Yes, if you need async StatsD metrics in a Python application and can accept dormant maintenance. The library is stable, has no dependencies, and carries no known vulnerabilities. However, if you require active maintenance or support beyond Python 3.10, consider alternatives or plan to maintain it yourself.

Install

aiodogstatsd on PyPI

pip install aiodogstatsd

uv add aiodogstatsd

poetry add aiodogstatsd

Installing aiodogstatsd

Before you install

Low friction: pure Python wheel with no runtime dependencies. Dormant maintenance status—last release was 2021-12-12 and no commits since 2024-07-31—means bug fixes or feature updates are unlikely, though the codebase is stable and the repository is not archived.

License in practice

MIT license (permissive) imposes no significant restrictions; you may use, modify, and distribute the package freely in commercial or private projects.

Quickstart

import asyncio
import aiodogstatsd

async def main():
    async with aiodogstatsd.Client() as client:
        client.increment("users.online")

asyncio.run(main())

Requires Python >=3.7,<4.0; a running StatsD or statsd_exporter server listening on the configured host and port (default 9125).

Verify before relying

• Whether dormant status affects compatibility with recent asyncio or Python runtime changes beyond the declared support range.
• Real-world performance or reliability reports when used with modern StatsD or Prometheus exporters.
• Compatibility with Python versions beyond 3.10 despite the requires_python constraint.

Package facts

Evidence: aiodogstatsd-0.16.0.post0-py3-none-any.whl

Keywords: asyncio, statsd, statsd-client, statsd-metrics, dogstatsd

Tags

More Python Modules packages