balanced-spectator

Rack middleware to enqueue Balanced events to RabbitMQ

Usage

Gemfile

gem 'balanced-spectator', github: 'remear/balanced-spectator'

config.ru

require 'bundler/setup'
Bundler.require(:default)

run Balanced::Spectator::Base.new

Options

Available options:

authorized_ips - Array of strings of allowed request IPs. This is added to 127.0.0.1 and the current Balanced IPs.

ignored_event_types - Array of strings of Balanced Event types to ignore and not pass to RabbitMQ.

rabbitmq_queue_name - Name of the RabbitMQ queue to use. Defaults to balanced_event_incoming.

rabbitmq_host - Name of the RabbitMQ server. Defaults to localhost.

rabbitmq_port - Port on which to connect to the RabbitMQ server. Defaults to 5672.

rabbitmq_ssl - Whether or not to use SSL when connecting to the RabbitMQ server. Defaults to false.

rabbitmq_vhost - VHost to use when connecting. Defaults to /.

rabbitmq_user - Username for connecting to RabbitMQ server. Defaults to guest.

rabbitmq_pass - Password for connecting to RabbitMQ server. Defaults to guest.

Example usage:

run Balanced::Spectator::Base.new(
  :authorized_ips => ['192.168.0.10', '192.168.0.11'],
  :ignored_event_types => ['debit.succeeded', 'debit.failed', 'credit.succeeded'],
  :rabbitmq_queue_name => 'balanced_event_incoming',
  :rabbitmq_host => 'localhost',
  :rabbitmq_port => 5672,
  :rabbitmq_ssl => false,
  :rabbitmq_vhost => '/',
  :rabbitmq_user => 'guest',
  :rabbitmq_pass => 'guest'
)

Run the application

While there are several ways to run a Rack application, a common way is to use Puma.

puma config.ru -p 9293

To daemonize:

puma -d config.ru -p 9293