dead_bro_hub 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8a1d1f1c9243fa53f0ca84fc3a2f2cbf71d440b67ac3b8817c025c5194bc7b1d
+  data.tar.gz: 16a6af3fec491613e9a2e68a933ecc064c4433abc5f98dd7ebf5f7204b92953c
+SHA512:
+  metadata.gz: 1bfb1606b64382bd09fe76b46e6338b601fcf81e2468a458be9045c8c9855594126a9e0cae4bc5a9ffebf2481aaa9fa0bcf07b45c705a4c0ff1aeb1fcf062948
+  data.tar.gz: 59c0d406169a94ca953bbdf9972a47501ce12311e0e872c14efe7d2c4a0535e31b9731ebb85ebb9a720fef937c70d3e215be89e5d5070bd52f514282fdca75df

data/MIT-LICENSE

@@ -0,0 +1,14 @@
+Copyright Ruby Dev SRL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,76 @@
+# DeadBroHub
+
+DeadBro's view of your app, inside the [BroHub](https://github.com/rubydevro/bro_hub) dashboard, next to EnvBro and SafeBro.
+
+It reads from DeadBro with the **API key the `dead_bro` gem already uses**, so there is nothing new to configure except who may look.
+
+| Page | Shows |
+| --- | --- |
+| Overview | Requests, error rate, throughput and p95 per hour (24h), slowest endpoints, latest deploy |
+| Endpoints | Controller actions and jobs ranked by mean time, error rate, slow, N+1, CPU (1h / 24h / 7d / 30d) |
+| Errors | Distinct errors by last seen; detail with affected endpoints and recent occurrences |
+| SQL queries | Normalized statements ranked by total time, runs, p95, max; search by table or keyword |
+| Findings | What DeadBro keeps tracking, ranked by cost |
+| Deploys | Revisions and the errors since each |
+| Status | The gem in *this* process (on, sending, circuit breaker, dropped payloads) next to the settings DeadBro hands it |
+
+Rails 7.1+, Ruby 3.2+ (`dead_bro` itself still runs on 2.7+; this gem is the part that needs a newer Ruby). No database, no JavaScript.
+
+## Install
+
+```ruby
+gem "dead_bro_hub"
+```
+
+```sh
+bin/rails generate dead_bro_hub:install
+```
+
+This sets up BroHub if it isn't yet (mount point, the other Bro gems) and adds `config/initializers/dead_bro_hub.rb`.
+Then say who may look. **Nobody can until you do**: the pages show SQL, exception messages and request paths.
+
+```ruby
+DeadBroHub.configure do |config|
+  config.can_view = ->(user) { user&.admin? }
+end
+```
+
+Visit `/bro_hub/dead_bro_hub`.
+
+## Configuration
+
+```ruby
+DeadBroHub.configure do |config|
+  config.can_view = ->(user) { ... }                                  # required, default denies everyone
+  config.current_user = ->(controller) { controller.current_user }    # default: BroHub.config.current_user
+  config.parent_controller = "::ApplicationController"
+  config.cache_ttl = 30                                               # seconds in Rails.cache, 0 = off
+  config.api_key = ENV["..."]                                         # default: DeadBro.configuration.api_key
+  config.base_url = "https://www.deadbro.com"                         # default: what the dead_bro client sends to
+end
+```
+
+## How it works
+
+Each page makes one request to its own endpoint, `GET /api/v1/hub/<page>` on DeadBro, with
+`Authorization: Bearer <app api key>`. The key resolves to exactly one application, so a leaked key reads that app's
+data and nothing else of the account. Successful responses are cached briefly in `Rails.cache` (the key is hashed into
+the cache key, never stored). If DeadBro is unreachable, slow or answers 5xx, the page renders a notice rather than failing.
+
+| Page | Endpoint |
+| --- | --- |
+| Overview | `overview` |
+| Endpoints | `endpoints?window=&sort=` |
+| Errors | `errors?offset=&limit=`, `errors/:id` |
+| SQL queries | `queries?window=&sort=&search=&offset=&limit=` |
+| Findings | `findings?status=` |
+| Deploys | `deploys` |
+| Status | `settings` (plus the gem's in-memory state, read locally) |
+
+SQL is returned normalized only; the sample statement with real values never leaves DeadBro.
+
+## Tests
+
+```sh
+bundle exec rake test
+```

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/setup"
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+end
+
+task default: :test

data/app/controllers/dead_bro_hub/application_controller.rb

@@ -0,0 +1,58 @@
+module DeadBroHub
+  class ApplicationController < DeadBroHub.config.parent_controller.constantize
+    include BroHub::Layout
+    bro_hub_section :dead_bro_hub
+
+    protect_from_forgery with: :exception
+
+    before_action :dead_bro_hub_authorize
+    before_action :dead_bro_hub_no_store
+
+    helper_method :dead_bro_hub_user
+
+    rescue_from DeadBroHub::Forbidden, with: :dead_bro_hub_forbidden
+
+    private
+      def dead_bro_hub_user
+        return @dead_bro_hub_user if defined?(@dead_bro_hub_user)
+        @dead_bro_hub_user = DeadBroHub.config.current_user.call(self)
+      end
+
+      # BroHub shows this name in the top bar, so it must be the same person DeadBroHub authorizes.
+      def bro_hub_user
+        dead_bro_hub_user
+      end
+
+      def dead_bro_hub_authorize
+        raise DeadBroHub::Forbidden unless DeadBroHub.config.allows?(dead_bro_hub_user)
+      end
+
+      # Pages show SQL, exception messages and paths: keep them out of browser and proxy caches.
+      def dead_bro_hub_no_store
+        response.headers["Cache-Control"] = "no-store"
+        response.headers["Pragma"] = "no-cache"
+      end
+
+      def dead_bro_hub_forbidden
+        render "dead_bro_hub/shared/forbidden", status: :forbidden
+      end
+
+      def dead_bro_hub_api
+        DeadBroHub.api
+      end
+
+      # Runs the block (a call to DeadBro) and returns its data. When DeadBro can't answer, @error is set
+      # and the page renders a notice instead of failing: the hub must not 500 because DeadBro is down.
+      def dead_bro_hub_fetch
+        yield
+      rescue DeadBroHub::Api::Error => error
+        @error = error
+        nil
+      end
+
+      # Only these reach DeadBro; everything else in the query string is dropped.
+      def dead_bro_hub_params(*keys)
+        params.permit(*keys).to_h.symbolize_keys
+      end
+  end
+end

data/app/controllers/dead_bro_hub/deploys_controller.rb

@@ -0,0 +1,7 @@
+module DeadBroHub
+  class DeploysController < ApplicationController
+    def index
+      @data = dead_bro_hub_fetch { dead_bro_hub_api.deploys }
+    end
+  end
+end

data/app/controllers/dead_bro_hub/endpoints_controller.rb

@@ -0,0 +1,8 @@
+module DeadBroHub
+  class EndpointsController < ApplicationController
+    def index
+      @filters = dead_bro_hub_params(:window, :sort)
+      @data = dead_bro_hub_fetch { dead_bro_hub_api.endpoints(@filters) }
+    end
+  end
+end

data/app/controllers/dead_bro_hub/errors_controller.rb

@@ -0,0 +1,15 @@
+module DeadBroHub
+  class ErrorsController < ApplicationController
+    PER_PAGE = 25
+
+    def index
+      @offset = [ params[:offset].to_i, 0 ].max
+      @data = dead_bro_hub_fetch { dead_bro_hub_api.errors(offset: @offset, limit: PER_PAGE) }
+    end
+
+    def show
+      @error_issue = dead_bro_hub_fetch { dead_bro_hub_api.error(params[:id]) }
+      render :not_found, status: :not_found if @error&.kind == :not_found
+    end
+  end
+end

data/app/controllers/dead_bro_hub/findings_controller.rb

@@ -0,0 +1,8 @@
+module DeadBroHub
+  class FindingsController < ApplicationController
+    def index
+      @filters = dead_bro_hub_params(:status)
+      @data = dead_bro_hub_fetch { dead_bro_hub_api.findings(@filters) }
+    end
+  end
+end

data/app/controllers/dead_bro_hub/overview_controller.rb

@@ -0,0 +1,7 @@
+module DeadBroHub
+  class OverviewController < ApplicationController
+    def show
+      @overview = dead_bro_hub_fetch { dead_bro_hub_api.overview }
+    end
+  end
+end

data/app/controllers/dead_bro_hub/queries_controller.rb

@@ -0,0 +1,11 @@
+module DeadBroHub
+  class QueriesController < ApplicationController
+    PER_PAGE = 25
+
+    def index
+      @filters = dead_bro_hub_params(:window, :sort, :search)
+      @offset = [ params[:offset].to_i, 0 ].max
+      @data = dead_bro_hub_fetch { dead_bro_hub_api.queries(@filters.merge(offset: @offset, limit: PER_PAGE)) }
+    end
+  end
+end

data/app/controllers/dead_bro_hub/status_controller.rb

@@ -0,0 +1,9 @@
+module DeadBroHub
+  class StatusController < ApplicationController
+    # Two halves: what the gem has in memory here, and what DeadBro tells it to do.
+    def show
+      @local = LocalStatus.snapshot
+      @remote = dead_bro_hub_fetch { dead_bro_hub_api.settings }
+    end
+  end
+end

data/app/helpers/dead_bro_hub/application_helper.rb

@@ -0,0 +1,97 @@
+module DeadBroHub
+  module ApplicationHelper
+    # DeadBroHub's additions to BroHub's styles, once per page (and nonce-friendly).
+    def dead_bro_hub_styles
+      content_for(:head, render("dead_bro_hub/shared/page_styles")) unless content_for?(:head)
+      nil
+    end
+
+    def dbh_int(value)
+      value.nil? ? "-" : number_with_delimiter(value)
+    end
+
+    def dbh_ms(value)
+      return "-" if value.nil?
+
+      value = value.to_f
+      value >= 1000 ? "#{(value / 1000).round(2)} s" : "#{value.round(value < 10 ? 2 : 1)} ms"
+    end
+
+    def dbh_pct(value)
+      value.nil? ? "-" : "#{value}%"
+    end
+
+    # ISO8601 string from the API, or a Time/epoch from the gem's own state -> "5 minutes ago", exact time on hover.
+    def dbh_time(value)
+      time = case value
+      when nil, "" then nil
+      when Time, ActiveSupport::TimeWithZone then value
+      when Numeric then Time.at(value)
+      else Time.zone.parse(value.to_s)
+      end
+      return content_tag(:span, "-", class: "bh-cell-muted") unless time
+
+      content_tag(:span, "#{time_ago_in_words(time)} ago", title: time.utc.iso8601)
+    end
+
+    def dbh_error_rate_tone(rate)
+      rate = rate.to_f
+      rate >= 5 ? :red : (rate >= 1 ? :amber : :green)
+    end
+
+    def dbh_tag(text, style = nil)
+      content_tag(:span, text, class: [ "bh-tag", style ].compact_blank)
+    end
+
+    # What went wrong reaching DeadBro, in words that say what to do about it.
+    def dbh_error_notice(error)
+      advice = case error.kind
+      when :not_configured then "Configure the dead_bro gem with this app's API key."
+      when :unauthorized then "Check the API key in the dead_bro configuration: DeadBro does not recognise it."
+      when :unavailable then "DeadBro could not read its data just now. Try again in a minute."
+      when :network then "This server could not reach DeadBro. Check the network and DeadBroHub's base_url."
+      else "Try again in a minute."
+      end
+      content_tag(:div, class: "bh-alert bh-alert-error") { safe_join([ content_tag(:strong, error.message), " ", advice ]) }
+    end
+
+    # Tiny bar chart: values -> inline SVG, one bar per value, scaled to the largest.
+    def dbh_bars(values, tone: "var(--bh-violet)", width: 420, height: 56)
+      values = Array(values).map(&:to_f)
+      return content_tag(:div, "No data in this window", class: "bh-cell-muted") if values.empty? || values.max <= 0
+
+      gap = 2
+      bar = [ (width - gap * (values.size - 1)).fdiv(values.size), 1 ].max
+      rects = values.each_with_index.map do |value, i|
+        h = [ value / values.max * height, 1 ].max
+        tag.rect(x: (i * (bar + gap)).round(2), y: (height - h).round(2), width: bar.round(2), height: h.round(2), fill: tone)
+      end
+      tag.svg(safe_join(rects), viewBox: "0 0 #{width} #{height}", width: "100%", height: height, preserveAspectRatio: "none",
+        role: "img", class: "dbh-bars")
+    end
+
+    # A row of chips linking to the same page with one param changed.
+    def dbh_chips(param, options, current, label_for: nil)
+      links = options.map do |option|
+        link_to((label_for ? label_for.call(option) : option), url_for(request.query_parameters.symbolize_keys.merge(param => option, offset: nil)),
+          class: [ "bh-chip", ("is-on" if option.to_s == current.to_s) ])
+      end
+      safe_join(links, " ")
+    end
+
+    def dbh_pager(rows_shown, per_page, offset)
+      links = []
+      links << link_to("← Newer", url_for(request.query_parameters.symbolize_keys.merge(offset: [ offset - per_page, 0 ].max)), class: "bh-link-quiet") if offset.positive?
+      links << link_to("Older →", url_for(request.query_parameters.symbolize_keys.merge(offset: offset + per_page)), class: "bh-link-quiet") if rows_shown >= per_page
+      return if links.empty?
+
+      content_tag(:div, class: "bh-pager") { safe_join([ content_tag(:span, "#{offset + 1}-#{offset + rows_shown}", class: "bh-meta"), *links ]) }
+    end
+
+    def dbh_yes_no(value, yes: "on", no: "off")
+      return dbh_tag("unknown") if value.nil?
+
+      value ? dbh_tag(yes, "is-green") : dbh_tag(no, "is-amber")
+    end
+  end
+end

data/app/views/dead_bro_hub/deploys/index.html.erb

@@ -0,0 +1,21 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Deploys" %>
+<%= bro_hub_hero eyebrow: "Releases", title: "Deploys", tone: :violet, lead: "Detected from the revision your app reports. Errors are counted per deploy." %>
+<% if @error %>
+  <%= dbh_error_notice(@error) %>
+<% elsif @data["deploys"].empty? %>
+  <div class="bh-table-wrap"><div class="bh-empty">No deploys recorded yet.</div></div>
+<% else %>
+  <div class="bh-table-wrap"><div class="bh-table dbh-cols-deploys">
+    <div class="bh-row is-head"><span>Revision</span><span>Deployed</span><span>State</span><span>Errors</span><span>Per hour</span></div>
+    <% @data["deploys"].each do |d| %>
+      <div class="bh-row">
+        <span class="bh-cell-strong"><code><%= truncate(d["revision"].to_s, length: 24) %></code></span>
+        <span class="bh-cell-muted"><%= dbh_time(d["deployed_at"]) %></span>
+        <span><%= d["finished"] ? dbh_tag("replaced") : dbh_tag("live", "is-green") %></span>
+        <span class="<%= "bh-tone-red" if d["error_count"].to_i.positive? %>"><%= dbh_int(d["error_count"]) %></span>
+        <span class="bh-cell-muted"><%= d["errors_per_hour"] %></span>
+      </div>
+    <% end %>
+  </div></div>
+<% end %>

data/app/views/dead_bro_hub/endpoints/index.html.erb

@@ -0,0 +1,27 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Endpoints" %>
+<%= bro_hub_hero eyebrow: "Performance", title: "Endpoints", tone: :violet,
+      lead: "Controller actions and jobs, ranked. Window and ranking are yours to change." %>
+<div class="bh-filters">
+  <span><%= dbh_chips(:window, %w[1h 24h 7d 30d], @data&.fetch("window", nil) || "24h") %></span>
+  <span><%= dbh_chips(:sort, %w[mean_duration error_rate slow_count n_plus_one cpu_heavy], @data&.fetch("sort", nil) || "mean_duration", label_for: ->(s) { s.humanize.downcase }) %></span>
+</div>
+<% if @error %>
+  <%= dbh_error_notice(@error) %>
+<% elsif @data["endpoints"].empty? %>
+  <div class="bh-table-wrap"><div class="bh-empty">No requests in this window.</div></div>
+<% else %>
+  <div class="bh-table-wrap"><div class="bh-table dbh-cols-endpoints">
+    <div class="bh-row is-head"><span>Endpoint</span><span>Requests</span><span>Mean</span><span>Errors</span><span>Slow</span><span>N+1</span></div>
+    <% @data["endpoints"].each do |e| %>
+      <div class="bh-row">
+        <span class="bh-cell-strong"><%= e["name"] %></span>
+        <span><%= dbh_int(e["requests"]) %></span>
+        <span><%= dbh_ms(e["mean_duration_ms"]) %></span>
+        <span class="<%= "bh-tone-#{dbh_error_rate_tone(e["error_rate_pct"])}" %>"><%= dbh_pct(e["error_rate_pct"]) %></span>
+        <span class="bh-cell-muted"><%= dbh_int(e["slow_count"]) %></span>
+        <span class="bh-cell-muted"><%= dbh_int(e["n_plus_one_count"]) %></span>
+      </div>
+    <% end %>
+  </div></div>
+<% end %>

data/app/views/dead_bro_hub/errors/index.html.erb

@@ -0,0 +1,22 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Errors" %>
+<%= bro_hub_hero eyebrow: "Exceptions", title: (@data ? dbh_int(@data["total"]) : "-"), subtitle: "distinct errors", tone: :red,
+      lead: "Grouped by fingerprint, most recently seen first." %>
+<% if @error %>
+  <%= dbh_error_notice(@error) %>
+<% elsif @data["errors"].empty? %>
+  <div class="bh-table-wrap"><div class="bh-empty">No errors recorded. Nice.</div></div>
+<% else %>
+  <div class="bh-table-wrap"><div class="bh-table dbh-cols-errors">
+    <div class="bh-row is-head"><span>Error</span><span>Count</span><span>First seen</span><span>Last seen</span></div>
+    <% @data["errors"].each do |e| %>
+      <%= link_to error_path(e["id"]), class: "bh-row" do %>
+        <span><span class="bh-cell-strong"><%= e["exception_class"] || "Error" %></span><br><span class="bh-cell-muted"><%= truncate(e["message"].to_s, length: 140) %></span></span>
+        <span><%= dbh_int(e["occurrences"]) %></span>
+        <span class="bh-cell-muted"><%= dbh_time(e["first_seen_at"]) %></span>
+        <span class="bh-cell-muted"><%= dbh_time(e["last_seen_at"]) %></span>
+      <% end %>
+    <% end %>
+  </div></div>
+  <%= dbh_pager(@data["errors"].size, DeadBroHub::ErrorsController::PER_PAGE, @offset) %>
+<% end %>

data/app/views/dead_bro_hub/errors/not_found.html.erb

@@ -0,0 +1,3 @@
+<% bro_hub_crumb "Errors", "Not found" %>
+<% content_for :bro_hub_crumb_actions do %><%= bro_hub_crumb_link "← All errors", errors_path %><% end %>
+<%= bro_hub_hero eyebrow: "Exceptions", title: "Not found", tone: :red, lead: "DeadBro has no such error for this app." %>

data/app/views/dead_bro_hub/errors/show.html.erb

@@ -0,0 +1,43 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Errors", "##{params[:id]}" %>
+<% content_for :bro_hub_crumb_actions do %><%= bro_hub_crumb_link "← All errors", errors_path %><% end %>
+<% if @error %>
+  <%= bro_hub_hero eyebrow: "Exceptions", title: "Error ##{params[:id]}", tone: :red %>
+  <%= dbh_error_notice(@error) %>
+<% else %>
+  <% e = @error_issue %>
+  <%= bro_hub_hero eyebrow: "Exception", title: e["exception_class"] || "Error", subtitle: "× #{dbh_int(e["occurrences"])}", tone: :red, lead: e["message"] %>
+  <section class="bh-block">
+    <dl class="bh-dl">
+      <dt>Top frame</dt><dd><code><%= e["top_frame"].presence || "-" %></code></dd>
+      <dt>First seen</dt><dd><%= dbh_time(e["first_seen_at"]) %></dd>
+      <dt>Last seen</dt><dd><%= dbh_time(e["last_seen_at"]) %></dd>
+    </dl>
+  </section>
+  <section class="bh-block">
+    <div class="bh-block-head"><h2 class="bh-h2">Affected endpoints</h2></div>
+    <% if e["affected_endpoints"].blank? %>
+      <div class="bh-empty">No endpoint data for this error.</div>
+    <% else %>
+      <div class="bh-table-wrap"><div class="bh-table dbh-cols-top">
+        <div class="bh-row is-head"><span>Endpoint</span><span>Hits</span><span></span></div>
+        <% e["affected_endpoints"].each do |a| %>
+          <div class="bh-row"><span class="bh-cell-strong"><%= a["endpoint"] %></span><span><%= dbh_int(a["hits"]) %></span><span></span></div>
+        <% end %>
+      </div></div>
+    <% end %>
+  </section>
+  <section class="bh-block">
+    <div class="bh-block-head"><h2 class="bh-h2">Recent occurrences</h2></div>
+    <% if e["recent_occurrences"].blank? %>
+      <div class="bh-empty">None available.</div>
+    <% else %>
+      <div class="bh-table-wrap"><div class="bh-table dbh-cols-errors">
+        <div class="bh-row is-head"><span>Request</span><span>Duration</span><span>When</span><span></span></div>
+        <% e["recent_occurrences"].each do |r| %>
+          <div class="bh-row"><span><span class="bh-cell-strong"><%= r["endpoint"] %></span><br><span class="bh-cell-muted"><%= r["path"] %></span></span><span><%= dbh_ms(r["duration_ms"]) %></span><span class="bh-cell-muted"><%= dbh_time(r["at"]) %></span><span></span></div>
+        <% end %>
+      </div></div>
+    <% end %>
+  </section>
+<% end %>

data/app/views/dead_bro_hub/findings/index.html.erb

@@ -0,0 +1,24 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Findings" %>
+<% findings = @data && @data["findings"] %>
+<%= bro_hub_hero eyebrow: "What to fix", title: (findings ? findings.size.to_s : "-"), subtitle: (params[:status] == "all" ? "findings" : "open findings"), tone: :amber,
+      lead: "Problems DeadBro keeps tracking, ranked by how much time they cost." %>
+<div class="bh-filters"><span><%= dbh_chips(:status, %w[active all], params[:status] == "all" ? "all" : "active") %></span></div>
+<% if @error %>
+  <%= dbh_error_notice(@error) %>
+<% elsif findings.empty? %>
+  <div class="bh-table-wrap"><div class="bh-empty">Nothing to fix right now.</div></div>
+<% else %>
+  <div class="bh-table-wrap"><div class="bh-table dbh-cols-findings">
+    <div class="bh-row is-head"><span>Finding</span><span>Kind</span><span>Status</span><span>Impact</span><span>Last seen</span></div>
+    <% findings.each do |f| %>
+      <div class="bh-row">
+        <span><span class="bh-cell-strong"><%= f["title"] %></span><% if f["recommendation"].present? %><br><span class="bh-cell-muted"><%= truncate(f["recommendation"], length: 180) %></span><% end %></span>
+        <span><%= dbh_tag(f["kind"].to_s.humanize.downcase) %></span>
+        <span><%= dbh_tag(f["status"].to_s.humanize.downcase, { "open" => "is-amber", "regressed" => "is-red", "resolved" => "is-green" }[f["status"]]) %></span>
+        <span><% if f["kind"] == "memory_heavy_endpoint" %><%= (f.dig("impact", "mb_per_day") || 0).to_f.round(1) %> MB/day<% else %><%= dbh_ms(f["impact_ms_per_day"]) %>/day<% end %></span>
+        <span class="bh-cell-muted"><%= dbh_time(f["last_seen_at"]) %></span>
+      </div>
+    <% end %>
+  </div></div>
+<% end %>

data/app/views/dead_bro_hub/overview/show.html.erb

@@ -0,0 +1,59 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Overview" %>
+<% o = @overview %>
+<% stats = o && o["stats_24h"] %>
+<% if @error %>
+  <%= bro_hub_hero eyebrow: "DeadBro", title: "Overview", tone: :violet, lead: "The last 24 hours of this app, from DeadBro." %>
+  <%= dbh_error_notice(@error) %>
+<% else %>
+  <%= bro_hub_hero eyebrow: "#{o.dig("application", "name")} · #{o.dig("application", "environment")}",
+        title: stats ? dbh_int(stats["total_requests"]) : "-", subtitle: "requests in 24h", tone: :violet,
+        lead: (o["last_request_at"] ? safe_join([ "Last request seen ", dbh_time(o["last_request_at"]), "." ]) : "DeadBro has not received a request from this app yet."),
+        stats: stats ? [
+          [ dbh_pct(stats["error_rate_pct"]), "error rate", dbh_error_rate_tone(stats["error_rate_pct"]) ],
+          [ dbh_int(stats["error_count"]), "errors" ],
+          [ dbh_pct(stats["slow_rate_pct"]), "slow requests", (:amber if stats["slow_rate_pct"].to_f >= 10) ],
+          [ dbh_int(o["active_findings"]), "open findings", (:amber if o["active_findings"].to_i.positive?) ]
+        ] : [] %>
+
+  <% unless stats %>
+    <div class="bh-alert bh-alert-error">Request statistics are temporarily unavailable from DeadBro.</div>
+  <% end %>
+
+  <section class="bh-block">
+    <div class="bh-block-head"><h2 class="bh-h2">Throughput, per hour</h2></div>
+    <%= dbh_bars((o["hourly"] || []).map { |b| b["calls"] }) %>
+    <p class="dbh-sub">p95 response time per hour</p>
+    <%= dbh_bars((o["hourly"] || []).map { |b| b["p95_ms"] }, tone: "var(--bh-amber)") %>
+  </section>
+
+  <section class="bh-block">
+    <div class="bh-block-head">
+      <h2 class="bh-h2">Slowest endpoints (7 days)</h2>
+      <%= link_to "All endpoints →", endpoints_path, class: "bh-link-quiet" %>
+    </div>
+    <% if o["slowest_endpoints"].blank? %>
+      <div class="bh-empty">No endpoints with enough samples yet.</div>
+    <% else %>
+      <div class="bh-table-wrap"><div class="bh-table dbh-cols-top">
+        <div class="bh-row is-head"><span>Endpoint</span><span>Mean</span><span>Samples</span></div>
+        <% o["slowest_endpoints"].each do |e| %>
+          <div class="bh-row"><span class="bh-cell-strong"><%= e["name"] %></span><span><%= dbh_ms(e["mean_duration_ms"]) %></span><span class="bh-cell-muted"><%= dbh_int(e["samples"]) %></span></div>
+        <% end %>
+      </div></div>
+    <% end %>
+  </section>
+
+  <section class="bh-block">
+    <div class="bh-block-head"><h2 class="bh-h2">Latest deploy</h2><%= link_to "All deploys →", deploys_path, class: "bh-link-quiet" %></div>
+    <% if (d = o["latest_deploy"]) %>
+      <dl class="bh-dl">
+        <dt>Revision</dt><dd><code><%= d["revision"] %></code></dd>
+        <dt>Deployed</dt><dd><%= dbh_time(d["deployed_at"]) %></dd>
+        <dt>Errors since</dt><dd><%= dbh_int(d["error_count"]) %></dd>
+      </dl>
+    <% else %>
+      <div class="bh-empty">No deploys recorded.</div>
+    <% end %>
+  </section>
+<% end %>

data/app/views/dead_bro_hub/queries/index.html.erb

@@ -0,0 +1,37 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "SQL queries" %>
+<%= bro_hub_hero eyebrow: "Database", title: "SQL queries", tone: :violet,
+      lead: "Normalized statements (values replaced by ?), ranked across all requests." %>
+<div class="bh-filters">
+  <%= form_with url: queries_path, method: :get, class: "dbh-search" do %>
+    <%= hidden_field_tag :window, params[:window] if params[:window].present? %>
+    <%= hidden_field_tag :sort, params[:sort] if params[:sort].present? %>
+    <%= search_field_tag :search, params[:search], placeholder: "table or keyword", class: "bh-input" %>
+    <%= submit_tag "Search", name: nil, class: "bh-chip" %>
+  <% end %>
+  <span><%= dbh_chips(:window, %w[24h 7d 30d], @data&.fetch("window", nil) || "7d") %></span>
+  <span><%= dbh_chips(:sort, %w[total_time executions p95 max], @data&.fetch("sort", nil) || "total_time", label_for: ->(s) { s.humanize.downcase }) %></span>
+</div>
+<% if @error %>
+  <%= dbh_error_notice(@error) %>
+<% elsif @data["queries"].empty? %>
+  <div class="bh-table-wrap"><div class="bh-empty">No queries match.</div></div>
+<% else %>
+  <div class="bh-table-wrap"><div class="bh-table dbh-cols-queries">
+    <div class="bh-row is-head"><span>Statement</span><span>Runs</span><span>Total</span><span>Avg</span><span>Max</span><span>p95 request</span></div>
+    <% @data["queries"].each do |q| %>
+      <div class="bh-row">
+        <span><span class="dbh-sql"><%= truncate(q["sql"].to_s, length: 400) %></span><br>
+          <%= dbh_tag(q["query_type"]) if q["query_type"].present? %>
+          <% Array(q["tables"]).first(4).each do |table| %><%= dbh_tag(table) %><% end %>
+          <%= dbh_tag("#{q["n_plus_one_requests"]} N+1", "is-amber") if q["n_plus_one_requests"].to_i.positive? %></span>
+        <span><%= dbh_int(q["executions"]) %></span>
+        <span><%= dbh_ms(q["total_duration_ms"]) %></span>
+        <span><%= dbh_ms(q["avg_duration_ms"]) %></span>
+        <span class="bh-cell-muted"><%= dbh_ms(q["max_duration_ms"]) %></span>
+        <span class="bh-cell-muted"><%= dbh_ms(q["p95_request_ms"]) %></span>
+      </div>
+    <% end %>
+  </div></div>
+  <%= dbh_pager(@data["queries"].size, DeadBroHub::QueriesController::PER_PAGE, @offset) %>
+<% end %>

data/app/views/dead_bro_hub/shared/_page_styles.html.erb

@@ -0,0 +1,15 @@
+<%# What DeadBroHub's pages need on top of BroHub's shared styles. %>
+<style<%= %( nonce="#{content_security_policy_nonce}").html_safe if content_security_policy_nonce %>>
+.bh-main code { font: 500 .92em var(--bh-mono); color: var(--bh-text); overflow-wrap: anywhere; }
+.dbh-cols-endpoints { --cols: minmax(220px, 1.6fr) 90px 100px 90px 80px 90px; --min: 720px; }
+.dbh-cols-errors { --cols: minmax(220px, 1.6fr) 90px 150px 150px; --min: 680px; }
+.dbh-cols-queries { --cols: minmax(280px, 2.4fr) 90px 100px 100px 100px 100px; --min: 880px; }
+.dbh-cols-findings { --cols: minmax(240px, 2fr) 130px 110px 110px 150px; --min: 760px; }
+.dbh-cols-deploys { --cols: minmax(180px, 1.4fr) 150px 120px 100px 110px; --min: 680px; }
+.dbh-cols-top { --cols: minmax(220px, 1fr) 100px 100px; --min: 420px; }
+.dbh-sql { font: 500 12px/1.5 var(--bh-mono); white-space: pre-wrap; overflow-wrap: anywhere; color: var(--bh-text); }
+.dbh-bars { display: block; margin-top: 8px; }
+.dbh-sub { margin: 4px 0 0; font: 400 12px var(--bh-mono); color: var(--bh-muted); }
+.bh-chip.is-on { border-color: var(--bh-violet); background: var(--bh-violet); }
+.dbh-search { display: flex; gap: 8px; }
+</style>

data/app/views/dead_bro_hub/shared/forbidden.html.erb

@@ -0,0 +1,3 @@
+<% bro_hub_crumb "Not allowed" %>
+<%= bro_hub_hero eyebrow: "Access", title: "Nothing here", subtitle: "for you", tone: :red,
+      lead: "DeadBro's data isn't open to your account. Ask whoever runs this app to give you access." %>

data/app/views/dead_bro_hub/status/show.html.erb

@@ -0,0 +1,47 @@
+<% dead_bro_hub_styles %>
+<% bro_hub_crumb "Status" %>
+<% l = @local %>
+<% problem = l[:enabled] == false || !l[:api_key_set] || l[:sending_paused_until] || l.dig(:circuit_breaker, :state).to_s == "open" || @error&.kind == :unauthorized %>
+<%= bro_hub_hero eyebrow: "The gem, in this process", title: (problem ? "Needs attention" : "Healthy"), tone: (problem ? :amber : :green),
+      lead: "Whether dead_bro is on, sending and in sync with DeadBro, and the settings DeadBro hands it." %>
+
+<% if @error %><%= dbh_error_notice(@error) %><% end %>
+
+<div class="bh-split">
+  <div class="bh-split-main">
+    <section class="bh-block">
+      <div class="bh-block-head"><h2 class="bh-h2">In this app</h2></div>
+      <dl class="bh-dl">
+        <dt>dead_bro version</dt><dd><%= l[:gem_version] %></dd>
+        <dt>Tracking</dt><dd><%= dbh_yes_no(l[:enabled], yes: "enabled", no: "disabled") %></dd>
+        <dt>API key</dt><dd><%= l[:api_key_set] ? dbh_tag("set", "is-green") : dbh_tag("missing", "is-red") %></dd>
+        <dt>Sending to</dt><dd><code><%= l[:endpoint] %></code></dd>
+        <dt>Rails env</dt><dd><%= l[:environment] || "-" %></dd>
+        <dt>Deploy revision</dt><dd><code><%= l[:deploy_revision] || "-" %></code></dd>
+        <dt>Paused until</dt><dd><%= l[:sending_paused_until] ? "#{l[:sending_paused_until]} (account limit reached)" : "not paused" %></dd>
+        <dt>Settings received</dt><dd><%= dbh_time(l[:settings_received_at]) %></dd>
+        <dt>Last heartbeat</dt><dd><%= dbh_time(l[:last_heartbeat_at]) %></dd>
+        <dt>Circuit breaker</dt>
+        <dd><% if (cb = l[:circuit_breaker]) %><%= dbh_tag(cb[:state].to_s, cb[:state].to_s == "closed" ? "is-green" : "is-red") %> <span class="bh-cell-muted"><%= cb[:failures] %> failures · last success <%= dbh_time(cb[:last_success_at]) %></span><% else %>-<% end %></dd>
+        <dt>Dropped payloads</dt><dd><%= dbh_int(l[:dropped_payloads]) %> <span class="bh-cell-muted">(queue full)</span></dd>
+        <dt>Unserializable</dt><dd><%= dbh_int(l[:unserializable_payloads]) %></dd>
+      </dl>
+    </section>
+  </div>
+  <div class="bh-split-aside">
+    <section class="bh-block">
+      <div class="bh-block-head"><h2 class="bh-h2">From DeadBro</h2></div>
+      <% if @remote %>
+        <dl class="bh-dl">
+          <dt>Last gem version seen</dt><dd><%= @remote["gem_version"] || "-" %></dd>
+          <dt>Settings changed</dt><dd><%= dbh_time(@remote["settings_updated_at"]) %></dd>
+          <% @remote["settings"].each do |key, value| %>
+            <dt><%= key %></dt><dd><%= value.is_a?(Hash) || value.is_a?(Array) ? (value.blank? ? "-" : value.to_json) : value.to_s %></dd>
+          <% end %>
+        </dl>
+      <% else %>
+        <div class="bh-empty">Not available.</div>
+      <% end %>
+    </section>
+  </div>
+</div>

data/config/routes.rb

@@ -0,0 +1,11 @@
+DeadBroHub::Engine.routes.draw do
+  root "overview#show"
+
+  get "endpoints" => "endpoints#index", as: :endpoints
+  get "errors" => "errors#index", as: :errors
+  get "errors/:id" => "errors#show", as: :error, constraints: { id: /\d+/ }
+  get "queries" => "queries#index", as: :queries
+  get "findings" => "findings#index", as: :findings
+  get "deploys" => "deploys#index", as: :deploys
+  get "status" => "status#show", as: :status
+end

data/lib/dead_bro_hub/api.rb

@@ -0,0 +1,81 @@
+require "net/http"
+require "json"
+
+module DeadBroHub
+  # Reads the hub pages' data from DeadBro (/api/v1/hub/*), authenticated with the app's API key.
+  # One method per page, so a page fetches only what it shows.
+  class Api
+    # kind: :not_configured, :unauthorized, :not_found, :unavailable, :network or :bad_response
+    class Error < StandardError
+      attr_reader :kind
+
+      def initialize(kind, message)
+        @kind = kind
+        super(message)
+      end
+    end
+
+    PREFIX = "/api/v1/hub".freeze
+
+    def initialize(config = DeadBroHub.config)
+      @config = config
+    end
+
+    def overview = get("overview")
+    def endpoints(params = {}) = get("endpoints", params)
+    def errors(params = {}) = get("errors", params)
+    def error(id) = get("errors/#{Integer(id)}")
+    def queries(params = {}) = get("queries", params)
+    def findings(params = {}) = get("findings", params)
+    def deploys(params = {}) = get("deploys", params)
+    def settings = get("settings")
+
+    private
+      attr_reader :config
+
+      def get(path, params = {})
+        raise Error.new(:not_configured, "No DeadBro API key: configure the dead_bro gem first") unless config.api_key
+
+        params = params.to_h.compact_blank
+        return request(path, params) unless config.cache_ttl.to_i.positive?
+
+        # Only successful responses are cached: a failure raises out of the block.
+        Rails.cache.fetch(cache_key(path, params), expires_in: config.cache_ttl) { request(path, params) }
+      end
+
+      # The key is hashed in: it must not end up in a cache store or its logs.
+      def cache_key(path, params)
+        [ "dead_bro_hub", Digest::SHA256.hexdigest(config.api_key)[0, 16], path, params.sort.to_h.to_query ].join("/")
+      end
+
+      def request(path, params)
+        uri = URI("#{config.base_url}#{PREFIX}/#{path}")
+        uri.query = params.to_query if params.any?
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = config.open_timeout
+        http.read_timeout = config.read_timeout
+
+        req = Net::HTTP::Get.new(uri)
+        req["Authorization"] = "Bearer #{config.api_key}"
+        req["Accept"] = "application/json"
+
+        parse(http.request(req))
+      rescue Timeout::Error, SocketError, SystemCallError, EOFError, OpenSSL::SSL::SSLError => error
+        raise Error.new(:network, "Could not reach DeadBro (#{error.class})")
+      end
+
+      def parse(response)
+        case response.code.to_i
+        when 200 then JSON.parse(response.body)
+        when 401 then raise Error.new(:unauthorized, "DeadBro rejected this app's API key")
+        when 404 then raise Error.new(:not_found, "Not found")
+        when 502, 503, 504 then raise Error.new(:unavailable, "DeadBro is temporarily unavailable")
+        else raise Error.new(:bad_response, "Unexpected response from DeadBro (HTTP #{response.code})")
+        end
+      rescue JSON::ParserError
+        raise Error.new(:bad_response, "DeadBro sent a response that is not JSON")
+      end
+  end
+end

data/lib/dead_bro_hub/configuration.rb

@@ -0,0 +1,52 @@
+module DeadBroHub
+  class Configuration
+    # Controller the engine controllers inherit from (gives access to the host's authentication).
+    attr_accessor :parent_controller
+
+    # ->(controller) { ... } returning the signed in user, or nil. Defaults to BroHub.config.current_user.
+    attr_accessor :current_user
+
+    # ->(user) { true/false }. Who may see DeadBro's data here. Nobody until you say so: the pages show
+    # SQL statements, exception messages and request paths.
+    attr_accessor :can_view
+
+    # Both default to what the dead_bro gem already uses, so there is normally nothing to set.
+    attr_writer :api_key, :base_url
+
+    # Seconds a DeadBro response is kept in Rails.cache, so browsing the hub doesn't hit DeadBro on
+    # every click. 0 turns caching off.
+    attr_accessor :cache_ttl
+
+    attr_accessor :open_timeout, :read_timeout
+
+    def initialize
+      @parent_controller = "::ApplicationController"
+      @current_user = ->(controller) { BroHub.config.current_user.call(controller) }
+      @can_view = ->(_user) { false }
+      @cache_ttl = 30
+      @open_timeout = 2
+      @read_timeout = 5
+    end
+
+    def allows?(user)
+      !user.nil? && !!can_view.call(user)
+    end
+
+    def api_key
+      (@api_key.presence || DeadBro.configuration.api_key).to_s.presence
+    end
+
+    # Same endpoint selection as the dead_bro client uses to send metrics.
+    def base_url
+      return @base_url.to_s.chomp("/") if @base_url.present?
+
+      if DeadBro.configuration.ruby_dev
+        "http://localhost:3100"
+      elsif ENV["USE_STAGING_ENDPOINT"].present?
+        "https://deadbro.aberatii.com"
+      else
+        "https://www.deadbro.com"
+      end
+    end
+  end
+end

data/lib/dead_bro_hub/engine.rb

@@ -0,0 +1,22 @@
+module DeadBroHub
+  # Items in the BroHub sidebar. Paths are relative to the engine.
+  BRO_HUB_ITEMS = [
+    { label: "Overview", path: "/" },
+    { label: "Endpoints", path: "/endpoints" },
+    { label: "Errors", path: "/errors" },
+    { label: "SQL queries", path: "/queries" },
+    { label: "Findings", path: "/findings" },
+    { label: "Deploys", path: "/deploys" },
+    { label: "Status", path: "/status" }
+  ].freeze
+
+  class Engine < ::Rails::Engine
+    isolate_namespace DeadBroHub
+  end
+end
+
+# Registered when the gem loads, so it is in place before routes are drawn and BroHub can mount the engine.
+# Showing a section is navigation only: every DeadBroHub controller still authorizes each request.
+BroHub.register :dead_bro_hub, name: "DeadBro", label: "DeadBro · performance", accent: :violet,
+  engine: "DeadBroHub::Engine", order: 30, items: DeadBroHub::BRO_HUB_ITEMS,
+  visible_to: ->(user) { DeadBroHub.config.allows?(user) }

data/lib/dead_bro_hub/local_status.rb

@@ -0,0 +1,49 @@
+module DeadBroHub
+  # What the dead_bro gem is doing inside this process, read from its in-memory state. This is the half of
+  # the status page DeadBro itself can't know: whether the gem is on, sending and healthy *here*.
+  #
+  # Every read is guarded: the page must keep rendering against a dead_bro version that lacks one of these.
+  module LocalStatus
+    module_function
+
+    def snapshot
+      config = DeadBro.configuration
+
+      {
+        gem_version: DeadBro::VERSION,
+        enabled: read { config.enabled },
+        api_key_set: read { config.api_key.present? },
+        environment: read { DeadBro.env },
+        endpoint: DeadBroHub.config.base_url,
+        sending_paused_until: read { config.skip_until if config.skip_tracking? },
+        settings_received_at: read { config.settings_received_at },
+        last_heartbeat_at: read { config.last_heartbeat_at },
+        sample_rate: read { config.sample_rate },
+        monitor_enabled: read { config.monitor_enabled },
+        explain_active: read { config.explain_active? },
+        circuit_breaker: circuit_breaker,
+        dropped_payloads: read { DeadBro::Dispatcher.instance.dropped_count },
+        unserializable_payloads: read { DeadBro.client.serialization_failures },
+        deploy_revision: read { config.resolve_deploy_id }
+      }
+    end
+
+    # The client keeps its breaker private; this is the one place that reaches in for it.
+    def circuit_breaker
+      client = DeadBro.client
+      breaker = client.instance_variable_get(:@circuit_breaker)
+      return nil unless breaker
+
+      { state: breaker.state, failures: breaker.failure_count, last_failure_at: breaker.last_failure_time,
+        last_success_at: breaker.last_success_time }
+    rescue StandardError
+      nil
+    end
+
+    def read
+      yield
+    rescue StandardError
+      nil
+    end
+  end
+end

data/lib/dead_bro_hub/version.rb

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

data/lib/dead_bro_hub.rb

@@ -0,0 +1,29 @@
+require "bro_hub"
+require "dead_bro"
+require "dead_bro_hub/version"
+require "dead_bro_hub/configuration"
+require "dead_bro_hub/api"
+require "dead_bro_hub/local_status"
+require "dead_bro_hub/engine"
+
+module DeadBroHub
+  class Forbidden < StandardError; end
+
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def configure
+      yield config
+    end
+
+    def reset_config!
+      @config = nil
+    end
+
+    def api
+      Api.new(config)
+    end
+  end
+end

data/lib/generators/dead_bro_hub/install/install_generator.rb

@@ -0,0 +1,30 @@
+require "rails/generators"
+require "generators/bro_hub/installable"
+
+module DeadBroHub
+  module Generators
+    # bin/rails generate dead_bro_hub:install
+    class InstallGenerator < Rails::Generators::Base
+      # BroHub first (one mount for all the Bro gems), then DeadBroHub itself.
+      include BroHub::Generators::Installable
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Sets up the BroHub dashboard and adds the DeadBroHub initializer."
+
+      def copy_initializer
+        copy_config_once "dead_bro_hub.rb", "config/initializers/dead_bro_hub.rb"
+      end
+
+      def next_steps
+        say <<~TEXT
+
+          DeadBroHub is installed. Next:
+            1. Set who may see DeadBro's data in config/initializers/dead_bro_hub.rb (nobody until you do)
+            2. Make sure the dead_bro gem is configured with this app's API key: DeadBroHub reuses it
+            3. Visit #{bro_hub_path}/dead_bro_hub
+        TEXT
+      end
+    end
+  end
+end

data/lib/generators/dead_bro_hub/install/templates/dead_bro_hub.rb

@@ -0,0 +1,18 @@
+# DeadBroHub shows what DeadBro knows about this app inside the BroHub dashboard. It reads with the API key the
+# dead_bro gem already uses, so there is nothing to configure except who may look.
+DeadBroHub.configure do |config|
+  # Who may see DeadBro's data. Everything is denied until you change this. The pages show SQL statements,
+  # exception messages and request paths, so keep it to people who can already see that.
+  config.can_view = ->(user) { false } # e.g. user&.admin?
+
+  # How DeadBroHub finds the signed in user (default: BroHub.config.current_user).
+  # config.parent_controller = "::ApplicationController"
+  # config.current_user = ->(controller) { controller.send(:current_user) }
+
+  # Seconds a response from DeadBro is cached in Rails.cache (0 = off).
+  # config.cache_ttl = 30
+
+  # Only if you need to override what the dead_bro gem uses:
+  # config.api_key = ENV["DEAD_BRO_API_KEY"]
+  # config.base_url = "https://www.deadbro.com"
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: dead_bro_hub
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ruby Dev SRL
+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: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: bro_hub
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+- !ruby/object:Gem::Dependency
+  name: dead_bro
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.34
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.34
+description: A BroHub section that shows what DeadBro knows about this app (overview,
+  endpoints, errors, slow SQL, findings, deploys) next to the other Bro gems. It reads
+  from DeadBro with the API key the dead_bro gem already uses, and shows whether the
+  gem itself is healthy.
+email:
+- office@rubydev.ro
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/controllers/dead_bro_hub/application_controller.rb
+- app/controllers/dead_bro_hub/deploys_controller.rb
+- app/controllers/dead_bro_hub/endpoints_controller.rb
+- app/controllers/dead_bro_hub/errors_controller.rb
+- app/controllers/dead_bro_hub/findings_controller.rb
+- app/controllers/dead_bro_hub/overview_controller.rb
+- app/controllers/dead_bro_hub/queries_controller.rb
+- app/controllers/dead_bro_hub/status_controller.rb
+- app/helpers/dead_bro_hub/application_helper.rb
+- app/views/dead_bro_hub/deploys/index.html.erb
+- app/views/dead_bro_hub/endpoints/index.html.erb
+- app/views/dead_bro_hub/errors/index.html.erb
+- app/views/dead_bro_hub/errors/not_found.html.erb
+- app/views/dead_bro_hub/errors/show.html.erb
+- app/views/dead_bro_hub/findings/index.html.erb
+- app/views/dead_bro_hub/overview/show.html.erb
+- app/views/dead_bro_hub/queries/index.html.erb
+- app/views/dead_bro_hub/shared/_page_styles.html.erb
+- app/views/dead_bro_hub/shared/forbidden.html.erb
+- app/views/dead_bro_hub/status/show.html.erb
+- config/routes.rb
+- lib/dead_bro_hub.rb
+- lib/dead_bro_hub/api.rb
+- lib/dead_bro_hub/configuration.rb
+- lib/dead_bro_hub/engine.rb
+- lib/dead_bro_hub/local_status.rb
+- lib/dead_bro_hub/version.rb
+- lib/generators/dead_bro_hub/install/install_generator.rb
+- lib/generators/dead_bro_hub/install/templates/dead_bro_hub.rb
+homepage: https://www.deadbro.com
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://www.deadbro.com
+  source_code_uri: https://github.com/rubydevro/dead_bro_hub
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: DeadBro's performance data, inside your BroHub dashboard.
+test_files: []