Dashboard & UI

The LogPulse dashboard provides a unified interface for searching, analyzing, and visualizing your log data. It is built around three core components: the Log Explorer for ad-hoc search and investigation, Saved Searches for reusable queries, and Custom Dashboards for persistent monitoring views.

All dashboard components support dark mode, responsive layouts, and real-time data updates. The interface is designed for both keyboard-driven workflows and point-and-click operation.

Log Explorer

The Log Explorer is the primary interface for searching and analyzing logs. It consists of a search bar, a results timeline, a log list, and a detail panel.

Time Range Picker

The time range picker sits in the top-right corner of the Log Explorer. It supports both relative ranges (last 15 minutes, last 1 hour, last 24 hours) and absolute ranges with a calendar picker. You can also type custom relative expressions such as "last 3h" or "last 7d".

PresetDurationUse Case
Last 15 minutes15mReal-time debugging and tailing
Last 1 hour1hRecent incident investigation
Last 4 hours4hShift-level monitoring
Last 24 hours24hDaily review and trend analysis
Last 7 days7dWeekly patterns and capacity planning
Custom rangeVariableSpecific incident windows or compliance audits

Live Tail Mode

Live Tail streams new log entries to your browser in real time. It is useful for monitoring deployments, debugging issues as they occur, or watching the output of a specific service. Click the Live Tail toggle in the search bar or press Alt+T to activate it.

Live Tail respects your current LPQL query, so you can filter the stream to show only relevant entries. The stream pauses automatically when you scroll up to inspect a log entry and resumes when you scroll back to the bottom.

Note
Live Tail uses WebSocket connections and consumes bandwidth proportional to your log throughput. For high-volume sources, add filters to reduce the stream volume.

Field Sidebar

The field sidebar on the left side of the Log Explorer shows all fields detected in your current result set. Each field displays a distribution of its top values and the percentage of logs containing that field. Click a field value to add it as a filter, or click the field name to toggle column visibility in the log list.

Log Detail Panel

Click any log entry to open the detail panel. The panel shows the complete log record including all attributes, the raw JSON payload, and contextual links. From the detail panel you can copy the log ID, copy the raw JSON, or click "Show surrounding logs" to view logs from the same source within a narrow time window.

Saved Searches

Saved Searches let you store frequently used LPQL queries for quick access. Each saved search preserves the query text, the selected time range mode (relative or absolute), and any column layout customizations.

Creating a Saved Search

1. Run your LPQL query in the Log Explorer.

2. Click the Save button (or press Cmd+S / Ctrl+S) in the search bar.

3. Enter a name and optional description for the saved search.

4. Choose visibility: Private (only you) or Team (visible to all team members).

5. Click Save.

Managing Saved Searches

Access your saved searches from the Saved Searches tab in the left sidebar. You can edit, duplicate, or delete any search you own. Team searches can be edited by any team member with the Admin or Owner role.

Saved searches can also be pinned to the top of the sidebar for quick access. Pinned searches appear in the order you pinned them and persist across sessions.

Custom Dashboards

Custom dashboards let you compose multiple widgets into a persistent monitoring view. Each dashboard has a configurable grid layout, auto-refresh interval, and shared time range.

Creating a Dashboard

Navigate to Dashboards in the left sidebar and click New Dashboard. Give it a name, set the default time range, and configure the auto-refresh interval (off, 30s, 1m, 5m, or 15m). The dashboard starts with an empty canvas where you can add widgets.

Adding Widgets

Click Add Widget to open the widget builder. Select a widget type, enter a LPQL query, configure the visualization options, and set the widget title. Widgets automatically inherit the dashboard time range but can be overridden individually.

Widgets are arranged on a 12-column responsive grid. Drag widgets to reposition them, or drag their edges to resize. The minimum widget size is 3 columns wide and 2 rows tall.

Auto-Refresh

When auto-refresh is enabled, all widgets on the dashboard re-execute their queries at the configured interval. The refresh cycle is staggered across widgets to avoid simultaneous query load. A countdown indicator in the dashboard header shows the time until the next refresh.

Widget Types

LogPulse supports six widget types, each suited to different monitoring and analysis use cases.

WidgetDescriptionBest For
CounterDisplays a single numeric value from an aggregation query. Supports threshold-based coloring (green/yellow/red).Error counts, request totals, active users
TimechartLine or area chart showing values over time. Supports multiple series, stacking, and logarithmic scale.Throughput trends, error rate over time, latency percentiles
TableTabular display of query results with sortable columns and pagination.Top error messages, per-service breakdowns, recent events
Pie ChartProportional display of categorical data. Supports up to 10 slices with an "Other" bucket.Error distribution by type, traffic by region, log level breakdown
Bar ChartHorizontal or vertical bar chart for comparing values across categories.Service comparison, per-environment error counts, top sources
Stat CardCompact card showing a value with a sparkline and trend indicator (up/down/flat arrow with percentage).KPI monitoring, at-a-glance health metrics

