e11y 0.2.0 → 1.0.0

data/RELEASE.md

@@ -20,14 +20,29 @@ For more control, see [Step-by-Step Release](#step-by-step-release) below.
 
 ## Pre-Release Checklist
 
+### Core
 - [ ] All changes documented in CHANGELOG.md under `[Unreleased]`
 - [ ] Version bumped: `rake release:bump`
-- [ ] All tests passing: `rake spec`
+- [ ] All tests passing: `rake spec:all` (unit + integration)
+- [ ] RuboCop clean: `bundle exec rubocop`
 - [ ] Changes committed
 - [ ] Git tag created
 - [ ] Published to RubyGems.org
 - [ ] GitHub release created
 
+### Documentation & Links
+- [ ] All doc links valid (ADRs in `docs/architecture/`, use cases in `docs/use_cases/`)
+- [ ] No broken references to deleted files (e.g. `docs/analysis/`, `docs/IMPLEMENTATION_PLAN.md`)
+- [ ] README, CONTRIBUTING, CLAUDE.md reference correct paths
+- [ ] All user-facing text in English (no Russian in docs/code comments)
+
+### Production Readiness
+- [ ] SECURITY.md present (if handling sensitive data)
+- [ ] LICENSE file present and correct
+- [ ] No TODO/FIXME in critical paths
+- [ ] Deprecation warnings documented (if any)
+- [ ] Breaking changes clearly called out in CHANGELOG
+
 ## Step-by-Step Release
 
 ### Step 0: Bump Version
@@ -181,7 +196,7 @@ bundle install
 ## 📚 Documentation
 
 - **Quick Start**: [README.md](https://github.com/arturseletskiy/e11y#quick-start)
-- **Architecture**: [docs/ADR-INDEX.md](https://github.com/arturseletskiy/e11y/blob/main/docs/ADR-INDEX.md)
+- **Architecture**: [docs/architecture/ADR-INDEX.md](https://github.com/arturseletskiy/e11y/blob/main/docs/architecture/ADR-INDEX.md)
 - **Benchmarks**: [benchmarks/README.md](https://github.com/arturseletskiy/e11y/blob/main/benchmarks/README.md)
 
 ## 🔥 What's New
@@ -192,7 +207,7 @@ See [CHANGELOG.md](https://github.com/arturseletskiy/e11y/blob/main/CHANGELOG.md
 - Event System with dry-schema validation
 - Pipeline Architecture (middleware-based)
 - 7 Adapters: Stdout, File, InMemory, Loki, Sentry, OpenTelemetry, Yabeda
-- 3 Buffer Types: RingBuffer, RequestScopedBuffer, AdaptiveBuffer
+- 3 Buffer Types: RingBuffer, EphemeralBuffer, AdaptiveBuffer
 - Reliability: Retry, Circuit Breaker, Dead Letter Queue
 
 ### SLO Tracking (Phase 3)

data/Rakefile

@@ -20,6 +20,12 @@ require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 require "rubocop/rake_task"
 
+def e11y_devtools_specs_available?
+  # Devtools specs live in monorepo; run them when the directory exists
+  # (no need for gem in bundle — spec_helper loads lib via path)
+  File.directory?(File.join(__dir__, "gems/e11y-devtools/spec"))
+end
+
 RSpec::Core::RakeTask.new(:spec)
 
 RuboCop::RakeTask.new
@@ -36,7 +42,6 @@ namespace :spec do
   desc "Run integration tests (requires Rails, bundle install --with integration)"
   task :integration do
     # Run integration tests with explicit file patterns to avoid loading all specs
-    # This prevents test pollution from unit test files
     sh "INTEGRATION=true bundle exec rspec " \
        "spec/integration/*.rb " \
        "spec/e11y/adapters/*_spec.rb " \
@@ -49,13 +54,27 @@ namespace :spec do
     sh "bundle exec rspec spec/e11y/railtie_integration_spec.rb --tag railtie_integration"
   end
 
-  desc "Run all tests (unit + integration + railtie, ~1729 examples)"
+  desc "Run all tests (unit + memory + integration + railtie + cucumber)"
   task :all do
     puts "\n#{'=' * 80}"
     puts "Running UNIT tests (spec/e11y + top-level specs)..."
     puts "#{'=' * 80}\n"
     Rake::Task["spec:unit"].invoke
 
+    if e11y_devtools_specs_available?
+      puts "\n#{'=' * 80}"
+      puts "Running E11Y-DEVTOOLS unit tests (gems/e11y-devtools/spec/)..."
+      puts "#{'=' * 80}\n"
+      Rake::Task["spec:devtools"].invoke
+    else
+      puts "\n⏭️  Skipping e11y-devtools specs (gems/e11y-devtools/spec/ not found)"
+    end
+
+    puts "\n#{'=' * 80}"
+    puts "Running MEMORY tests (allocations, leaks, consumption)..."
+    puts "#{'=' * 80}\n"
+    Rake::Task["spec:memory"].invoke
+
     puts "\n#{'=' * 80}"
     puts "Running INTEGRATION tests (spec/integration)..."
     puts "#{'=' * 80}\n"
@@ -66,6 +85,15 @@ namespace :spec do
     puts "#{'=' * 80}\n"
     Rake::Task["spec:railtie"].invoke
 
+    if Rake::Task.task_defined?("cucumber:passing")
+      puts "\n#{'=' * 80}"
+      puts "Running CUCUMBER tests (features/, exclude @wip)..."
+      puts "#{'=' * 80}\n"
+      Rake::Task["cucumber:passing"].invoke
+    else
+      puts "\n⚠️  Skipping Cucumber (bundle install --with development)"
+    end
+
     puts "\n#{'=' * 80}"
     puts "✅ All test suites completed!"
     puts "#{'=' * 80}\n"
@@ -86,15 +114,31 @@ namespace :spec do
     sh "bundle exec rspec spec/e11y --tag benchmark"
   end
 
-  desc "Run ALL tests including benchmarks (very slow)"
+  desc "Run memory profiling specs (allocations, leaks, consumption)"
+  task :memory do
+    sh "bundle exec rspec " \
+       "spec/e11y/memory_spec.rb " \
+       "spec/e11y/event/base_benchmark_spec.rb " \
+       "--tag memory --format documentation"
+  end
+
+  desc "Run e11y-devtools unit tests (gems/e11y-devtools/spec/)"
+  task :devtools do
+    sh "bundle exec rspec gems/e11y-devtools/spec/ --tag ~integration --format progress"
+  end
+
+  desc "Run ALL tests including benchmarks and cucumber (very slow)"
   task :everything do
     puts "\n#{'=' * 80}"
-    puts "Running ALL tests (unit + integration + railtie + benchmarks)"
+    puts "Running ALL tests (unit + integration + railtie + cucumber + benchmarks)"
     puts "#{'=' * 80}\n"
     Rake::Task["spec:unit"].invoke
+    Rake::Task["spec:devtools"].invoke if e11y_devtools_specs_available?
     Rake::Task["spec:integration"].invoke
     Rake::Task["spec:railtie"].invoke
+    Rake::Task["cucumber:passing"].invoke if Rake::Task.task_defined?("cucumber:passing")
     Rake::Task["spec:benchmark"].invoke
+    Rake::Task["spec:memory"].invoke
 
     puts "\n#{'=' * 80}"
     puts "✅ All test suites including benchmarks completed!"
@@ -136,32 +180,32 @@ namespace :release do
   task :bump do
     require_relative "lib/e11y/version"
     current_version = E11y::VERSION
-    
+
     puts "\n#{'=' * 80}"
     puts "📝 Version Bump"
     puts "#{'=' * 80}\n"
     puts "Current version: #{current_version}"
     puts "\nEnter new version (e.g., 0.2.0, 1.0.0):"
-    
+
     new_version = $stdin.gets.chomp.strip
-    
+
     if new_version.empty?
       puts "❌ Error: Version cannot be empty"
       exit 1
     end
-    
+
     unless new_version.match?(/^\d+\.\d+\.\d+$/)
       puts "❌ Error: Invalid version format. Use semantic versioning (e.g., 0.2.0)"
       exit 1
     end
-    
+
     if new_version == current_version
       puts "⚠️  Warning: New version is the same as current version"
       puts "Continue anyway? (y/N)"
       response = $stdin.gets.chomp.downcase
-      exit 0 unless response == "y" || response == "yes"
+      exit 0 unless %w[y yes].include?(response)
     end
-    
+
     puts "\n[1/3] Updating lib/e11y/version.rb..."
     version_file = "lib/e11y/version.rb"
     version_content = File.read(version_file)
@@ -171,58 +215,60 @@ namespace :release do
     )
     File.write(version_file, updated_version_content)
     puts "✅ Updated: #{current_version} → #{new_version}"
-    
+
     puts "\n[2/3] Updating CHANGELOG.md..."
     changelog_file = "CHANGELOG.md"
     changelog_content = File.read(changelog_file)
-    
+
     # Check if there's an [Unreleased] section
+    today = Time.now.strftime("%Y-%m-%d")
     if changelog_content.include?("## [Unreleased]")
       # Replace [Unreleased] with version and date
-      today = Time.now.strftime("%Y-%m-%d")
       updated_changelog = changelog_content.sub(
-        /## \[Unreleased\]/,
+        "## [Unreleased]",
         "## [#{new_version}] - #{today}"
       )
-      
+
       # Add new [Unreleased] section at the top
+      unreleased = "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n"
+      unreleased += "### Deprecated\n\n### Removed\n\n### Security\n\n\\1"
       updated_changelog = updated_changelog.sub(
         /(## \[#{Regexp.escape(new_version)}\] - #{today})/,
-        "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n### Deprecated\n\n### Removed\n\n### Security\n\n\\1"
+        unreleased
       )
-      
+
       File.write(changelog_file, updated_changelog)
       puts "✅ Updated CHANGELOG.md:"
       puts "   - [Unreleased] → [#{new_version}] - #{today}"
       puts "   - Added new [Unreleased] section"
     else
       # No [Unreleased] section, just add version entry
-      today = Time.now.strftime("%Y-%m-%d")
-      
+
       # Find where to insert (after the header, before first version)
-      if changelog_content =~ /(## \[\d+\.\d+\.\d+\])/
-        updated_changelog = changelog_content.sub(
-          /(## \[\d+\.\d+\.\d+\])/,
-          "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n### Deprecated\n\n### Removed\n\n### Security\n\n## [#{new_version}] - #{today}\n\n### Added\n- Version bump\n\n\\1"
-        )
+
+      if /(## \[\d+\.\d+\.\d+\])/.match?(changelog_content)
+        new_section = "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n"
+        new_section += "### Deprecated\n\n### Removed\n\n### Security\n\n"
+        new_section += "## [#{new_version}] - #{today}\n\n### Added\n- Version bump\n\n\\1"
+        updated_changelog = changelog_content.sub(/(## \[\d+\.\d+\.\d+\])/, new_section)
       else
         # No previous versions, add after header
         header_end = changelog_content.index("\n\n") || 0
         header = changelog_content[0..header_end]
-        rest = changelog_content[header_end + 1..-1] || ""
+        rest = changelog_content[(header_end + 1)..] || ""
         updated_changelog = "#{header}\n## [#{new_version}] - #{today}\n\n### Added\n- Initial release\n\n#{rest}"
       end
-      
+
       File.write(changelog_file, updated_changelog)
       puts "✅ Added version [#{new_version}] - #{today} to CHANGELOG.md"
     end
-    
+
     puts "\n[3/3] Summary"
     puts "✅ Version bumped: #{current_version} → #{new_version}"
     puts "✅ Files updated:"
     puts "   - lib/e11y/version.rb"
     puts "   - CHANGELOG.md"
-    
+
     puts "\n#{'=' * 80}"
     puts "Next steps:"
     puts "  1. Review changes: git diff"
@@ -412,3 +458,36 @@ namespace :release do
     puts "✅ Clean complete"
   end
 end
+
+# ---------------------------------------------------------------------------
+# Cucumber acceptance tests
+# ---------------------------------------------------------------------------
+begin
+  require "cucumber/rake/task"
+
+  namespace :cucumber do
+    desc "Run all Cucumber acceptance tests"
+    Cucumber::Rake::Task.new(:all) do |t|
+      t.cucumber_opts = ["--format", "progress", "features/"]
+    end
+
+    desc "Run only @wip (known-bug) Cucumber scenarios"
+    Cucumber::Rake::Task.new(:wip) do |t|
+      t.cucumber_opts = ["--tags", "@wip", "--format", "progress", "features/"]
+    end
+
+    desc "Run passing Cucumber scenarios (exclude @wip)"
+    Cucumber::Rake::Task.new(:passing) do |t|
+      # Quote tag expression so shell keeps "not @wip" as one arg (Cucumber::Rake::Task uses cmd.join(' '))
+      t.cucumber_opts = ["--tags", '"not @wip"', "--format", "progress", "features/"]
+    end
+  end
+
+  desc "Run all Cucumber acceptance tests (alias for cucumber:all)"
+  task cucumber: "cucumber:all"
+rescue LoadError
+  desc "Cucumber not available — install with: bundle install --with development"
+  task :cucumber do
+    warn "Cucumber gem is not available. Run: bundle install --with development"
+  end
+end

data/config/README.md

@@ -80,4 +80,4 @@ Edit `docker-compose.yml` and change port mappings.
 
 ⚠️ **This is for TESTING ONLY!** Do not use these configurations in production.
 
-For production setup, see `docs/guides/production-deployment.md` (Phase 5).
+For production setup, see [QUICK-START](../docs/QUICK-START.md) and [CONFIGURATION](../docs/CONFIGURATION.md).

data/config/loki-local-config.yaml

@@ -26,6 +26,18 @@ schema_config:
         prefix: index_
         period: 24h
 
+# Fast flush for integration tests
+ingester:
+  chunk_idle_period: 1s       # Flush chunks after 1 second of inactivity
+  chunk_retain_period: 1s     # Keep chunks in memory for 1 second before flush
+  max_chunk_age: 2s           # Force flush after 2 seconds
+  chunk_target_size: 0        # Disable size-based flush delay
+  chunk_encoding: snappy
+  wal:
+    enabled: true
+    dir: /tmp/loki/wal
+    replay_memory_ceiling: 100MB
+
 ruler:
   alertmanager_url: http://localhost:9093
 

data/config/otel-collector-config.yaml

@@ -0,0 +1,44 @@
+# OpenTelemetry Collector config for E11y integration tests
+# Receives OTLP (logs, traces, metrics) and exports to debug + Loki
+#
+# Usage: docker compose up -d otel-collector
+# App sends to: http://localhost:4318 (HTTP) or localhost:4317 (gRPC)
+
+receivers:
+  otlp:
+    protocols:
+      grpc:
+        endpoint: 0.0.0.0:4317
+      http:
+        endpoint: 0.0.0.0:4318
+
+processors:
+  batch:
+    timeout: 5s
+    send_batch_size: 1024
+
+exporters:
+  debug:
+    verbosity: detailed
+    sampling_initial: 5
+    sampling_thereafter: 200
+
+  # Forward logs to Loki (same backend as direct Loki adapter)
+  # Requires contrib image: otel/opentelemetry-collector-contrib
+  loki:
+    endpoint: http://loki:3100/loki/api/v1/push
+
+service:
+  pipelines:
+    logs:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug, loki]
+    traces:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]
+    metrics:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]

data/cucumber.yml

@@ -0,0 +1 @@
+default: --publish-quiet

data/docker-compose.yml

@@ -1,5 +1,3 @@
-version: '3.8'
-
 services:
   loki:
     image: grafana/loki:2.9.0
@@ -69,6 +67,24 @@ services:
     networks:
       - e11y_network
 
+  # OpenTelemetry Collector - receives OTLP, exports to debug + Loki
+  # HTTP: localhost:4318, gRPC: localhost:4317
+  # Usage: docker compose up -d loki otel-collector
+  otel-collector:
+    image: otel/opentelemetry-collector-contrib:0.104.0
+    container_name: e11y_otel_collector
+    ports:
+      - "4317:4317"   # OTLP gRPC
+      - "4318:4318"   # OTLP HTTP
+    volumes:
+      - ./config/otel-collector-config.yaml:/etc/otelcol-contrib/config.yaml
+    command: ["--config=/etc/otelcol-contrib/config.yaml"]
+    depends_on:
+      loki:
+        condition: service_healthy
+    networks:
+      - e11y_network
+
 networks:
   e11y_network:
     driver: bridge

data/docs/ADAPTERS.md

@@ -0,0 +1,76 @@
+# Adapters
+
+> Back to [README](../README.md#documentation)
+
+E11y supports multiple adapters for different backends.
+
+| Adapter | Purpose | Batching | Use Case |
+|---------|---------|----------|----------|
+| **Loki** | Log aggregation (Grafana) | Yes | Production logs |
+| **Sentry** | Error tracking | Via SDK | Error monitoring |
+| **OpenTelemetry** | OTLP export (OTelLogs, OpenTelemetryCollector) | Varies | Distributed tracing, logs |
+| **Yabeda** | Prometheus metrics | N/A | Metrics export |
+| **File** | Local logs | Yes | Development, CI |
+| **Stdout** | Console output | No | Development |
+| **InMemory** | Test buffer | No | Testing |
+
+## Configuration
+
+```ruby
+# config/initializers/e11y.rb
+E11y.configure do |config|
+  # Configure adapters
+  config.adapters[:logs] = E11y::Adapters::Loki.new(
+    url: ENV["LOKI_URL"],
+    batch_size: 100,
+    batch_timeout: 5,
+    compress: true
+  )
+  
+  config.adapters[:errors_tracker] = E11y::Adapters::Sentry.new(
+    dsn: ENV["SENTRY_DSN"]
+  )
+  
+  config.adapters[:stdout] = E11y::Adapters::Stdout.new(
+    format: :pretty
+  )
+
+  # OpenTelemetry Collector (compress: true default, requires Faraday)
+  # config.adapters[:otel] = E11y::Adapters::OpenTelemetryCollector.new(
+  #   endpoint: ENV["OTEL_EXPORTER_OTLP_ENDPOINT"],
+  #   service_name: "my-app"
+  # )
+end
+```
+
+## Adapter Routing by Severity
+
+Events are routed to adapters based on severity. The default mapping:
+
+- `error`, `fatal` → `[:logs, :errors_tracker]`
+- Other severities → `[:logs]`
+
+Override routing explicitly:
+
+```ruby
+class CustomEvent < E11y::Event::Base
+  adapters :logs, :stdout  # Explicit routing
+end
+```
+
+## Custom Adapters
+
+Implement the `write` method:
+
+```ruby
+class MyBackendAdapter < E11y::Adapters::Base
+  def write(event_data)
+    # event_data contains event_name, payload, severity, timestamp, etc.
+    MyBackend.send_event(event_data)
+  end
+end
+
+E11y.configure do |config|
+  config.adapters[:my_backend] = MyBackendAdapter.new
+end
+```

data/docs/ADAPTIVE_SAMPLING.md

@@ -0,0 +1,59 @@
+# Adaptive Sampling
+
+> Back to [README](../README.md#documentation)
+
+E11y supports adaptive sampling to reduce event volume during high load.
+
+Sampling strategies:
+
+1. **Error-based** - Increase sampling during error spikes
+2. **Load-based** - Reduce sampling under high throughput
+3. **Value-based** - Always sample high-value events
+
+> **Note:** Rate limiting (`E11y::Middleware::RateLimiting`) is **not included in the default
+> pipeline**. To enable it, add it manually:
+>
+> ```ruby
+> config.pipeline.use E11y::Middleware::RateLimiting
+> ```
+> Enabling `config.rate_limiting_enabled = true` alone has no effect without this step.
+
+## Configuration
+
+```ruby
+E11y.configure do |config|
+  config.pipeline.use E11y::Middleware::Sampling,
+    default_sample_rate: 0.1,
+    
+    # Error-based sampling
+    error_based_adaptive: true,
+    error_spike_config: {
+      window: 60,
+      absolute_threshold: 100,
+      relative_threshold: 3.0,
+      spike_duration: 300
+    },
+    
+    # Load-based sampling
+    load_based_adaptive: true,
+    load_monitor_config: {
+      window: 60,
+      thresholds: {
+        normal: 1_000,
+        high: 10_000,
+        very_high: 50_000,
+        overload: 100_000
+      }
+    }
+end
+```
+
+## Value-Based Sampling
+
+Sample events based on payload values:
+
+```ruby
+class PaymentEvent < E11y::Event::Base
+  sample_by_value :amount, greater_than: 1000  # Always sample large payments
+end
+```

data/docs/COMPARISON.md

@@ -0,0 +1,104 @@
+# E11y vs. Alternatives — Detailed Comparison
+
+> For a quick overview, see the [comparison table in README](../README.md#what-makes-e11y-different).
+
+### Detailed Comparisons
+
+#### vs. SaaS APM (Datadog, New Relic, Dynatrace)
+
+**Datadog / New Relic:**
+- ✅ **Pros:** Full-stack visibility, mature dashboards, auto-instrumentation
+- ❌ **Cons:** $500-5k/month, vendor lock-in, no debug buffering, no schema validation
+- **E11y advantage:** 10x cheaper, request-scoped buffering (unique), type-safe events, own your data
+
+**When to use Datadog/New Relic instead:**
+- You need frontend RUM (Real User Monitoring)
+- You have polyglot microservices (not just Rails)
+- Budget is unlimited, prefer turnkey solution
+
+---
+
+#### vs. Open-Source Logging (Semantic Logger, Lograge)
+
+**Semantic Logger:**
+- ✅ **Pros:** Structured logs (JSON), async writes, Rails integration
+- ❌ **Cons:** No debug buffering, no schema validation, no auto-metrics, logs-only
+- **E11y advantage:** Request-scoped buffering (unique), schema validation, auto-metrics, unified events
+
+**Lograge:**
+- ✅ **Pros:** Reduces Rails log noise (single-line requests)
+- ❌ **Cons:** Filtering only, no buffering, no validation, no metrics
+- **E11y advantage:** Request-scoped buffering (selective, not filtering), schema validation, auto-metrics
+
+**When to use Semantic Logger instead:**
+- You only need structured JSON logs (no events/metrics)
+- You don't need debug buffering or schema validation
+
+---
+
+#### vs. OpenTelemetry
+
+**OpenTelemetry:**
+- ✅ **Pros:** Industry standard, polyglot, vendor-neutral, mature ecosystem
+- ❌ **Cons:** Complex setup (1-2 weeks), no debug buffering, no schema validation, overkill for Rails monolith
+- **E11y advantage:** Fast setup, Rails-first, request-scoped buffering, schema validation
+
+**When to use OpenTelemetry instead:**
+- You have microservices in multiple languages (Go, Java, Python, etc.)
+- You need distributed tracing across services
+- You have a platform team to manage complexity
+
+**Use both:** E11y events can be sent to OpenTelemetry via `E11y::Adapters::OtelLogs`
+
+---
+
+#### vs. Grafana + Loki + Prometheus
+
+**Grafana Stack:**
+- ✅ **Pros:** Open-source, powerful visualizations, mature, self-hosted
+- ❌ **Cons:** Complex setup (2-3 days), requires DevOps, no Rails integration, no schema validation
+- **E11y advantage:** Fast setup, Rails-native, schema validation, no DevOps required
+
+**When to use Grafana Stack instead:**
+- You already have Grafana/Loki infrastructure
+- You have a dedicated DevOps team
+- You need custom dashboards across multiple systems
+
+**Use both:** E11y can send events to Loki via `E11y::Adapters::Loki`
+
+---
+
+#### vs. Error Tracking (Sentry, Honeybadger, Rollbar)
+
+**Sentry:**
+- ✅ **Pros:** Excellent error tracking, stack traces, breadcrumbs, release tracking
+- ❌ **Cons:** Errors-only, no debug buffering, no schema validation, $26-80/mo
+- **E11y advantage:** Events + errors + metrics unified, request-scoped buffering, schema validation
+
+**When to use Sentry instead:**
+- You only need error tracking (not general observability)
+- You need frontend JavaScript error tracking
+
+**Use both:** E11y can send error events to Sentry via `E11y::Adapters::Sentry`
+
+---
+
+#### vs. Rails-First APM (AppSignal, Skylight)
+
+**AppSignal:**
+- ✅ **Pros:** Rails-native, beautiful UI, performance monitoring, $23/mo entry
+- ❌ **Cons:** SaaS lock-in, no debug buffering, no schema validation, limited to supported languages
+- **E11y advantage:** Request-scoped buffering (unique), schema validation, own your data
+
+**Skylight:**
+- ✅ **Pros:** Rails performance profiling, SQL query analysis
+- ❌ **Cons:** Performance-only (no logs/events), SaaS lock-in, $20+/mo
+- **E11y advantage:** Unified events/logs/metrics, request-scoped buffering, own your data
+
+**When to use AppSignal/Skylight instead:**
+- You want zero-config turnkey solution
+- You prefer paying for hosted service over self-hosting
+
+**Use both:** E11y for events/logs/metrics, AppSignal for performance profiling
+
+---