Skip to main content

Ratchet.io server-side agent

Project description

A daemon to monitor log files and push messages to Ratchet.io.

Requirements

ratchet-agent requires:

  • A unix-like system (tested on Fedora Linux and Mac OS X)
  • Python 2.6+
  • requests 0.13.1+
  • a Ratchet.io account

Installation

Install with pip:

pip install ratchet-agent

This will install the ratchet-agent files in the root directory of your virtualenv. Or if you’d prefer, clone this git repo:

git clone https://github.com/ratchetio/ratchet-agent.git

See Configuration for configuration options and setup.

ratchet-agent comes with an example init.d script, chkconfig compatible and tested on Fedora Linux. To install it, symlink ratchet-agent-init.sh to /etc/init.d/ratchet-agent and add to chkconfig:

ln -s /path/to/ratchet-agent/ratchet-agent-init.sh /etc/init.d/ratchet-agent
chkconfig --add ratchet-agent
chkconfig on ratchet-agent
service ratchet-agent start

Configuration

Configuration options for ratchet-agent itself are in ratchet-agent.conf. If you’re using the init script, it has a few of its own configuration variables inside which control how it runs.

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

  • params.access_token – your Ratchet.io access token
  • targets – white-space-separated list of files or directories (non-recursive) to process.

Setting the following variables will improve github integration:

  • params.root – path to your code root
  • params.branch – the current branch

Other options are documented in the sample config file.

ratchet-agent-init.sh Configuration variables should be self-explanatory. If you’re not using a virtualenv, set VIRTUALENV="".

Contributing

Contributions are welcome. The project is hosted on github at http://github.com/ratchetio/ratchet-agent

Additional Help

If you have any questions, feedback, etc., drop me a line at brian@ratchet.io

Release history Release notifications

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

This version
History Node

0.2.1

History Node

0.2.0

History Node

0.1.17

History Node

0.1.16

History Node

0.1.15

History Node

0.1.14

History Node

0.1.13

History Node

0.1.12

History Node

0.1.11

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

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
ratchet-agent-0.2.1.tar.gz (12.2 kB) Copy SHA256 hash SHA256 Source None Sep 28, 2012

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