.. versionadded:: 19.1
Gunicorn provides an optional instrumentation of the arbiter and
workers using the statsD protocol over UDP. Thanks to the
gunicorn.instrument.statsd
module, Gunicorn becomes a statsD client.
The use of UDP cleanly isolates Gunicorn from the receiving end of the statsD
metrics so that instrumentation does not cause Gunicorn to be held up by a slow
statsD consumer.
To use statsD, just tell gunicorn where the statsD server is:
$ gunicorn --statsd-host=localhost:8125 ...
The Statsd
logger overrides gunicorn.glogging.Logger
to track
all requests. The following metrics are generated:
gunicorn.requests
: request rate per secondgunicorn.request.duration
: histogram of request duration (in millisecond)gunicorn.workers
: number of workers managed by the arbiter (gauge)gunicorn.log.critical
: rate of critical log messagesgunicorn.log.error
: rate of error log messagesgunicorn.log.warning
: rate of warning log messagesgunicorn.log.exception
: rate of exceptional log messages