rails-37-style-infrastructure-and-testing-observability - SKILL.md Agent Skill

name: rails-37-style-infrastructure-and-testing-observability description: Structured logging, Yabeda metrics license: MIT

Observability & Logging

Patterns from 37signals' Fizzy codebase.

Structured JSON Logging (#285)

# config/environments/production.rb
config.log_level = :fatal  # Suppress unstructured logs
config.structured_logging.logger = ActiveSupport::Logger.new(STDOUT)

Use rails_structured_logging gem.

Multi-Tenant Context (#301)

Inject tenant into every log:

before_action { logger.struct tenant: ApplicationRecord.current_tenant }

User Context (#472)

Log authenticated user:

def set_current_session(session)
  logger.struct "Authorized User##{session.user.id}",
    authentication: { user: { id: session.user.id } }
end

Yabeda Metrics Stack (#1112)

# Gemfile
gem "yabeda"
gem "yabeda-rails"
gem "yabeda-puma-plugin"
gem "yabeda-prometheus-mmap"

# config/puma.rb
plugin :yabeda
plugin :yabeda_prometheus

on_worker_boot do
  Yabeda::ActiveRecord.start_timed_metric_collection_task
end

Additional Yabeda Modules (#1165)

gem "yabeda-activejob"
gem "yabeda-gc"
gem "yabeda-http_requests"

# In initializer
Yabeda::ActiveJob.install!

Log Configuration (#1602)

# Silence health checks
config.silence_healthcheck_path = "/up"

# Separate logger for jobs
config.solid_queue.logger = ActiveSupport::Logger.new(STDOUT, level: :info)

Console Auditing (#1834)

For compliance, use console1984 + audits1984:

config.console1984.protected_environments = %i[production staging]
config.audits1984.base_controller_class = "AdminController"

Requires Active Record Encryption keys in protected environments.

OpenTelemetry Collector (#1118)

Deploy as sidecar for container metrics:

# config/otel_collector.yml
receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: "kamal-containers"
          docker_sd_configs:
            - host: unix:///var/run/docker.sock