Skip to main content

ratchet-agent

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

Metadata

Release files for ratchet-agent 0.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ratchet-agent 0.2.4
File Size Uploaded
ratchet-agent-0.2.4.tar.gz 12.4 kB Details

Release files / ratchet-agent-0.2.4.tar.gz

Download URL ratchet-agent-0.2.4.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
ea39f77d3b3a0b95c7527942aba6a3134941f4ac6c5476b8e221d9ae353ccccf
BLAKE2b-256 checksum
How to use checksums
8bbe2e807827792af1e9db2d268d1bffdbcb97aa083430a22c2a440cf80b49ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.4 This release

1 release file

0.2.3

1 release file

0.2.2

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.1.17

1 release file

0.1.16

1 release file

0.1.15

1 release file

0.1.14

1 release file

0.1.13

1 release file

0.1.12

1 release file

0.1.11

1 release file

0.1.10

1 release file

0.1.9

1 release file

0.1.8

1 release file

0.1.7

1 release file

0.1.6

1 release file

0.1.5

1 release file

0.1.4

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page