An asyncio-based client for sending metrics to StatsD with support of DogStatsD extension
Project description
aiodogstatsd
An asyncio-based client for sending metrics to StatsD with support of DogStatsD extension.
Library fully tested with statsd_exporter and supports gauge
, counter
, histogram
, distribution
and timing
types.
Installation
$ pip install aiodogstatsd
Usage
You can simply initialize client to send any metric you want:
import asyncio
import aiodogstatsd
async def main():
client = aiodogstatsd.Client()
await client.connect()
client.increment("users.online")
await client.close()
asyncio.run(main())
...or you can also use client as a context manager:
import asyncio
import aiodogstatsd
async def main():
async with aiodogstatsd.Client() as client:
client.increment("users.online")
asyncio.run(main())
Look at examples/
to find more examples of library usage.
Contributing
To work on the aiodogstatsd
codebase, you'll want to clone the project locally and install the required dependencies via poetry:
$ git clone git@github.com:Gr1N/aiodogstatsd.git
$ make install
To run tests and linters use command below:
$ make lint && make test
If you want to run only tests or linters you can explicitly specify which test environment you want to run, e.g.:
$ make lint-black
License
aiodogstatsd
is licensed under the MIT license. See the license file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aiodogstatsd-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6371bc6aca16abcc03ac92096ce701b1ca7f5f957017b15ab4170bccf1b18b00 |
|
MD5 | d88c6c762559b110726794780f3bcf66 |
|
BLAKE2b-256 | 5e9ed6c44f830033059657e66ca51dcfb547837490dff8d95fd98c3031f33a53 |