dockerfiles/statsd/README.md

statsd
======

[StatsD][1] is a network daemon that runs on the Node.js platform and listens for
statistics, like counters and timers, sent over UDP or TCP and sends aggregates
to one or more pluggable backend services (e.g., [Graphite][2]).

## docker-compose.yml

```yaml
version: "3.8"

services:
  statsd:
    image: vimagick/statsd
    ports:
      - "8126:8126/tcp"
      - "8125:8125/udp"
    volumes:
      - ./data/config.js:/opt/statsd/config.js
    restart: unless-stopped

networks:
  default:
    external: true
    name: graphite_default
```

## python client

```bash
$ pip install statsd
```

```python
import statsd
c = statsd.StatsClient('localhost', 8125)
c.incr('foo')  # Increment the 'foo' counter.
c.timing('stats.timed', 320)  # Record a 320ms 'stats.timed'.
```

[1]: https://github.com/etsy/statsd
[2]: http://graphite.readthedocs.org/
[3]: http://statsd.readthedocs.io/