Skip to main content

A statsd server that publishes to cloudwatch

Project description

This is a simple service that runs in the foreground and publishes metrics received via the statsd protocol on udp port 8125 to CloudWatch. It’s expecting to run on EC2 with an IAM Instance Profile defined.


You can install this with pip:

pip install statsd-cloudwatch

It will install a binary called statsd_cloudwatch. This will run in the foreground and listen on port 8125. To run it as a service you can use systemd or upstart.

The following snippets assuming you have created a user called statsd.

For upstart, add /etc/init/statsd.conf:

start on runlevel [2345]
stop on runlevel [!2345]
setuid statsd
setgid statsd
kill timeout 900
exec /app/bin/statsd_cloudwatch


It is assumed that you will run this service on EC2 instances and that they will receive their credentials via the Amazon metadata service. You will need the following IAM policy:

    "Statement": [{
        "Action": ["cloudwatch:PutMetricData"],
        "Effect": "Allow",
        "Resource": "*"

Project details

Release history Release notifications

This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (8.3 kB) Copy SHA256 hash SHA256 Source None Jul 16, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page