Monitoring Ruby on Rails Apps

At Clarisights, we instrument our Ruby on Rails workload, figuring these things was bit of a work so I decided to share it with the world.

We monitor our puma(web server) workers, database connections, sidekiq workers, and ruby process stats.

Here is how we do it.

ActiveRecord connection info

get details of database connections used by ActiveRecord

# get db pool stats
db_stats = ActiveRecord::Base.connection_pool.stat

puma stats

Puma.stats shows stats about Puma, we parse it and use it.

We run a simple puma plugin which runs in background and ships stats to our monitoring system.

Snippet to get puma stats(works in normal and cluster mode)

# Puma.stats: {
#        started_at: @started_at.utc.iso8601,
#        workers: @workers.size,
#        phase: @phase,
#        booted_workers: worker_status.count { |w| w[:booted] },
#        old_workers: old_worker_count,
#        worker_status: worker_status,
#      }
puma_stats = []
stats = JSON.parse(Puma.stats, symbolize_names: true)
# get puma stats
if stats[:worker_status].present?
  # in cluster mode, get stats from each worker
  # stats[:worker_status]: List of workers with their corresponding
  #                        statuses
  stats[:worker_status].each do |worker|
    # worker[:last_status]: { "backlog":0,"running":2,
    #                         "pool_capacity":2,"max_threads":2 }
    stat = worker[:last_status]
    puma_stats << stat
  puma_stats << stats

Sidekiq stats contains stats about sidekiq and it’s workers.

Snippet to get sidekiq stats

# overall and per-queue sidekiq stats
def compute_sidekiq_stats
  workers =
  # compute per queue workers
  total_capacity = 0
  total_busy = 0
  queue_workers = {}
  workers.each do |worker|
    total_capacity += worker['concurrency'].to_i
    total_busy += worker['busy'].to_i
    worker['queues'].each do |queue|
      queue_workers[queue] = queue_workers[queue].to_i + 1

  # compute queue metrics
  queue_metrics = {}
  Sidekiq::Queue.all.each do |queue|
    queue_metrics[] = {
      backlog: queue.size,
      latency: queue.latency.to_i,
      workers: queue_workers[]

  return {
    queues: queue_metrics,
    workers: {
      total_size: workers.size,
      total_capacity: total_capacity,
      total_busy: total_busy

Ruby Stats

We use ObjectSpace and GC class to collect and then send them to our monitoring system

Stats about objects and size of those objects

counts = ObjectSpace.count_objects
sizes = ObjectSpace.count_objects_size

GC stats tells us about (you guessed it) GC

stats = GC.stat

Closing Note

This is very minimal setup, but get’s the job done. Hope it is helpful :v:

PS: This is just monitoring for systems that are part of web service, we have other monitoring in place for different systems that we have run. in rails we monitor typical http stuff for example duration, response code, and bunch of other metrics for each route using influxdb-rails

Continue Reading