Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Rollbar server-side UDP agent

Project description

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

Release history Release notifications

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
rollbar-udp-agent-0.0.15.tar.gz (12.6 kB) Copy SHA256 hash SHA256 Source None May 27, 2015

Supported by

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