https://github.com/jc2k/statsd-cloudwatch

Funnel your statsd metrics into CloudWatch
https://github.com/jc2k/statsd-cloudwatch

Last synced: about 1 month ago
JSON representation

Funnel your statsd metrics into CloudWatch

• Host: GitHub
• URL: https://github.com/jc2k/statsd-cloudwatch
• Owner: Jc2k
• Created: 2015-02-18T17:43:15.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2015-07-16T13:16:18.000Z (over 9 years ago)
• Last Synced: 2024-11-08T04:41:44.937Z (about 1 month ago)
• Language: Python
• Size: 143 KB
• Stars: 3
• Watchers: 4
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES

Awesome Lists containing this project

README

        
=================

statsd-cloudwatch

=================

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.

Installation

============

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

    respawn

    exec /app/bin/statsd_cloudwatch

Credentials

===========

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": "*"

        }]

    }