ReevooAppMonitor

ReevooAppMonitor consolidates logstasher, statsd and sentry raven into a single library with one setup. It's designed for Rack/Grape apps. It automatically tracks all log messages into logstash, exceptions into sentry and updates exceptions stats in statsd. It also allow you to call methods directly on instances of statsd and raven if needed.

Installation

In your Gemfile:

gem 'reevoo_app_monitor'

Init app monitor:

module TestApp
  def self.production?
    ENV["RACK_ENV"] == "production"
  end

  def self.app_monitor
    @app_monitor ||= ReevooAppMonitor.new(
      app_name: "foo_app",
      root_dir: Rack::Directory.new("").root,
      device: STDOUT,
      raven_conf: {
        dsn: "https://your_get_setnry_key@app.getsentry.com/application_id"
      },
      statsd_conf: {
        host: ENV.fetch('STATSD_HOST'),
        port: ENV.fetch('STATSD_PORT'),
      }
    )
  end

  def self.logger
    production? ? app_monitor.logger : Logger.new(STDOUT)
  end

  def self.stats
    production? ? app_monitor.stats : app_monitor.nil_service
  end
end

All constructor arguments:

ReevooAppMonitor.new(
  app_name: "foo_app",
  root_dir: Rack::Directory.new("").root
  device: STDOUT, # default is file log in log/logstasher.log
  integrations: [:logstasher, :statsd, :raven], # you can turn off individual integrations
  raven_conf: {
    dsn: "https://your_get_setnry_key@app.getsentry.com/application_id"
  },
  statsd_conf: { # in most cases you should be fine with default localhost:8125
    host: "my-host",
    port: 1234
  }
)

Setup Grape request/exception logging

Add to Gemfile

gem 'grape_logging'

Setup in Grape::API class

module TestApp
  class API < Grape::API
    logger TestApp.logger
    use GrapeLogging::Middleware::RequestLogger, logger: TestApp.logger

    rescue_from TestApp::NotFound do |err|
      # Tag your exception
      API.logger.info(exception: err, tags: "rescued_exception", status: 404)
      error_response(message: "Not found", status: 404)
    end

    rescue_from :all do |e|
      API.logger.error(e)
      error_response(message: e.message, status: 500)
    end
  end
end

Track statsd metrics directly

You can call all methods supported by https://github.com/DataDog/dogstatsd-ruby

  TestApp.stats.increment('foo.bar')
  TestApp.stats.gauge('foo.online', 123)
  TestApp.stats.histogram('foo.upload.size', 1234)
  TestApp.stats.time('page.render') do
    render_page('home.html')
  end

License

The gem is available as open source under the terms of the MIT License.

reevoo_app_monitor

Development