solid_objects 0.12.1 → 0.13.0

data/web/views/dashboard.erb

@@ -0,0 +1,128 @@
+<% if SolidObjects::Web.charts? %>
+  <section class="charts">
+    <article class="panel chart-panel">
+      <h2>Instances by actor type</h2>
+      <%= chart("instances_by_type", @instances_by_type) %>
+    </article>
+    <article class="panel chart-panel">
+      <h2>Mailbox</h2>
+      <%= chart("mailbox_depth", {
+        "Ready" => @statistics.dig(:mailbox, :ready),
+        "Due" => @statistics.dig(:mailbox, :due),
+        "Claimed" => @statistics.dig(:mailbox, :claimed)
+      }) %>
+    </article>
+    <article class="panel chart-panel chart-wide">
+      <h2>Outboxes and reminders by status</h2>
+      <%= chart("work_by_status", {
+        "Effects" => @statistics.fetch(:effects),
+        "Broadcasts" => @statistics.fetch(:broadcasts),
+        "Reminders" => @statistics.fetch(:reminders).except(:due)
+      }) %>
+    </article>
+  </section>
+<% end %>
+
+<section class="cards">
+  <article class="card">
+    <h2>Instances</h2>
+    <dl>
+      <div><dt>Total</dt><dd><%= number(@statistics.dig(:instances, :total)) %></dd></div>
+      <div><dt>Activated</dt><dd><%= number(@statistics.dig(:instances, :activated)) %></dd></div>
+      <div><dt>Paused</dt><dd><%= number(@statistics.dig(:instances, :paused)) %></dd></div>
+    </dl>
+  </article>
+
+  <article class="card">
+    <h2>Mailbox</h2>
+    <dl>
+      <div><dt>Ready</dt><dd><%= number(@statistics.dig(:mailbox, :ready)) %></dd></div>
+      <div><dt>Due</dt><dd><%= number(@statistics.dig(:mailbox, :due)) %></dd></div>
+      <div><dt>Claimed</dt><dd><%= number(@statistics.dig(:mailbox, :claimed)) %></dd></div>
+      <div><dt>Oldest due</dt><dd><%= duration(@statistics.dig(:mailbox, :latency)) %></dd></div>
+    </dl>
+  </article>
+
+  <article class="card">
+    <h2>Effects</h2>
+    <dl>
+      <% @statistics.fetch(:effects).each do |status, count| %>
+        <div><dt><%= h(status) %></dt><dd><%= number(count) %></dd></div>
+      <% end %>
+    </dl>
+  </article>
+
+  <article class="card">
+    <h2>Broadcasts</h2>
+    <dl>
+      <% @statistics.fetch(:broadcasts).each do |status, count| %>
+        <div><dt><%= h(status) %></dt><dd><%= number(count) %></dd></div>
+      <% end %>
+    </dl>
+  </article>
+
+  <article class="card">
+    <h2>Reminders</h2>
+    <dl>
+      <% @statistics.fetch(:reminders).each do |status, count| %>
+        <div><dt><%= h(status) %></dt><dd><%= number(count) %></dd></div>
+      <% end %>
+    </dl>
+  </article>
+
+  <article class="card">
+    <h2>Processes</h2>
+    <dl>
+      <% @statistics.fetch(:processes).each do |state, count| %>
+        <div><dt><%= h(state) %></dt><dd><%= number(count) %></dd></div>
+      <% end %>
+    </dl>
+  </article>
+</section>
+
+<section class="panel">
+  <h2>Processes</h2>
+  <% if @processes.empty? %>
+    <p class="empty">No process has registered. Start one with <code>solid_objects start</code>.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr><th>Kind</th><th>Host</th><th>PID</th><th>State</th><th>Last heartbeat</th></tr>
+      </thead>
+      <tbody>
+        <% @processes.each do |process_record| %>
+          <tr>
+            <td><%= h(process_record.kind) %></td>
+            <td><%= h(process_record.hostname) %></td>
+            <td><%= h(process_record.pid) %></td>
+            <td><%= status_label(process_record.shutdown_state) %></td>
+            <td><%= relative_time(process_record.last_heartbeat_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</section>
+
+<section class="panel">
+  <h2>Recent dead letters</h2>
+  <% if @dead_letters.empty? %>
+    <p class="empty">No message has exhausted its attempts.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr><th>Actor</th><th>Operation</th><th>Exception</th><th>Last failed</th></tr>
+      </thead>
+      <tbody>
+        <% @dead_letters.each do |dead_letter| %>
+          <tr>
+            <td><a href="<%= h(path_to("/dead_letters/#{dead_letter.id}")) %>"><%= actor_label(dead_letter) %></a></td>
+            <td><%= h(dead_letter.operation) %></td>
+            <td><%= h(dead_letter.exception_class) %></td>
+            <td><%= relative_time(dead_letter.last_failed_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</section>

data/web/views/dead_letter.erb

@@ -0,0 +1,40 @@
+<section class="panel">
+  <div class="panel-head">
+    <h2><%= h(@dead_letter.operation) %></h2>
+    <div class="actions">
+      <a href="<%= h(path_to("/instances/#{@dead_letter.instance_id}")) %>"><%= actor_label(@dead_letter) %></a>
+      <% if @dead_letter.retried_message_id %>
+        <a href="<%= h(path_to("/messages/#{@dead_letter.retried_message_id}")) %>">Retried</a>
+      <% else %>
+        <%= form_to("/dead_letters/#{@dead_letter.id}/retry") %>
+          <button type="submit">Retry</button>
+        </form>
+      <% end %>
+    </div>
+  </div>
+
+  <% if @error %>
+    <p class="note note-error">The retry was refused. <%= h(@error) %></p>
+  <% end %>
+
+  <p class="note">
+    A retry enqueues the original operation again under an idempotency key, so
+    pressing it twice produces one message rather than two.
+  </p>
+
+  <dl class="attributes">
+    <div><dt>Attempts</dt><dd><%= number(@dead_letter.attempts) %></dd></div>
+    <div><dt>Exception</dt><dd><%= h(@dead_letter.exception_class) %></dd></div>
+    <div><dt>First failed</dt><dd><%= relative_time(@dead_letter.first_failed_at) %></dd></div>
+    <div><dt>Last failed</dt><dd><%= relative_time(@dead_letter.last_failed_at) %></dd></div>
+  </dl>
+
+  <h3>Message</h3>
+  <pre class="payload"><%= h(truncate(@dead_letter.exception_message)) %></pre>
+
+  <h3>Arguments</h3>
+  <%= json_block(@dead_letter.arguments) %>
+
+  <h3>Backtrace</h3>
+  <pre class="payload"><%= h(truncate(Array(@dead_letter.backtrace).join("\n"))) %></pre>
+</section>

data/web/views/dead_letters.erb

@@ -0,0 +1,42 @@
+<section class="panel">
+  <h2>Dead letters</h2>
+
+  <% if @paginator.records.empty? %>
+    <p class="empty">No message has exhausted its attempts.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr>
+          <th>Actor</th>
+          <th>Operation</th>
+          <th>Exception</th>
+          <th>Attempts</th>
+          <th>Last failed</th>
+          <th>Retry</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @paginator.records.each do |dead_letter| %>
+          <tr>
+            <td><a href="<%= h(path_to("/dead_letters/#{dead_letter.id}")) %>"><%= actor_label(dead_letter) %></a></td>
+            <td><%= h(dead_letter.operation) %></td>
+            <td><%= h(dead_letter.exception_class) %></td>
+            <td><%= number(dead_letter.attempts) %></td>
+            <td><%= relative_time(dead_letter.last_failed_at) %></td>
+            <td>
+              <% if dead_letter.retried_message_id %>
+                <a href="<%= h(path_to("/messages/#{dead_letter.retried_message_id}")) %>">retried</a>
+              <% else %>
+                <%= form_to("/dead_letters/#{dead_letter.id}/retry") %>
+                  <button type="submit">Retry</button>
+                </form>
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <%= erb(:_paging) %>
+</section>

data/web/views/effects.erb

@@ -0,0 +1,35 @@
+<section class="panel">
+  <h2>Effects</h2>
+  <%= erb(:_status_filter, statuses: SolidObjects::Web::Statistics::EFFECT_STATUSES, selected: @status) %>
+
+  <% if @paginator.records.empty? %>
+    <p class="empty">No effect matches this filter.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Actor</th>
+          <th>Status</th>
+          <th>Attempts</th>
+          <th>Available</th>
+          <th>Completed</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @paginator.records.each do |effect| %>
+          <tr>
+            <td><%= h(effect.name) %></td>
+            <td><a href="<%= h(path_to("/instances/#{effect.instance_id}")) %>">instance <%= number(effect.instance_id) %></a></td>
+            <td><%= status_label(effect.status) %></td>
+            <td><%= number(effect.attempt_count) %> / <%= number(effect.max_attempts) %></td>
+            <td><%= relative_time(effect.available_at) %></td>
+            <td><%= relative_time(effect.completed_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <%= erb(:_paging) %>
+</section>

data/web/views/instance.erb

@@ -0,0 +1,139 @@
+<section class="panel">
+  <div class="panel-head">
+    <h2><%= actor_label(@instance) %></h2>
+    <div class="actions">
+      <%= status_label(lease_state(@instance)) %>
+      <% if @instance.paused_at %>
+        <%= form_to("/instances/#{@instance.id}/resume") %>
+          <button type="submit">Resume</button>
+        </form>
+      <% else %>
+        <%= form_to("/instances/#{@instance.id}/pause") %>
+          <button type="submit" class="danger">Pause</button>
+        </form>
+      <% end %>
+    </div>
+  </div>
+
+  <p class="note">
+    A paused instance is not claimed again. A pass already in flight finishes its
+    turn, and a synchronous caller waiting on this instance times out rather than
+    receiving a result.
+  </p>
+
+  <dl class="attributes">
+    <div><dt>State version</dt><dd><%= number(@instance.state_version) %></dd></div>
+    <div><dt>Next sequence</dt><dd><%= number(@instance.next_message_sequence) %></dd></div>
+    <div><dt>Activation generation</dt><dd><%= number(@instance.activation_generation) %></dd></div>
+    <div><dt>Activation owner</dt><dd><%= h(@instance.activation_owner_id || "none") %></dd></div>
+    <div><dt>Lease expires</dt><dd><%= relative_time(@instance.activation_expires_at) %></dd></div>
+    <div><dt>Last used</dt><dd><%= relative_time(@instance.last_used_at) %></dd></div>
+    <div><dt>Last claimed</dt><dd><%= relative_time(@instance.last_claimed_at) %></dd></div>
+    <div><dt>Paused</dt><dd><%= relative_time(@instance.paused_at) %></dd></div>
+  </dl>
+
+  <h3>State</h3>
+  <%= json_block(@instance.state) %>
+</section>
+
+<section class="panel">
+  <h2>Mailbox</h2>
+  <%= erb(:_messages, title: "Ready", messages: @ready_messages, empty: "No message is waiting.") %>
+  <%= erb(:_messages, title: "Claimed", messages: @claimed_messages, empty: "No message is claimed.") %>
+  <%= erb(:_messages, title: "Recent", messages: @recent_messages, empty: "This instance has no message history.") %>
+</section>
+
+<section class="panel">
+  <h2>Reminders</h2>
+  <% if @reminders.empty? %>
+    <p class="empty">No reminder is scheduled.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr><th>Name</th><th>Operation</th><th>Status</th><th>Next run</th><th>Interval</th></tr>
+      </thead>
+      <tbody>
+        <% @reminders.each do |reminder| %>
+          <tr>
+            <td><%= h(reminder.name) %></td>
+            <td><%= h(reminder.operation) %></td>
+            <td><%= status_label(reminder.status) %></td>
+            <td><%= relative_time(reminder.next_run_at) %></td>
+            <td><%= duration(reminder.interval_seconds) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</section>
+
+<section class="panel">
+  <h2>Effects</h2>
+  <% if @effects.empty? %>
+    <p class="empty">This instance has emitted no effect.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr><th>Name</th><th>Status</th><th>Attempts</th><th>Available</th><th>Completed</th></tr>
+      </thead>
+      <tbody>
+        <% @effects.each do |effect| %>
+          <tr>
+            <td><%= h(effect.name) %></td>
+            <td><%= status_label(effect.status) %></td>
+            <td><%= number(effect.attempt_count) %> / <%= number(effect.max_attempts) %></td>
+            <td><%= relative_time(effect.available_at) %></td>
+            <td><%= relative_time(effect.completed_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</section>
+
+<section class="panel">
+  <h2>Broadcasts</h2>
+  <% if @broadcasts.empty? %>
+    <p class="empty">This instance has broadcast nothing.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr><th>Observable</th><th>Status</th><th>State version</th><th>Attempts</th><th>Delivered</th></tr>
+      </thead>
+      <tbody>
+        <% @broadcasts.each do |broadcast| %>
+          <tr>
+            <td><%= h(broadcast.observable_name) %></td>
+            <td><%= status_label(broadcast.status) %></td>
+            <td><%= number(broadcast.state_version) %></td>
+            <td><%= number(broadcast.attempt_count) %></td>
+            <td><%= relative_time(broadcast.delivered_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</section>
+
+<section class="panel">
+  <h2>Dead letters</h2>
+  <% if @dead_letters.empty? %>
+    <p class="empty">No message has exhausted its attempts.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr><th>Operation</th><th>Exception</th><th>Attempts</th><th>Last failed</th></tr>
+      </thead>
+      <tbody>
+        <% @dead_letters.each do |dead_letter| %>
+          <tr>
+            <td><a href="<%= h(path_to("/dead_letters/#{dead_letter.id}")) %>"><%= h(dead_letter.operation) %></a></td>
+            <td><%= h(dead_letter.exception_class) %></td>
+            <td><%= number(dead_letter.attempts) %></td>
+            <td><%= relative_time(dead_letter.last_failed_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</section>

data/web/views/instances.erb

@@ -0,0 +1,49 @@
+<section class="panel">
+  <h2>Instances</h2>
+
+  <form class="filters-form" method="get" action="<%= h(path_to("/instances")) %>">
+    <label>
+      Actor type
+      <input type="search" name="actor_type" list="actor-types" value="<%= h(url_params("actor_type")) %>" />
+    </label>
+    <datalist id="actor-types">
+      <% @actor_types.each do |actor_type| %>
+        <option value="<%= h(actor_type) %>"></option>
+      <% end %>
+    </datalist>
+    <label>
+      Actor id contains
+      <input type="search" name="actor_id" value="<%= h(url_params("actor_id")) %>" />
+    </label>
+    <button type="submit">Filter</button>
+  </form>
+
+  <% if @paginator.records.empty? %>
+    <p class="empty">No instance matches this filter.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr>
+          <th>Actor</th>
+          <th>Lease</th>
+          <th>State version</th>
+          <th>Next sequence</th>
+          <th>Last used</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @paginator.records.each do |instance| %>
+          <tr data-instance-row="<%= h(instance.id) %>">
+            <td><%= instance_link(instance) %></td>
+            <td><%= status_label(lease_state(instance)) %></td>
+            <td><%= number(instance.state_version) %></td>
+            <td><%= number(instance.next_message_sequence) %></td>
+            <td><%= relative_time(instance.last_used_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <%= erb(:_paging) %>
+</section>

data/web/views/layout.erb

@@ -0,0 +1,22 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="robots" content="noindex, nofollow" />
+    <title>Solid Objects</title>
+    <link rel="stylesheet" href="<%= h(path_to("/stylesheets/application.css")) %>" />
+    <script src="<%= h(path_to("/javascripts/application.js")) %>" nonce="<%= h(csp_nonce) %>" defer></script>
+    <% if SolidObjects::Web.charts? && current_tab?("/") %>
+      <script src="<%= h(chart_library_source) %>"<%= chart_library_integrity_attributes %> defer></script>
+      <script src="<%= h(path_to("/javascripts/charts.js")) %>" nonce="<%= h(csp_nonce) %>" defer></script>
+    <% end %>
+  </head>
+  <body data-stats-path="<%= h(path_to("/stats")) %>">
+    <%= erb(:_navigation) %>
+    <main class="page">
+      <%= erb(:_summary) %>
+      <%= locals.fetch(:content) %>
+    </main>
+  </body>
+</html>

data/web/views/mailbox.erb

@@ -0,0 +1,35 @@
+<section class="panel">
+  <h2>Mailbox</h2>
+  <%= erb(:_status_filter, statuses: SolidObjects::Web::Application::MAILBOX_MEMBERSHIPS, selected: @membership, all: false) %>
+
+  <% if @paginator.records.empty? %>
+    <p class="empty">No message is <%= h(@membership) %>.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr>
+          <th>Actor</th>
+          <th>Sequence</th>
+          <th>Operation</th>
+          <th>Delivery</th>
+          <th>Attempts</th>
+          <th>Available</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @paginator.records.each do |message| %>
+          <tr>
+            <td><a href="<%= h(path_to("/instances/#{message.instance_id}")) %>"><%= actor_label(message) %></a></td>
+            <td><a href="<%= h(path_to("/messages/#{message.id}")) %>"><%= number(message.sequence) %></a></td>
+            <td><%= h(message.operation) %></td>
+            <td><%= status_label(message.delivery_mode) %></td>
+            <td><%= number(message.attempt_count) %> / <%= number(message.max_attempts) %></td>
+            <td><%= relative_time(message.available_at) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <%= erb(:_paging) %>
+</section>

data/web/views/message.erb

@@ -0,0 +1,34 @@
+<section class="panel">
+  <div class="panel-head">
+    <h2><%= h(@message.operation) %></h2>
+    <div class="actions">
+      <%= status_label(@message.delivery_mode) %>
+      <a href="<%= h(path_to("/instances/#{@message.instance_id}")) %>"><%= actor_label(@message) %></a>
+    </div>
+  </div>
+
+  <dl class="attributes">
+    <div><dt>Sequence</dt><dd><%= number(@message.sequence) %></dd></div>
+    <div><dt>Attempts</dt><dd><%= number(@message.attempt_count) %> / <%= number(@message.max_attempts) %></dd></div>
+    <div><dt>Request id</dt><dd><%= h(@message.request_id) %></dd></div>
+    <div><dt>Idempotency key</dt><dd><%= h(@message.idempotency_key || "none") %></dd></div>
+    <div><dt>Enqueued</dt><dd><%= relative_time(@message.enqueued_at) %></dd></div>
+    <div><dt>Available</dt><dd><%= relative_time(@message.available_at) %></dd></div>
+    <div><dt>Started</dt><dd><%= relative_time(@message.started_at) %></dd></div>
+    <div><dt>Completed</dt><dd><%= relative_time(@message.completed_at) %></dd></div>
+    <div><dt>Rejected</dt><dd><%= relative_time(@message.rejected_at) %></dd></div>
+    <div><dt>Last failed</dt><dd><%= relative_time(@message.last_failed_at) %></dd></div>
+  </dl>
+
+  <h3>Arguments</h3>
+  <%= json_block(@message.arguments) %>
+
+  <h3>Result</h3>
+  <%= json_block(@message.result) %>
+
+  <h3>Error</h3>
+  <%= json_block(@message.error) %>
+
+  <h3>Rejection</h3>
+  <%= json_block(@message.rejection) %>
+</section>

data/web/views/processes.erb

@@ -0,0 +1,37 @@
+<section class="panel">
+  <h2>Processes</h2>
+  <%= erb(:_status_filter, statuses: SolidObjects::Web::Statistics::PROCESS_STATES, selected: @status) %>
+
+  <% if @paginator.records.empty? %>
+    <p class="empty">No process matches this filter.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr>
+          <th>Kind</th>
+          <th>Host</th>
+          <th>PID</th>
+          <th>State</th>
+          <th>Started</th>
+          <th>Last heartbeat</th>
+          <th>Activated instances</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @paginator.records.each do |process_record| %>
+          <tr>
+            <td><%= h(process_record.kind) %></td>
+            <td><%= h(process_record.hostname) %></td>
+            <td><%= h(process_record.pid) %></td>
+            <td><%= status_label(process_record.shutdown_state) %></td>
+            <td><%= relative_time(process_record.started_at) %></td>
+            <td><%= relative_time(process_record.last_heartbeat_at) %></td>
+            <td><%= number(@activated_counts.fetch(process_record.id, 0)) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <%= erb(:_paging) %>
+</section>

data/web/views/reminders.erb

@@ -0,0 +1,37 @@
+<section class="panel">
+  <h2>Reminders</h2>
+  <%= erb(:_status_filter, statuses: SolidObjects::Web::Statistics::REMINDER_STATUSES, selected: @status) %>
+
+  <% if @paginator.records.empty? %>
+    <p class="empty">No reminder matches this filter.</p>
+  <% else %>
+    <table>
+      <thead>
+        <tr>
+          <th>Actor</th>
+          <th>Name</th>
+          <th>Operation</th>
+          <th>Status</th>
+          <th>Next run</th>
+          <th>Interval</th>
+          <th>Occurrence</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @paginator.records.each do |reminder| %>
+          <tr>
+            <td><a href="<%= h(path_to("/instances/#{reminder.instance_id}")) %>"><%= actor_label(reminder) %></a></td>
+            <td><%= h(reminder.name) %></td>
+            <td><%= h(reminder.operation) %></td>
+            <td><%= status_label(reminder.status) %></td>
+            <td><%= relative_time(reminder.next_run_at) %></td>
+            <td><%= duration(reminder.interval_seconds) %></td>
+            <td><%= number(reminder.occurrence) %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <%= erb(:_paging) %>
+</section>