rollbar-udp-agent

rollbar-udp-agent

A daemon that listens on a udp port and pushes messages to Rollbar.

Requirements

rollbar-udp-agent requires:

• A unix-like system (tested on Fedora Linux and Mac OS X)
• Python 2.6+
• requests 0.13.1+ (will be installed by pip)
• a Rollbar_ account

Installation

Installing

Obtain a post_server_item access token from your project's Rollbar settings page and execute

ROLLBAR_ACCESS_TOKEN=post_server_item_access_token bash -c "$(curl -L https://raw.githubusercontent.com/lrascao/rollbar-udp-agent/master/setup.sh)"

Installing with pip

In a virtualenv, install like so::

sudo pip install rollbar-udp-agent

init.d script

rollbar-agent comes with an example init.d script, chkconfig compatible and tested on Fedora Linux, update-rc.d on Ubuntu Linux.

On Ubuntu, you'll need to add to rc.d. Run the following::

update-rc.d rollbar-udp-agent defaults

On Fedora, add to chkconfig::

sudo chkconfig --add rollbar-udp-agent
sudo chkconfig rollbar-udp-agent on

On other systems, check your system's documentation for its equivalent of chkconfig.

Now, start the service::

sudo service rollbar-udp-agent start

To check that it's running, tail its log file::

tail -f /var/log/rollbar-udp-agent.log

Configuration

Configuration options for rollbar-udp-agent itself are in /etc/rollbar-udp-agent.conf.

rollbar-udp-agent.conf At the bare minimum, you will want to change the following variables:

• api_key -- your Rollbar access token, specifically an API token that allows "post_server_item"

The following options are optional and have default values

• listen_port -- the udp port to listen for messages on (default 7521)
• bind_host -- interface to listen on (default is all interfaces)
• rollbar_url -- url to post messages to (default https://api.rollbar.com/api/1/item/)
• event_chunk_size -- number of events to chunk before sending to rollbar (default 50)
• event_chunk_bytes -- number of bytes to chunk before sending to rollbar (default 1048576, 1MB)
• flush_interval -- flush messages to rollbar period (default 30 seconds)
• bulk_report -- wether to send messages in a single http request or several (default false)

Contributing

Contributions are welcome. The project is hosted on github at http://github.com/lrascao/rollbar-udp-agent