memhealth 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8c0895575f5adc6767b228212ace922f4eb66eb565771c05bde602b4c4b48971
+  data.tar.gz: b44315dc375c9fa4108a5fb889f76dd1a0520883f9c8952a675c8fd840bc981a
+SHA512:
+  metadata.gz: f5e263596880a31d83003ebe56700a6ed94d8bb6eafa60222b7424fbb1f8632b9a534b9952d6c892d41637a43f66df0a4d673d6e7f62c4f35c0279382a8486cc
+  data.tar.gz: 80ad19cf0d82d6a4f543701a82736c6837d265b0daa57ef9a709df99c550452b2fb8e77f131add2e86e2871c0978729d06e84035539b42cc1eb5c40ff6e5f2f5

data/LICENSE

@@ -0,0 +1 @@
+MIT License

data/README.md

@@ -0,0 +1,114 @@
+# MemHealth
+
+A Rails engine for monitoring memory health, detecting growth patterns (leaks & bloats) and memory swap operations. Helps you identify requests that consume high amounts of RAM and is compatible with Heroku.
+
+## Features
+
+- Real-time memory usage monitoring
+- Track highest memory consuming requests
+- Account-level tracking for multi-tenant apps
+- Redis-based data storage
+- Web dashboard for viewing statistics
+- Configurable thresholds and limits
+
+<img width="1139" height="680" alt="s_2" src="https://github.com/user-attachments/assets/5e170097-77cf-4ec5-a7b0-47aeaf92135f" />
+
+<img width="1142" height="696" alt="s_1" src="https://github.com/user-attachments/assets/68eeb503-e259-4dc0-b3b1-3438375b42d4" />
+
+## Heroku Memory Issues
+
+If you're getting **R14 - Memory quota exceeded** errors, it means your application is using swap memory. Swap uses the disk to store memory instead of RAM. Disk speed is significantly slower than RAM, so page access time is greatly increased. This leads to a significant degradation in application performance. An application that is swapping will be much slower than one that is not. No one wants a slow application, so getting rid of R14 Memory quota exceeded errors on your application is very important.
+
+<img width="909" height="272" alt="Screenshot 2025-08-30 at 18 46 41" src="https://github.com/user-attachments/assets/65bb2131-4dfd-4974-9647-805e44bc35f7" />
+
+MemHealth helps you identify which specific requests are consuming excessive memory, allowing you to pinpoint and fix the root cause of these performance issues.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "memhealth", git: "https://github.com/topkeyhq/memhealth"
+```
+
+And then execute:
+
+    $ bundle install
+
+## Configuration
+
+```ruby
+MemHealth.configure do |config|
+  config.redis_url = ENV.fetch(ENV.fetch("REDIS_URL", "redis://localhost:6379/0"))
+end
+```
+
+Configure Memhealth using environment variables:
+
+| Environment Variable              | Description                                                                    | Default Value |
+| --------------------------------- | ------------------------------------------------------------------------------ | ------------- |
+| `MEM_HEALTH_ENABLED`              | Enable/disable memory tracking                                                 | `false`       |
+| `MEM_HEALTH_SKIP_REQUESTS`        | Number of initial requests to skip (avoids class loading overhead)             | `10`          |
+| `MEM_HEALTH_MEMORY_THRESHOLD_MB`  | Minimum memory difference (MB) to track a request                              | `1`           |
+| `MEM_HEALTH_RAM_BEFORE_THRESHOLD` | Minimum RAM usage (MB) before tracking (prevents tracking low-memory requests) | `0`           |
+| `MEM_HEALTH_MAX_STORED_URLS`      | Maximum number of URLs to store in Redis                                       | `20`          |
+| `MEM_HEALTH_REDIS_KEY`            | Name of environment variable containing Redis URL (e.g., `REDISCLOUD_URL`)     | `REDIS_URL`   |
+
+The gem will read the Redis connection URL from the environment variable specified in `MEM_HEALTH_REDIS_KEY`, falling back to `REDIS_URL` if not specified.
+
+## Usage
+
+Mount the engine in your routes within an authenticated section:
+
+```ruby
+# config/routes.rb
+Rails.application.routes.draw do
+  # ... other routes ...
+
+  # Mount within authenticated admin section
+  authenticate :admin_user do
+    mount MemHealth::Engine, at: "/admin/memhealth"
+  end
+end
+```
+
+Enable memory tracking by setting:
+
+```bash
+MEM_HEALTH_ENABLED=true
+```
+
+### ActiveAdmin Integration
+
+To add Memhealth to your ActiveAdmin Operations menu, add this to your ActiveAdmin initializer:
+
+```ruby
+# config/initializers/active_admin.rb
+ActiveAdmin.setup do |config|
+  # ... other config ...
+
+  config.namespace :admin do |admin|
+    admin.build_menu do |menu|
+      # ... other menu items ...
+      menu.add label: "MemHealth", url: "/admin/memhealth", parent: "Operations"
+    end
+  end
+end
+```
+
+## Console Usage
+
+```ruby
+# View statistics
+MemHealth::Tracker.print_stats
+
+# Get top memory consuming URLs
+MemHealth::Tracker.top_memory_urls
+
+# Clear all data
+MemHealth::Tracker.clear_all_data
+```
+
+## License
+
+The gem is available as open source under the [MIT License](LICENSE).

data/app/controllers/mem_health/dashboard_controller.rb

@@ -0,0 +1,36 @@
+module MemHealth
+  class DashboardController < ActionController::Base
+    protect_from_forgery with: :exception
+    layout "memhealth/application"
+    
+    def index
+      @memory_hunter_enabled = MemHealth.configuration.enabled?
+
+      if @memory_hunter_enabled
+        @stats = MemHealth::Tracker.stats
+        @top_urls = MemHealth::Tracker.top_memory_urls
+        @max_memory_url = MemHealth::Tracker.max_memory_url
+      else
+        @stats = nil
+        @top_urls = []
+        @max_memory_url = nil
+      end
+    end
+
+    def clear
+      before_stats = MemHealth::Tracker.stats
+      MemHealth::Tracker.clear_all_data
+
+      redirect_to root_path, notice: "✅ All memory usage statistics have been reset successfully! Cleared #{before_stats[:stored_urls_count]} URLs and reset max memory diff from #{before_stats[:max_memory_diff]} MB to 0.0 MB."
+    rescue StandardError => e
+      redirect_to root_path, alert: "❌ Error clearing memory statistics: #{e.message}"
+    end
+
+    private
+
+    def authenticate_user!
+      # Override this method in your host app if you need authentication
+      # For example: authenticate_admin_user! or redirect_to login_path unless current_user&.admin?
+    end
+  end
+end

data/app/views/layouts/memhealth/application.html.erb

@@ -0,0 +1,213 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Memhealth</title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    
+    <style>
+      /* Base styles */
+      * {
+        box-sizing: border-box;
+      }
+      
+      body {
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, Arial, sans-serif;
+        line-height: 1.6;
+        margin: 0;
+        padding: 0;
+      }
+      
+      /* Padding utilities with better spacing */
+      .px-4 { padding-left: 1.5rem; padding-right: 1.5rem; }
+      .py-6 { padding-top: 2rem; padding-bottom: 2rem; }
+      .px-6 { padding-left: 2rem; padding-right: 2rem; }
+      .py-4 { padding-top: 1.25rem; padding-bottom: 1.25rem; }
+      .px-2 { padding-left: 0.75rem; padding-right: 0.75rem; }
+      .py-1 { padding-top: 0.5rem; padding-bottom: 0.5rem; }
+      .px-3 { padding-left: 1rem; padding-right: 1rem; }
+      .py-2 { padding-top: 0.75rem; padding-bottom: 0.75rem; }
+      .py-3 { padding-top: 1rem; padding-bottom: 1rem; }
+      .pb-6 { padding-bottom: 2rem; }
+      .p-6 { padding: 2rem; }
+      .p-4 { padding: 1.25rem; }
+      .p-3 { padding: 1rem; }
+      
+      .mb-6 { margin-bottom: 2rem; }
+      .mb-4 { margin-bottom: 1.5rem; }
+      .mb-2 { margin-bottom: 0.75rem; }
+      .mb-1 { margin-bottom: 0.5rem; }
+      .mt-4 { margin-top: 1.5rem; }
+      .mt-3 { margin-top: 1rem; }
+      .mt-1 { margin-top: 0.5rem; }
+      .mt-6 { margin-top: 2rem; }
+      .ml-4 { margin-left: 1.5rem; }
+      .ml-0 { margin-left: 0; }
+      
+      .bg-green-50 { background-color: rgb(240 253 244); }
+      .bg-red-50 { background-color: rgb(254 242 242); }
+      .bg-yellow-50 { background-color: rgb(254 252 232); }
+      .bg-white { background-color: rgb(255 255 255); }
+      .bg-blue-50 { background-color: rgb(239 246 255); }
+      .bg-purple-50 { background-color: rgb(250 245 255); }
+      .bg-gray-50 { background-color: rgb(249 250 251); }
+      .bg-gray-100 { background-color: rgb(243 244 246); }
+      .bg-gray-900 { background-color: rgb(17 24 39); }
+      .bg-red-100 { background-color: rgb(254 226 226); }
+      .bg-yellow-100 { background-color: rgb(254 249 195); }
+      .bg-green-100 { background-color: rgb(220 252 231); }
+      
+      .border { border-width: 1px; }
+      .border-2 { border-width: 2px; }
+      .border-green-200 { border-color: rgb(187 247 208); }
+      .border-red-200 { border-color: rgb(254 202 202); }
+      .border-yellow-200 { border-color: rgb(254 240 138); }
+      .border-red-100 { border-color: rgb(254 226 226); }
+      .border-yellow-100 { border-color: rgb(254 249 195); }
+      .border-red-400 { border-color: rgb(248 113 113); }
+      .border-b { border-bottom-width: 1px; }
+      .border-gray-200 { border-color: rgb(229 231 235); }
+      .divide-y > * + * { border-top-width: 1px; }
+      .divide-gray-200 > * + * { border-color: rgb(229 231 235); }
+      
+      .rounded-lg { border-radius: 0.75rem; }
+      .rounded-md { border-radius: 0.5rem; }
+      .rounded { border-radius: 0.375rem; }
+      .rounded-full { border-radius: 9999px; }
+      
+      .text-lg { font-size: 1.125rem; line-height: 1.75rem; }
+      .text-sm { font-size: 0.875rem; line-height: 1.25rem; }
+      .text-xs { font-size: 0.75rem; line-height: 1rem; }
+      .text-2xl { font-size: 1.5rem; line-height: 2rem; }
+      
+      .font-semibold { font-weight: 600; }
+      .font-medium { font-weight: 500; }
+      .font-bold { font-weight: 700; }
+      .font-mono { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace; }
+      
+      .text-green-800 { color: rgb(22 101 52); }
+      .text-green-700 { color: rgb(21 128 61); }
+      .text-red-800 { color: rgb(153 27 27); }
+      .text-gray-900 { color: rgb(17 24 39); }
+      .text-gray-600 { color: rgb(75 85 99); }
+      .text-gray-500 { color: rgb(107 114 128); }
+      .text-blue-600 { color: rgb(37 99 235); }
+      .text-blue-900 { color: rgb(30 58 138); }
+      .text-green-600 { color: rgb(22 163 74); }
+      .text-green-900 { color: rgb(20 83 45); }
+      .text-yellow-600 { color: rgb(202 138 4); }
+      .text-yellow-900 { color: rgb(113 63 18); }
+      .text-purple-600 { color: rgb(147 51 234); }
+      .text-purple-900 { color: rgb(88 28 135); }
+      .text-purple-500 { color: rgb(168 85 247); }
+      .text-yellow-800 { color: rgb(146 64 14); }
+      .text-gray-700 { color: rgb(55 65 81); }
+      .text-green-400 { color: rgb(74 222 128); }
+      .text-red-900 { color: rgb(127 29 29); }
+      .text-red-800 { color: rgb(153 27 27); }
+      
+      .shadow { box-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1); }
+      .shadow-sm { box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); }
+      
+      .flex { display: flex; }
+      .inline-flex { display: inline-flex; }
+      .grid { display: grid; }
+      .items-start { align-items: flex-start; }
+      .items-center { align-items: center; }
+      .justify-between { justify-content: space-between; }
+      .flex-1 { flex: 1 1 0%; }
+      .flex-shrink-0 { flex-shrink: 0; }
+      .gap-4 { gap: 1.5rem; }
+      .space-y-3 > * + * { margin-top: 1rem; }
+      .grid-cols-1 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
+      
+      .min-w-0 { min-width: 0px; }
+      .min-w-full { min-width: 100%; }
+      .max-w-xs { max-width: 20rem; }
+      .max-w-md { max-width: 28rem; }
+      
+      .truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .whitespace-nowrap { white-space: nowrap; }
+      .text-center { text-align: center; }
+      .text-left { text-align: left; }
+      .uppercase { text-transform: uppercase; }
+      .tracking-wider { letter-spacing: 0.05em; }
+      
+      .overflow-hidden { overflow: hidden; }
+      .cursor-pointer { cursor: pointer; }
+      
+      .hover\\:bg-red-100:hover { background-color: rgb(254 226 226); }
+      .focus\\:ring-2:focus { box-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color); }
+      .focus\\:ring-red-500:focus { --tw-ring-color: rgb(239 68 68); }
+      
+      /* Table styles */
+      table { border-collapse: collapse; width: 100%; }
+      th, td { text-align: left; }
+      th { font-weight: 500; }
+      
+      /* Compact table cell padding */
+      table th.px-6 { padding-left: 1rem !important; padding-right: 1rem !important; }
+      table td.px-6 { padding-left: 1rem !important; padding-right: 1rem !important; }
+      table th.py-3 { padding-top: 0.5rem !important; padding-bottom: 0.5rem !important; }
+      table td.py-4 { padding-top: 0.5rem !important; padding-bottom: 0.5rem !important; }
+      
+      /* Responsive grid */
+      @media (min-width: 768px) {
+        .md\\:grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
+      }
+      
+      /* Container styles */
+      .container { max-width: 1200px; margin: 0 auto; }
+      
+      /* Header styles */
+      .header { 
+        background: linear-gradient(135deg, #4f46e5 0%, #7c3aed 100%);
+        color: white;
+        padding: 1.5rem 0;
+        margin-bottom: 2rem;
+        box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+      }
+      
+      .header h1 {
+        font-size: 2.5rem;
+        font-weight: 700;
+        margin: 0;
+        letter-spacing: -0.025em;
+      }
+      
+      .header p {
+        margin: 1rem 0 0 0;
+        opacity: 0.95;
+        font-size: 1.125rem;
+        font-weight: 400;
+      }
+      
+    </style>
+  </head>
+
+  <body class="bg-gray-50">
+    <div class="header">
+      <div class="container px-6">
+        <h1>MemHealth</h1>
+      </div>
+    </div>
+    
+    
+    <div class="container">
+      <% if notice %>
+        <div class="bg-green-50 border border-green-200 rounded-lg p-4 mb-6">
+          <div class="text-sm text-green-800"><%= notice %></div>
+        </div>
+      <% end %>
+      
+      <% if alert %>
+        <div class="bg-red-50 border border-red-200 rounded-lg p-4 mb-6">
+          <div class="text-sm text-red-800"><%= alert %></div>
+        </div>
+      <% end %>
+      
+      <%= yield %>
+    </div>
+  </body>
+</html>

data/app/views/mem_health/dashboard/index.html.erb

@@ -0,0 +1,181 @@
+<div class="px-6 pb-6">
+  <% if @memory_hunter_enabled %>
+    <!-- Memory Hunter Enabled Status -->
+    <div class="bg-green-50 border border-green-200 rounded-lg px-6 py-4 mb-6">
+      <h3 class="text-lg font-semibold text-green-800 mb-2">✅ MemHealth Enabled</h3>
+      <p class="text-sm text-green-700">Memory profiling is active and tracking requests. To disable, set <code class="bg-green-100 px-1 rounded">ENV["MEM_HEALTH_ENABLED"]=false</code></p>
+    </div>
+
+    <!-- Highest Memory Usage URL - Prominent display -->
+    <% if @max_memory_url %>
+      <div class="bg-red-50 border border-red-200 rounded-lg px-6 py-6 mb-6">
+        <h3 class="text-lg font-semibold text-red-800 mb-4">🚨 Highest Memory Usage URL</h3>
+
+        <div class="bg-white rounded-md px-6 py-4 border border-red-100">
+          <!-- URL Section -->
+          <div class="mb-4">
+            <dt class="text-sm font-medium text-gray-500 mb-1">URL</dt>
+            <dd class="text-sm text-gray-900 font-mono bg-gray-100 px-2 py-1 rounded truncate ml-0">
+              <%= @max_memory_url["url"] %>
+            </dd>
+          </div>
+
+          <!-- Four column layout using flex -->
+          <div class="flex gap-4">
+            <% if @max_memory_url["ram_before"] && @max_memory_url["ram_after"] %>
+              <div class="flex-1 text-left">
+                <dt class="text-sm font-medium text-gray-500 mb-1">RAM Usage</dt>
+                <dd class="text-sm text-gray-600 ml-0">
+                  <%= @max_memory_url["ram_before"] %> MB → <%= @max_memory_url["ram_after"] %> MB
+                </dd>
+              </div>
+            <% end %>
+
+            <div class="flex-1 text-left">
+              <dt class="text-sm font-medium text-gray-500 mb-1">Recorded At</dt>
+              <dd class="text-sm text-gray-600 ml-0"><%= Time.parse(@max_memory_url["recorded_at"]).utc.strftime("%Y-%m-%d %H:%M") %></dd>
+            </div>
+
+            <% if @max_memory_url["account_id"].present? %>
+              <div class="flex-1 text-left">
+                <dt class="text-sm font-medium text-gray-500 mb-1">Account ID</dt>
+                <dd class="text-sm text-gray-600 ml-0"><%= @max_memory_url["account_id"] %></dd>
+              </div>
+            <% end %>
+
+            <div class="flex-1 text-left">
+              <div class="bg-red-100 border border-red-300 rounded-md px-4 py-3">
+                <dt class="text-sm font-medium text-red-700 mb-1">Memory Diff</dt>
+                <dd class="text-lg font-bold text-red-800 ml-0">
+                  <%= @max_memory_url["memory_diff"] %> MB
+                </dd>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    <% end %>
+
+    <!-- Stats summary card -->
+    <div class="bg-white rounded-lg shadow px-6 py-6 mb-6">
+      <h3 class="text-lg font-medium text-gray-900 mb-4">Memory Usage Statistics</h3>
+
+      <div class="flex gap-4">
+        <div class="bg-blue-50 p-4 rounded-md flex-1 text-left">
+          <dt class="text-sm font-medium text-blue-600">Max Memory Difference</dt>
+          <dd class="mt-1 text-2xl font-semibold text-blue-900 text-left ml-0"><%= @stats[:max_memory_diff] %> MB</dd>
+        </div>
+
+        <div class="bg-green-50 p-4 rounded-md flex-1 text-left">
+          <dt class="text-sm font-medium text-green-600">Stored URLs</dt>
+          <dd class="mt-1 text-2xl font-semibold text-green-900 text-left ml-0"><%= @stats[:stored_urls_count] %>/<%= @stats[:max_stored_urls] %></dd>
+        </div>
+
+        <div class="bg-yellow-50 p-4 rounded-md flex-1 text-left">
+          <dt class="text-sm font-medium text-yellow-600">Requests Tracked</dt>
+          <dd class="mt-1 text-2xl font-semibold text-yellow-900 text-left ml-0"><%= @stats[:tracked_requests_count] %></dd>
+        </div>
+
+        <div class="bg-purple-50 p-4 rounded-md flex-1 text-left">
+          <dt class="text-sm font-medium text-purple-600">Total Requests on current dyno/Rails instance</dt>
+          <dd class="mt-1 text-2xl font-semibold text-purple-900 text-left ml-0"><%= @stats[:total_requests_count] %></dd>
+          <% if @stats[:skipped_requests_count] > 0 %>
+            <p class="text-xs text-purple-500 mt-1"><%= @stats[:skipped_requests_count] %> skipped</p>
+          <% end %>
+        </div>
+      </div>
+    </div>
+
+    <!-- Top URLs table -->
+    <% if @top_urls.any? %>
+      <div class="bg-white rounded-lg shadow overflow-hidden">
+        <div class="px-6 py-4 border-b border-gray-200">
+          <h3 class="text-lg font-medium text-gray-900">Top <%= MemHealth.configuration.max_stored_urls %> URLs by Memory Usage</h3>
+          <p class="text-sm text-gray-600 mt-1">URLs ordered by memory difference (highest first) - maximum <%= MemHealth.configuration.max_stored_urls %> URLs stored</p>
+        </div>
+
+        <table class="min-w-full divide-y divide-gray-200">
+          <thead class="bg-gray-50">
+            <tr>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Memory Diff</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">RAM Before</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">RAM After</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">URL</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Account ID</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Recorded At</th>
+            </tr>
+          </thead>
+
+          <tbody class="bg-white divide-y divide-gray-200">
+            <% @top_urls.each do |url_data| %>
+              <tr>
+                <td class="px-6 py-4 whitespace-nowrap">
+                  <% 
+                    memory_color = if url_data["memory_diff"] > 10
+                      "bg-red-100 text-red-800"
+                    elsif url_data["memory_diff"] > 5
+                      "bg-yellow-100 text-yellow-800"
+                    else
+                      "bg-green-100 text-green-800"
+                    end
+                  %>
+                  <span class="inline-flex px-2 py-1 text-xs font-semibold rounded-full <%= memory_color %>">
+                    <%= url_data["memory_diff"] %> MB
+                  </span>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                  <%= url_data["ram_before"] ? "#{url_data["ram_before"]} MB" : "/" %>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                  <%= url_data["ram_after"] ? "#{url_data["ram_after"]} MB" : "/" %>
+                </td>
+                <td class="px-6 py-4 text-sm text-gray-900">
+                  <div class="max-w-xs truncate">
+                    <code class="bg-gray-100 px-2 py-1 rounded text-xs"><%= url_data["url"] %></code>
+                  </div>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                  <%= url_data["account_id"].present? ? url_data["account_id"] : "/" %>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                  <%= Time.parse(url_data["recorded_at"]).utc.strftime("%Y-%m-%d %H:%M") %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% else %>
+      <div class="bg-white rounded-lg shadow px-6 py-4 text-center">
+        <h3 class="text-lg font-medium text-gray-900 mb-2">No URLs Tracked Yet</h3>
+        <p class="text-gray-600">No URLs have been recorded yet.</p>
+        <p class="text-sm text-gray-500 mt-2">Memory tracking will begin after the first <%= MemHealth.configuration.skip_requests %> requests to your application.</p>
+      </div>
+    <% end %>
+
+    <!-- Action buttons -->
+    <div class="mt-6 space-y-3">
+      <div class="flex gap-4">
+        <%= form_with url: clear_path, method: :post, local: true, class: "inline" do |form| %>
+          <%= form.button "🗑️ Reset Stats",
+                type: "submit",
+                onclick: "return confirm('Are you sure you want to reset all memory usage statistics? This will clear all data including max memory difference and URLs.')",
+                class: "inline-flex items-center px-6 py-3 border-2 border-red-400 text-sm font-semibold rounded-md text-red-800 bg-red-50 hover:bg-red-100 focus:ring-2 focus:ring-red-500 shadow-sm cursor-pointer" %>
+        <% end %>
+      </div>
+    </div>
+  <% else %>
+    <!-- Memory Hunter Disabled Status -->
+    <div class="bg-yellow-50 border border-yellow-200 rounded-lg p-6 mb-6">
+      <h3 class="text-lg font-semibold text-yellow-800 mb-4">⚠️ MemHealth Disabled</h3>
+
+      <div class="bg-white rounded-md p-4 border border-yellow-100">
+        <p class="text-sm text-gray-700 mb-3">Memory profiling is currently disabled. To enable memory growth tracking:</p>
+
+        <div class="bg-gray-900 text-green-400 p-3 rounded font-mono text-sm mb-3">
+          Set ENV['MEM_HEALTH_ENABLED'] = true
+        </div>
+      </div>
+    </div>
+  <% end %>
+</div>

data/config/routes.rb

@@ -0,0 +1,4 @@
+MemHealth::Engine.routes.draw do
+  root "dashboard#index"
+  post "/clear", to: "dashboard#clear", as: :clear
+end

data/lib/mem_health/configuration.rb

@@ -0,0 +1,32 @@
+require "redis"
+
+module MemHealth
+  class Configuration
+    attr_accessor :enabled,
+      :skip_requests,
+      :memory_threshold_mb,
+      :ram_before_threshold_mb,
+      :max_stored_urls,
+      :redis_url,
+      :redis_key_prefix
+
+    def initialize
+      @enabled = ENV.fetch("MEM_HEALTH_ENABLED", "false") == "true"
+      @skip_requests = ENV.fetch("MEM_HEALTH_SKIP_REQUESTS", "10").to_i
+      @memory_threshold_mb = ENV.fetch("MEM_HEALTH_MEMORY_THRESHOLD_MB", "1").to_i
+      @ram_before_threshold_mb = ENV.fetch("MEM_HEALTH_RAM_BEFORE_THRESHOLD", "0").to_i
+      @max_stored_urls = ENV.fetch("MEM_HEALTH_MAX_STORED_URLS", "20").to_i
+      redis_env_key = ENV.fetch("MEM_HEALTH_REDIS_KEY", "REDIS_URL")
+      @redis_url = ENV.fetch(redis_env_key, "redis://localhost:6379/0")
+      @redis_key_prefix = "memhealth"
+    end
+
+    def enabled?
+      @enabled
+    end
+
+    def redis
+      @redis ||= Redis.new(url: redis_url)
+    end
+  end
+end

data/lib/mem_health/engine.rb

@@ -0,0 +1,40 @@
+module MemHealth
+  class Engine < ::Rails::Engine
+    isolate_namespace MemHealth
+    
+    # Set specific autoload paths and exclude others
+    config.autoload_paths += %W(#{root}/app/controllers #{root}/app/views)
+    config.eager_load_paths += %W(#{root}/app/controllers #{root}/app/views)
+    
+    # Configure Zeitwerk to ignore config and lib directories
+    initializer "mem_health.zeitwerk_ignore", before: :set_autoload_paths do
+      config.autoload_paths.delete("#{root}/config")
+      config.autoload_paths.delete("#{root}/lib")
+      
+      if defined?(Rails.autoloaders)
+        Rails.autoloaders.main.ignore("#{root}/config")
+        Rails.autoloaders.main.ignore("#{root}/lib")
+      end
+    end
+    
+    config.generators do |g|
+      g.test_framework :rspec
+    end
+
+    initializer "mem_health.load_controllers", after: :load_config_initializers do
+      # Manually require the controller to ensure it loads
+      begin
+        require File.join(root, "app", "controllers", "mem_health", "dashboard_controller")
+      rescue => e
+        Rails.logger.warn "Could not load MemHealth controller: #{e.message}" if defined?(Rails.logger)
+      end
+    end
+
+    initializer "mem_health.middleware", before: :build_middleware_stack do |app|
+      if MemHealth.configuration.enabled?
+        require "get_process_mem"
+        app.config.middleware.use MemHealth::Middleware
+      end
+    end
+  end
+end

data/lib/mem_health/middleware.rb

@@ -0,0 +1,154 @@
+require "get_process_mem"
+
+module MemHealth
+  class Middleware
+    @@request_count = 0
+    @@skipped_requests_count = 0
+
+    def self.redis_tracked_requests_key
+      "#{MemHealth.configuration.redis_key_prefix}:tracked_requests"
+    end
+
+    def initialize(app)
+      @app = app
+    end
+
+    def call(env)
+      @@request_count += 1
+
+      before = GetProcessMem.new.mb
+      status, headers, response = @app.call(env)
+      after = GetProcessMem.new.mb
+
+      memory_diff = (after - before).round(2)
+      request_url = build_request_url(env)
+      account_info = extract_account_info(env)
+
+      # Skip the first few requests as they have large memory jumps due to class loading
+      if @@request_count > config.skip_requests
+        redis.incr(redis_tracked_requests_key)
+        should_track = memory_diff > config.memory_threshold_mb && before.round(2) > config.ram_before_threshold_mb
+        track_memory_usage(memory_diff, request_url, before.round(2), after.round(2), account_info) if should_track
+      else
+        @@skipped_requests_count += 1
+      end
+
+      [status, headers, response]
+    end
+
+    def self.reset_data
+      @@request_count = 0
+      @@skipped_requests_count = 0
+      MemHealth.configuration.redis.del(redis_tracked_requests_key)
+    end
+
+    def self.tracked_requests_count
+      MemHealth.configuration.redis.get(redis_tracked_requests_key)&.to_i || 0
+    end
+
+    def self.total_requests_count
+      @@request_count
+    end
+
+    def self.skipped_requests_count
+      @@skipped_requests_count
+    end
+
+    private
+
+    def config
+      MemHealth.configuration
+    end
+
+    def redis
+      config.redis
+    end
+
+    def redis_max_diff_key
+      "#{config.redis_key_prefix}:max_diff"
+    end
+
+    def redis_max_diff_url_key
+      "#{config.redis_key_prefix}:max_diff_url"
+    end
+
+    def redis_high_usage_urls_key
+      "#{config.redis_key_prefix}:high_usage_urls"
+    end
+
+    def redis_tracked_requests_key
+      self.class.redis_tracked_requests_key
+    end
+
+    def track_memory_usage(memory_diff, request_url, ram_before, ram_after, account_info = {})
+      # Update max memory diff seen so far
+      current_max = redis.get(redis_max_diff_key)&.to_f || 0.0
+      if memory_diff > current_max
+        redis.set(redis_max_diff_key, memory_diff)
+
+        # Store the URL data that caused the maximum memory usage
+        max_url_data = {
+          url: request_url,
+          memory_diff: memory_diff,
+          ram_before: ram_before,
+          ram_after: ram_after,
+          timestamp: Time.current.to_i,
+          recorded_at: Time.current.iso8601
+        }.merge(account_info)
+        redis.set(redis_max_diff_url_key, max_url_data.to_json)
+      end
+
+      # Store all URLs
+      timestamp = Time.current.to_i
+      url_data = {
+        url: request_url,
+        memory_diff: memory_diff,
+        ram_before: ram_before,
+        ram_after: ram_after,
+        timestamp: timestamp,
+        recorded_at: Time.current.iso8601
+      }.merge(account_info)
+
+      # Add URL to sorted set (score = memory_diff for DESC ordering)
+      redis.zadd(redis_high_usage_urls_key, memory_diff, url_data.to_json)
+
+      # Keep only top N URLs by removing lowest scores
+      current_count = redis.zcard(redis_high_usage_urls_key)
+      if current_count > config.max_stored_urls
+        # Remove the lowest scoring URLs (keep top max_stored_urls)
+        redis.zremrangebyrank(redis_high_usage_urls_key, 0, current_count - config.max_stored_urls - 1)
+      end
+    end
+
+    def build_request_url(env)
+      request = Rack::Request.new(env)
+      url = "#{request.request_method} #{request.fullpath}"
+
+      # Truncate very long URLs
+      (url.length > 600) ? "#{url[0..650]}..." : url
+    end
+
+    def extract_account_info(env)
+      account_info = {}
+
+      begin
+        # Try to get account info from various sources
+        if defined?(ActsAsTenant) && ActsAsTenant.current_tenant
+          account = ActsAsTenant.current_tenant
+          account_info[:account_id] = account.id
+        elsif env["warden"]&.user&.respond_to?(:account)
+          # Try to get from authenticated user
+          account = env["warden"].user.account
+          account_info[:account_id] = account.id
+        elsif env["HTTP_X_ACCOUNT_ID"]
+          # Fallback to header if available
+          account_info[:account_id] = env["HTTP_X_ACCOUNT_ID"]
+        end
+      rescue StandardError => _e
+        # Silently fail if account extraction fails
+      end
+
+      account_info
+    end
+  end
+end

data/lib/mem_health/tracker.rb

@@ -0,0 +1,104 @@
+module MemHealth
+  class Tracker
+    class << self
+      # Get the maximum memory difference recorded
+      def max_memory_diff
+        redis.get(redis_max_diff_key)&.to_f || 0.0
+      end
+
+      # Get all stored URLs, ordered by memory usage (highest first)
+      def top_memory_urls(limit: config.max_stored_urls)
+        redis.zrevrange(redis_high_usage_urls_key, 0, limit - 1, with_scores: true).map do |json_data, score|
+          data = JSON.parse(json_data)
+          data.merge("memory_diff" => score)
+        end
+      end
+
+      # Alias for backward compatibility
+      alias_method :high_usage_urls, :top_memory_urls
+
+      # Get URLs that used more than a specific threshold
+      def urls_above_threshold(threshold_mb)
+        redis.zrangebyscore(redis_high_usage_urls_key, threshold_mb, "+inf", with_scores: true).map do |json_data, score|
+          data = JSON.parse(json_data)
+          data.merge("memory_diff" => score)
+        end
+      end
+
+      # Get the URL with the highest memory usage (the one that set the max diff)
+      def max_memory_url
+        json_data = redis.get(redis_max_diff_url_key)
+        return nil if json_data.nil?
+
+        JSON.parse(json_data)
+      end
+
+      # Clear all memory tracking data
+      def clear_all_data
+        redis.del(redis_max_diff_key, redis_max_diff_url_key, redis_high_usage_urls_key)
+        MemHealth::Middleware.reset_data
+      end
+
+      # Get stats summary
+      def stats
+        max_diff = max_memory_diff
+        stored_urls_count = redis.zcard(redis_high_usage_urls_key)
+        tracked_count = MemHealth::Middleware.tracked_requests_count
+        total_count = MemHealth::Middleware.total_requests_count
+        skipped_count = MemHealth::Middleware.skipped_requests_count
+
+        {
+          max_memory_diff: max_diff,
+          stored_urls_count: stored_urls_count,
+          max_stored_urls: config.max_stored_urls,
+          tracked_requests_count: tracked_count,
+          total_requests_count: total_count,
+          skipped_requests_count: skipped_count,
+          requests_tracked: "#{tracked_count} requests tracked (#{skipped_count} skipped) out of #{total_count} total requests"
+        }
+      end
+
+      # Pretty print stats for console use
+      def print_stats
+        stats_data = stats
+        puts "\n=== Memory Usage Stats ==="
+        puts "Max memory difference: #{stats_data[:max_memory_diff]} MB"
+        puts "Stored URLs: #{stats_data[:stored_urls_count]}/#{stats_data[:max_stored_urls]}"
+        puts "Tracking: #{stats_data[:requests_tracked]}"
+
+        if stats_data[:stored_urls_count] > 0
+          puts "\nTop 10 memory usage URLs:"
+          top_memory_urls(limit: 10).each_with_index do |url_data, index|
+            if url_data["ram_before"] && url_data["ram_after"]
+              puts "#{index + 1}. #{url_data["memory_diff"]} MB (#{url_data["ram_before"]} → #{url_data["ram_after"]} MB) - #{url_data["url"]} (#{url_data["recorded_at"]})"
+            else
+              puts "#{index + 1}. #{url_data["memory_diff"]} MB - #{url_data["url"]} (#{url_data["recorded_at"]})"
+            end
+          end
+        end
+      end
+
+      private
+
+      def config
+        MemHealth.configuration
+      end
+
+      def redis
+        config.redis
+      end
+
+      def redis_max_diff_key
+        "#{config.redis_key_prefix}:max_diff"
+      end
+
+      def redis_max_diff_url_key
+        "#{config.redis_key_prefix}:max_diff_url"
+      end
+
+      def redis_high_usage_urls_key
+        "#{config.redis_key_prefix}:high_usage_urls"
+      end
+    end
+  end
+end

data/lib/mem_health/version.rb

@@ -0,0 +1,3 @@
+module MemHealth
+  VERSION = "0.1.0"
+end

data/lib/memhealth.rb

@@ -0,0 +1,20 @@
+require "mem_health/version"
+require "mem_health/configuration"
+require "mem_health/middleware"
+require "mem_health/tracker"
+require "mem_health/engine"
+
+module MemHealth
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+  end
+end
+

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: memhealth
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Klemen Nagode
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: get_process_mem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Rails engine for monitoring memory health and detecting growth patterns
+  in production applications
+email:
+- klemen@topkey.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- app/controllers/mem_health/dashboard_controller.rb
+- app/views/layouts/memhealth/application.html.erb
+- app/views/mem_health/dashboard/index.html.erb
+- config/routes.rb
+- lib/mem_health/configuration.rb
+- lib/mem_health/engine.rb
+- lib/mem_health/middleware.rb
+- lib/mem_health/tracker.rb
+- lib/mem_health/version.rb
+- lib/memhealth.rb
+homepage: https://github.com/topkeyhq/memhealth
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/topkeyhq/memhealth
+  source_code_uri: https://github.com/topkeyhq/memhealth
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Rails memory health monitoring and tracking
+test_files: []