Configuration Options

All widgets share a common set of configuration options:

OptionDescriptionDefault
TitleDisplay title shown above the widgetRequired
LPQL QueryThe query that provides data to the widgetRequired
Time Range OverrideOverride the dashboard time range for this widgetInherit from dashboard
Refresh OverrideOverride the dashboard refresh interval for this widgetInherit from dashboard
ThresholdsColor thresholds for Counter and Stat Card widgets (green/yellow/red boundaries)None
Legend PositionPosition of the legend for chart widgets (top, bottom, right, hidden)Bottom
Max SeriesMaximum number of series to display in chart widgets10

Filters & Context

Persistent Filters

Persistent filters apply to all queries across the Log Explorer and dashboards. They are useful for scoping your view to a specific environment, service, or deployment. Set persistent filters from the filter bar at the top of the page.

Common persistent filter patterns include filtering by environment (production, staging, development), by service name, by region, or by deployment version. Persistent filters are saved to your user profile and apply across sessions.

Context Switching

Use the context switcher in the top navigation bar to switch between environments or services. The context switcher updates all persistent filters simultaneously, allowing you to quickly move between different scopes without manually adjusting each filter.

Context examples
# Production context
environment=production

# Staging context for a specific service
environment=staging source=payment-service

# Regional context
environment=production attributes.region=eu-west-1

Keyboard Shortcuts

LogPulse supports keyboard shortcuts for common actions. All shortcuts are shown with macOS bindings below; on Windows and Linux, replace Cmd with Ctrl.

ShortcutActionContext
/Focus the search barGlobal
Cmd+KOpen the command paletteGlobal
Cmd+EnterRun the current LPQL querySearch bar
EscClose the current panel or modalGlobal
Cmd+SSave the current searchLog Explorer
Alt+TToggle Live Tail modeLog Explorer
J / KNavigate down / up in the log listLog list
EnterOpen the detail panel for the selected logLog list
Cmd+Shift+CCopy the selected log as JSONDetail panel
Cmd+/Show all keyboard shortcutsGlobal
Cmd+DToggle dark modeGlobal
Cmd+Shift+FToggle fullscreen modeDashboard

Sharing & Collaboration

Shareable URLs

Every view in LogPulse generates a shareable URL that encodes the current query, time range, and column layout. Share these URLs with team members to provide exact context for an investigation. Relative time ranges are preserved in the URL, so a link with "last 1 hour" always shows the most recent hour when opened.

To share a specific absolute time range (for example, during an incident), click the Share button and select "Lock time range." This generates a URL with absolute timestamps that always shows the same data.

Export to CSV / JSON

Export query results from the Log Explorer or any Table widget by clicking the Export button. Choose between CSV (for spreadsheet tools) or JSON (for programmatic processing). Exports include all columns visible in the current view and respect the active time range and filters.

Note
Exports are limited to 100,000 rows. For larger exports, use the HTTP API with pagination or configure a scheduled export in Data Retention settings.

Team Dashboards

Dashboards can be shared with your entire team by setting their visibility to Team. Team dashboards appear in a shared section of the Dashboards list and can be edited by any team member with the Admin or Owner role. Members and Viewers can view team dashboards but cannot modify them.

Dark Mode & Themes

LogPulse supports light and dark color schemes. The theme can be set to Light, Dark, or System (follows your operating system preference). Toggle the theme using the sun/moon icon in the top navigation bar or the keyboard shortcut Cmd+D.

All UI components, charts, and code blocks are designed with both themes in mind. Dashboard widgets automatically adapt their color palettes to maintain readability in both modes.

Tip
For presentations or screen sharing, use the Light theme for better visibility on projectors. For extended monitoring sessions, the Dark theme reduces eye strain.

Mobile & Responsive

The LogPulse dashboard is fully responsive and works on tablets and mobile devices. On smaller screens, the layout automatically adjusts: the sidebar collapses into a slide-out drawer, dashboard widgets stack vertically, and the Log Explorer switches to a compact view.

BreakpointWidthLayout Changes
Desktop1280px and aboveFull layout with sidebar, TOC, and multi-column dashboard grid
Tablet768px to 1279pxSidebar collapses, dashboard grid reduces to 2 columns, TOC hidden
MobileBelow 768pxSlide-out navigation, single-column layout, simplified log list

Touch gestures are supported for common interactions: swipe to dismiss panels, pinch to zoom on charts, and long-press to access context menus.