railwatch 0.1.4 → 0.2.0

data/db/railwatch_migrate/20260917000000_create_railwatch_maintenance_tasks.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# The embedded install's maintenance lease table: one row per task in
+# Railwatch::Maintenance::TASKS, recording when it last ran and which process
+# holds it now. Lives in the railwatch database with the other permanent,
+# operator-facing state rather than in the pruned telemetry file.
+class CreateRailwatchMaintenanceTasks < ActiveRecord::Migration[8.1]
+  def change
+    create_table :railwatch_maintenance_tasks do |t|
+      t.string :name, null: false
+      t.datetime :last_run_at
+      t.string :lease_owner
+      t.datetime :lease_expires_at
+      t.timestamps
+    end
+    add_index :railwatch_maintenance_tasks, :name, unique: true
+  end
+end

data/db/railwatch_migrate/20260917120000_create_railwatch_followup_receipts.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# What makes replaying a batch's follow-ups safe. Exception grouping bumps an
+# issue's occurrence count in this database, but the "done" mark lives on the
+# batch's ledger row in the OTHER database, so a crash between the two (or
+# the inline drain racing the maintenance drain) would count the same
+# exceptions twice. A receipt per (batch, group) is inserted in the same
+# transaction as the issue update; the unique index turns a second attempt
+# into a no-op.
+class CreateRailwatchFollowupReceipts < ActiveRecord::Migration[8.1]
+  def change
+    create_table :railwatch_followup_receipts do |t|
+      t.string :batch_id, limit: 36, null: false
+      t.string :group_hash, limit: 32, null: false
+      t.datetime :created_at, null: false
+    end
+    add_index :railwatch_followup_receipts, [ :batch_id, :group_hash ], unique: true
+    add_index :railwatch_followup_receipts, :created_at
+  end
+end

data/db/railwatch_migrate/20260918120000_widen_host_user_ids.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# The ids on comments, issue activity, saved views and issue assignment are
+# whatever the host's `dashboard_user` resolver returned. They were integer
+# columns, which quietly assumed every application numbers its users. An app
+# with UUID primary keys could not store a comment at all, and one with ids
+# past the signed range could not either.
+#
+# Nothing joins on these columns and nothing indexes them; they are an opaque
+# handle the host gave us and hands back. A string says that, and costs
+# nothing in a database that is a few thousand rows of authored content.
+#
+# Existing values convert cleanly: SQLite rewrites 7 as "7", and the models
+# compare with to_s on both sides, so a row written before this migration
+# still matches the same viewer after it.
+class WidenHostUserIds < ActiveRecord::Migration[8.1]
+  COLUMNS = {
+    railwatch_issues: :assignee_id,
+    railwatch_comments: :viewer_id,
+    railwatch_issue_activities: :viewer_id,
+    railwatch_saved_views: :viewer_id
+  }.freeze
+
+  # SQLite rebuilds a table to change a column type, and a rebuild inside a
+  # transaction ignores `PRAGMA foreign_keys = OFF`. This database declares no
+  # foreign keys, so there is nothing to cascade, but the rebuild is kept out
+  # of the migrator's transaction anyway: it is the cheap half of a habit
+  # whose expensive half is deleted rows.
+  disable_ddl_transaction!
+
+  def up
+    COLUMNS.each do |table, column|
+      null = column == :viewer_id && table == :railwatch_saved_views ? false : true
+      change_column table, column, :string, limit: 255, null: null
+    end
+  end
+
+  # Reversible only while every stored id still looks like a number. Once a
+  # host with UUIDs (or emails, or anything else) has written one, there is
+  # no integer to go back to: the column would either refuse the value or
+  # quietly coerce it to something that is no longer that person. Say so and
+  # stop, rather than losing the identity on the way down. These tables are
+  # authored content, a few thousand rows at most, so reading them is cheap.
+  INTEGERISH = /\A-?\d+\z/
+  MAX_REPORTED = 3
+
+  def down
+    blocking = COLUMNS.filter_map do |table, column|
+      next unless connection.table_exists?(table)
+
+      values = connection.select_values(
+        "SELECT DISTINCT #{connection.quote_column_name(column)} FROM #{connection.quote_table_name(table)} " \
+        "WHERE #{connection.quote_column_name(column)} IS NOT NULL"
+      )
+      offenders = values.reject { |value| INTEGERISH.match?(value.to_s) }
+      "#{table}.#{column} (#{offenders.first(MAX_REPORTED).join(', ')}#{"..." if offenders.size > MAX_REPORTED})" if offenders.any?
+    end
+
+    if blocking.any?
+      raise ActiveRecord::IrreversibleMigration,
+            "cannot narrow host user ids back to integers: #{blocking.join('; ')}. " \
+            "Those ids came from this application's own dashboard_user resolver and have no integer form; " \
+            "rolling back would discard them."
+    end
+
+    COLUMNS.each do |table, column|
+      null = column == :viewer_id && table == :railwatch_saved_views ? false : true
+      change_column table, column, :integer, null: null
+    end
+  end
+end

