ActiveUsage

Cost observability core for Ruby and Rails workloads. ActiveUsage turns runtime signals — request timing, SQL queries, job execution — into structured events you can ship to any backend for cost analysis.

Add to your Gemfile:

gem "activeusage"

ActiveUsage.configure do |config|
  config.adapter     = ActiveUsage::Adapters::Http.new("https://your-backend.example.com/events", "your-api-key")
  config.tags        = { env: Rails.env }
  config.logger      = Rails.logger
end

With Rails, ActiveUsage auto-instruments requests and jobs via a Railtie — no extra setup needed.

Requests — every process_action.action_controller notification produces a :request event with timing, allocations, controller/action tags, and SQL query breakdown.

Jobs — every ActiveJob execution produces a :job event with timing, retry count, queue name, and SQL query breakdown.

Middleware — ActiveUsage::Middleware is inserted automatically to flush per-request tags.

Use ActiveUsage.track to instrument arbitrary blocks:

result = ActiveUsage.track("reports.generate", tags: { user_id: current_user.id }) do
  ReportGenerator.call(params)
end

This produces a :task event with timing and SQL queries captured within the block.

Tags are thread-local and merged into every event recorded on the current thread:

ActiveUsage.tags.tag(user_id: current_user.id, tenant: current_tenant.slug)

Tags set on the thread are flushed automatically at the end of each request by the middleware and at the start/end of each job by the hook.

Every event includes: