Skip to content
🐋 Cetacean

Dashboard Guide

Cetacean’s UI updates in real time via SSE—when a service scales or a node goes down, the dashboard reflects it without refreshing. The connection indicator in the nav bar shows stream health; if it drops, Cetacean reconnects automatically.

Keyboard Shortcuts

Press ? to see all shortcuts. The highlights:

ShortcutAction
⌘ K / Ctrl KCommand palette (search + actions)
g then s/n/k/…Navigate to services, nodes, stacks, etc.
j/k or /Move through table rows
EnterOpen selected resource

The g shortcuts are chords: Press g, release, then the second key.

Command Palette

⌘ K opens the command palette. Type to search across all resource types, or type an action name (scale, restart, drain, rollback) to trigger write operations with guided steps and confirmation. Actions respect operations level and authorization permissions.

Filtering

List pages support search and expr-lang filter expressions via the API’s ?filter= parameter:

role == "manager" && state == "ready"       # nodes
name contains "web" && mode == "replicated" # services
state == "failed" || error != ""            # tasks

See the API reference for available filter fields per resource type.

Charts

Charts appear on the cluster overview, node, service, task, and stack detail pages. They require monitoring.

  • Click to isolate a series by clicking its name or line, and everything else dims. Click again to restore.
  • Brush to zoom by dragging horizontally. The URL updates so you can share the time window.
  • Linked crosshairs synchronize across all charts in the same panel: hover on one to see values on all siblings.
  • Stacked area toggle switches between line and stacked area views in the chart header.
  • Stack drill-down on the cluster overview: double-click a stack to see its individual services.

Log Viewer

The log viewer on service and task detail pages supports live tailing, time range selection (presets or custom), stream and level filtering, substring/regex search with match navigation, JSON pretty-printing, and log download.

Atom Feeds

Every resource list and detail page shows a feed icon in the page header. Click it to open the Atom feed for that page in a new tab, or copy the URL to subscribe in a feed reader. Feeds include history, search results, and recommendations pages. See the API reference for the full list of supported endpoints and pagination details.

Topology

The topology page offers two views: logical (services grouped by stack, connected by networks) and physical (tasks grouped by node). Both are interactive—click to navigate to detail pages.