data/db/railwatch_telemetry_migrate/20260903000001_create_telemetry.rb

@@ -0,0 +1,481 @@
+# frozen_string_literal: true
+
+# One table per record type, matching the gem's wire types one to one.
+# Every table starts with the shared envelope. JSON columns hold the
+# variable parts; hot filter columns are real columns with indexes.
+class CreateTelemetry < ActiveRecord::Migration[8.1]
+  def change
+    create_table :executions do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :kind, null: false, limit: 20         # request, job_attempt, scheduled_task, command
+      t.string :name, null: false, limit: 255        # "GET /widgets/:id", "WidgetJob", "rake db:migrate"
+      t.integer :duration, null: false               # microseconds
+      t.integer :status                              # http status, or exit code
+      t.string :outcome, limit: 20                   # processed, failed, aborted
+      t.string :method, limit: 10
+      t.string :route, limit: 255
+      t.string :controller, limit: 255
+      t.string :action, limit: 128
+      t.string :queue, limit: 128
+      t.integer :attempt
+      t.integer :queue_latency
+      t.string :job_id, limit: 36
+      t.string :task_key, limit: 128
+      t.string :inertia_component, limit: 255
+      t.boolean :inertia_partial, default: false
+      t.integer :allocations
+      t.bigint :peak_memory
+      t.string :exception_preview, limit: 255
+      t.json :stages, null: false, default: {}
+      t.json :counters, null: false, default: {}
+      t.json :detail, null: false, default: {}     # headers, payload, url, ip, user agent, context, extras
+    end
+    add_index :executions, [ :kind, :occurred_at ]
+    add_index :executions, [ :group_hash, :occurred_at ]
+    add_index :executions, :execution_id, unique: true
+    add_index :executions, :trace_id
+    add_index :executions, [ :user_ref, :occurred_at ]
+    add_index :executions, [ :deploy, :occurred_at ]
+    add_index :executions, [ :tenant, :occurred_at ]
+
+    create_table :queries do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.text :sql, null: false
+      t.string :name, limit: 255
+      t.integer :duration, null: false
+      t.string :connection, limit: 64
+      t.string :adapter, limit: 32
+      t.boolean :async, default: false
+      t.boolean :in_transaction, default: false
+      t.integer :row_count
+      t.string :source, limit: 255
+      t.integer :allocations
+    end
+    add_index :queries, [ :group_hash, :occurred_at ]
+    add_index :queries, [ :execution_id, :occurred_at ]
+    add_index :queries, [ :occurred_at, :duration ]
+
+    create_table :exceptions do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :class_name, null: false, limit: 255
+      t.text :message, null: false
+      t.boolean :handled, null: false, default: false
+      t.string :severity, limit: 16
+      t.string :source, limit: 128
+      t.string :file, limit: 255
+      t.integer :line
+      t.json :frames, null: false, default: []
+      t.json :cause
+      t.text :context
+      t.string :ruby_version, limit: 16
+      t.string :rails_version, limit: 16
+    end
+    add_index :exceptions, [ :group_hash, :occurred_at ]
+    add_index :exceptions, [ :execution_id ]
+    add_index :exceptions, [ :occurred_at ]
+
+    create_table :cache_events do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :store, limit: 64
+      t.string :key, limit: 255
+      t.string :type, null: false, limit: 20
+      t.integer :duration, null: false
+      t.integer :ttl
+      t.integer :hits
+    end
+    add_index :cache_events, [ :group_hash, :occurred_at ]
+    add_index :cache_events, [ :execution_id ]
+
+    create_table :mails do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :mailer, null: false, limit: 255
+      t.string :subject, limit: 255
+      t.integer :to, default: 0
+      t.integer :cc, default: 0
+      t.integer :bcc, default: 0
+      t.integer :attachments, default: 0
+      t.string :delivery_method, limit: 64
+      t.boolean :perform_deliveries, default: true
+      t.integer :duration, null: false
+      t.boolean :failed, default: false
+      t.string :message_id, limit: 255
+    end
+    add_index :mails, [ :group_hash, :occurred_at ]
+    add_index :mails, [ :execution_id ]
+
+    create_table :broadcasts do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :kind, null: false, limit: 20
+      t.string :stream, limit: 255
+      t.string :channel, limit: 255
+      t.string :action, limit: 128
+      t.integer :bytes
+      t.integer :duration, null: false
+    end
+    add_index :broadcasts, [ :group_hash, :occurred_at ]
+    add_index :broadcasts, [ :execution_id ]
+
+    create_table :notifications do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :notifier, limit: 255
+      t.string :delivery_method, limit: 128
+      t.integer :duration, null: false
+      t.boolean :failed, default: false
+    end
+    add_index :notifications, [ :group_hash, :occurred_at ]
+
+    create_table :outgoing_requests do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :host, null: false, limit: 255
+      t.string :method, null: false, limit: 10
+      t.string :url, limit: 2048
+      t.integer :duration, null: false
+      t.integer :status_code
+      t.integer :request_size
+      t.integer :response_size
+      t.string :error, limit: 255
+      t.string :source, limit: 255
+    end
+    add_index :outgoing_requests, [ :group_hash, :occurred_at ]
+    add_index :outgoing_requests, [ :execution_id ]
+
+    create_table :storage_ops do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :service, limit: 64
+      t.string :op, null: false, limit: 32
+      t.string :key, limit: 255
+      t.integer :duration, null: false
+    end
+    add_index :storage_ops, [ :group_hash, :occurred_at ]
+
+    create_table :view_renders do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :identifier, null: false, limit: 255
+      t.string :kind, limit: 20
+      t.string :layout, limit: 255
+      t.integer :count
+      t.integer :cache_hits
+      t.integer :duration, null: false
+    end
+    add_index :view_renders, [ :group_hash, :occurred_at ]
+    add_index :view_renders, [ :execution_id ]
+
+    create_table :logs do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :level, null: false, limit: 10
+      t.text :message, null: false
+      t.json :tags, null: false, default: []
+      t.text :context
+      t.string :source, limit: 255
+    end
+    add_index :logs, [ :level, :occurred_at ]
+    add_index :logs, [ :execution_id ]
+    add_index :logs, [ :occurred_at ]
+
+    create_table :enqueued_jobs do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :job_id, limit: 36
+      t.string :name, null: false, limit: 255
+      t.string :queue, limit: 128
+      t.string :adapter, limit: 64
+      t.integer :priority
+      t.datetime :scheduled_at, precision: 6
+      t.integer :duration, null: false
+      t.boolean :failed, default: false
+    end
+    add_index :enqueued_jobs, [ :group_hash, :occurred_at ]
+    add_index :enqueued_jobs, [ :execution_id ]
+    add_index :enqueued_jobs, :job_id
+
+    create_table :transactions do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.integer :duration, null: false
+      t.string :outcome, limit: 20
+      t.string :connection, limit: 64
+    end
+    add_index :transactions, [ :execution_id ]
+
+    create_table :n_plus_ones do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.text :sql, null: false
+      t.integer :count, null: false
+      t.string :source, limit: 255
+    end
+    add_index :n_plus_ones, [ :group_hash, :occurred_at ]
+
+    create_table :deprecations do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.text :message, null: false
+      t.string :gem_name, limit: 128
+      t.string :horizon, limit: 32
+      t.string :source, limit: 255
+    end
+    add_index :deprecations, [ :group_hash, :occurred_at ]
+
+    create_table :visits do |t|
+      # The record envelope as it was when this migration shipped; inlined so
+      # the history never calls a model that has since changed.
+      t.datetime :occurred_at, null: false, precision: 6
+      t.string :deploy, limit: 128
+      t.string :server, limit: 255
+      t.string :group_hash, limit: 32
+      t.string :trace_id, limit: 36
+      t.string :execution_source, limit: 20
+      t.string :execution_id, limit: 36
+      t.string :execution_preview, limit: 255
+      t.string :execution_stage, limit: 32
+      t.string :user_ref, limit: 255
+      t.string :tenant, limit: 255
+      t.string :component, limit: 255
+      t.string :url, limit: 2048
+      t.string :method, limit: 10
+      t.integer :duration, null: false
+      t.string :status, limit: 20
+      t.boolean :partial, default: false
+      t.json :only, null: false, default: []
+      t.integer :props_bytes
+      t.string :user_agent, limit: 255
+    end
+    add_index :visits, [ :group_hash, :occurred_at ]
+
+    create_table :people do |t|
+      t.string :ref, null: false, limit: 255     # tenant:id or id
+      t.string :name, limit: 255
+      t.string :email, limit: 255
+      t.string :tenant, limit: 255
+      t.datetime :first_seen_at, precision: 6
+      t.datetime :last_seen_at, precision: 6
+      t.integer :requests_count, null: false, default: 0
+      t.integer :exceptions_count, null: false, default: 0
+    end
+    add_index :people, :ref, unique: true
+    add_index :people, :last_seen_at
+
+    create_table :processes do |t|
+      t.datetime :booted_at, null: false, precision: 6
+      t.integer :pid
+      t.string :role, limit: 20
+      t.string :server, limit: 255
+      t.string :deploy, limit: 128
+      t.string :ruby_version, limit: 16
+      t.string :rails_version, limit: 16
+      t.string :lantern_version, limit: 16
+      t.float :boot_seconds
+      t.json :detail, null: false, default: {}
+    end
+    add_index :processes, :booted_at
+
+    # Hourly aggregates per record type and group. Percentiles come from a
+    # t-digest blob so they merge across hours without the raw rows.
+    create_table :rollups do |t|
+      t.datetime :bucket, null: false                # start of the hour, UTC
+      t.string :record_type, null: false, limit: 32  # request, job_attempt, query, ...
+      t.string :group_hash, null: false, limit: 32
+      t.string :name, null: false, limit: 255
+      t.bigint :count, null: false, default: 0
+      t.bigint :error_count, null: false, default: 0      # 5xx, failed, exceptions
+      t.bigint :client_error_count, null: false, default: 0
+      t.bigint :duration_sum, null: false, default: 0
+      t.integer :duration_max, null: false, default: 0
+      t.integer :p50, null: false, default: 0
+      t.integer :p95, null: false, default: 0
+      t.integer :p99, null: false, default: 0
+      t.binary :digest
+      t.json :extra, null: false, default: {}
+    end
+    add_index :rollups, [ :record_type, :group_hash, :bucket ], unique: true
+    add_index :rollups, [ :record_type, :bucket ]
+
+    create_table :ingest_batches do |t|
+      t.datetime :received_at, null: false, precision: 6
+      t.integer :accepted, null: false, default: 0
+      t.integer :rejected, null: false, default: 0
+      t.integer :dropped_by_client, null: false, default: 0
+      t.integer :bytes, null: false, default: 0
+      t.string :gem_version, limit: 16
+      t.json :counts_by_type, null: false, default: {}
+      t.json :rejections, null: false, default: []
+    end
+    add_index :ingest_batches, :received_at
+  end
+end

