LICENSE NEWS README
Raindrops Aggregate Aggregate::LastDataRecv Aggregate::PMQ InetDiagSocket LastDataRecv Linux ListenStats Middleware Middleware::Proxy Struct TCP_Info Watcher

raindrops - real-time stats for preforking Rack servers

raindrops is a real-time stats toolkit to show statistics for Rack HTTP servers. It is designed for preforking servers such as unicorn, but should support any Rack HTTP server on platforms supporting POSIX shared memory. It may also be used as a generic scoreboard for sharing atomic counters across multiple processes.

Features

Linux-only Extra Features!

Users of older Linux kernels need to ensure that the the "inet_diag" and "tcp_diag" kernel modules are loaded as they do not autoload correctly

Install

We recommend GCC 4+ (or compatible) to support the __sync builtins (_sync{add,sub}_and_fetch()):

gcc.gnu.org/onlinedocs/gcc/_005f_005fsync-Builtins.html

For non-GCC 4+ users, we also support compilation with the libatomic_ops package starting with Raindrops 0.4.0:

github.com/ivmai/libatomic_ops

If you're using a packaged Ruby distribution, make sure you have a C compiler and the matching Ruby development libraries and headers.

If you use RubyGems:

gem install raindrops

Usage

See Raindrops::Middleware and Raindrops::LastDataRecv documentation for use Rack servers. The entire library is fully-documented and we are responsive on the publicly archived mailbox (raindrops-public@yhbt.net) if you have any questions or comments.

Development

You can get the latest source via git from the following locations:

https://yhbt.net/raindrops.git
http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/raindrops.git
http://repo.or.cz/w/raindrops.git (gitweb mirror)

Snapshots and tarballs are available.

Inline patches (from "git format-patch") to the mailbox are preferred because they allow code review and comments in the reply to the patch.

We will adhere to mostly the same conventions for patch submissions as git itself. See the Documentation/SubmittingPatches document distributed with git on on patch submission guidelines to follow. Just don't email the git mailing list or maintainer with raindrops patches.

raindrops is licensed under the LGPL-2.1+

Contact

All feedback (bug reports, user/development discussion, patches, pull requests) go to the publicly archived mailbox: raindrops-public@yhbt.net

Mail archives are available over HTTP(S), IMAP(S) and NNTP(S):

Since archives are public, scrub sensitive information and use anonymity tools such as Tor or Mixmaster if you deem necessary.


mail archives: https://yhbt.net/raindrops-public/
	http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/raindrops-public 
	nntps://news.public-inbox.org/inbox.comp.lang.ruby.raindrops 
	nntp://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/inbox.comp.lang.ruby.raindrops 
	imaps://yhbt.net/inbox.comp.lang.ruby.raindrops.0 
	imap://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/inbox.comp.lang.ruby.raindrops.0 
public: raindrops-public@yhbt.net
source code: git clone https://yhbt.net/raindrops.git
	torsocks git clone http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/raindrops.git