data/db/railwatch_telemetry_migrate/20260903000002_rename_tenant_to_app_tenant.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# activerecord-tenanted defines `#tenant` on every tenanted model (the DB the
+# row lives in), which shadowed the wire record's own tenant column. The
+# monitored app's tenant is a different thing, so it gets its own name.
+class RenameTenantToAppTenant < ActiveRecord::Migration[8.1]
+  TABLES = %i[executions queries exceptions cache_events mails broadcasts notifications outgoing_requests
+              storage_ops view_renders logs enqueued_jobs transactions n_plus_ones deprecations visits].freeze
+
+  def change
+    TABLES.each { |t| rename_column t, :tenant, :app_tenant }
+    rename_column :people, :tenant, :app_tenant
+  end
+end

data/db/railwatch_telemetry_migrate/20260903000003_add_statement_count_to_transactions.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# The gem reports how many statements ran inside each transaction; the
+# ingest mapper dropped it because the column never existed.
+class AddStatementCountToTransactions < ActiveRecord::Migration[8.1]
+  def change
+    add_column :transactions, :statement_count, :integer
+  end
+end

data/db/railwatch_telemetry_migrate/20260903000004_add_role_and_channel.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Nightwatch parity: a query's multi-DB role (writing/reading) and a
+# notification's channel (email/slack/...) alongside the delivery class.
+class AddRoleAndChannel < ActiveRecord::Migration[8.1]
+  def change
+    add_column :queries, :role, :string, limit: 16
+    add_column :notifications, :channel, :string, limit: 64
+  end
+end

data/db/railwatch_telemetry_migrate/20260903000005_add_locals_to_exceptions.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Redacted local variables at the raise site, when the gem is configured to
+# capture them (NIGHTRAIL_CAPTURE_EXCEPTION_LOCALS).
+class AddLocalsToExceptions < ActiveRecord::Migration[8.1]
+  def change
+    add_column :exceptions, :locals, :json
+  end
+end