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.
Search Bar
The search bar accepts LPQL (LogPulse Query Language) queries. It provides syntax highlighting, auto-completion for field names and operators, and inline error reporting for invalid queries.
# Filter by level and source
level=error source=api-gateway
# Full-text search with aggregation
"connection refused" | stats count by source
# Time-based filtering with field selection
source=auth-service | timechart count by level | limit 100Time 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".
| Preset | Duration | Use Case |
|---|---|---|
| Last 15 minutes | 15m | Real-time debugging and tailing |
| Last 1 hour | 1h | Recent incident investigation |
| Last 4 hours | 4h | Shift-level monitoring |
| Last 24 hours | 24h | Daily review and trend analysis |
| Last 7 days | 7d | Weekly patterns and capacity planning |
| Custom range | Variable | Specific 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.
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.
| Widget | Description | Best For |
|---|---|---|
| Counter | Displays a single numeric value from an aggregation query. Supports threshold-based coloring (green/yellow/red). | Error counts, request totals, active users |
| Timechart | Line or area chart showing values over time. Supports multiple series, stacking, and logarithmic scale. | Throughput trends, error rate over time, latency percentiles |
| Table | Tabular display of query results with sortable columns and pagination. | Top error messages, per-service breakdowns, recent events |
| Pie Chart | Proportional display of categorical data. Supports up to 10 slices with an "Other" bucket. | Error distribution by type, traffic by region, log level breakdown |
| Bar Chart | Horizontal or vertical bar chart for comparing values across categories. | Service comparison, per-environment error counts, top sources |
| Stat Card | Compact 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:
| Option | Description | Default |
|---|---|---|
| Title | Display title shown above the widget | Required |
| LPQL Query | The query that provides data to the widget | Required |
| Time Range Override | Override the dashboard time range for this widget | Inherit from dashboard |
| Refresh Override | Override the dashboard refresh interval for this widget | Inherit from dashboard |
| Thresholds | Color thresholds for Counter and Stat Card widgets (green/yellow/red boundaries) | None |
| Legend Position | Position of the legend for chart widgets (top, bottom, right, hidden) | Bottom |
| Max Series | Maximum number of series to display in chart widgets | 10 |
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.
# Production context
environment=production
# Staging context for a specific service
environment=staging source=payment-service
# Regional context
environment=production attributes.region=eu-west-1Keyboard Shortcuts
LogPulse supports keyboard shortcuts for common actions. All shortcuts are shown with macOS bindings below; on Windows and Linux, replace Cmd with Ctrl.
| Shortcut | Action | Context |
|---|---|---|
| / | Focus the search bar | Global |
| Cmd+K | Open the command palette | Global |
| Cmd+Enter | Run the current LPQL query | Search bar |
| Esc | Close the current panel or modal | Global |
| Cmd+S | Save the current search | Log Explorer |
| Alt+T | Toggle Live Tail mode | Log Explorer |
| J / K | Navigate down / up in the log list | Log list |
| Enter | Open the detail panel for the selected log | Log list |
| Cmd+Shift+C | Copy the selected log as JSON | Detail panel |
| Cmd+/ | Show all keyboard shortcuts | Global |
| Cmd+D | Toggle dark mode | Global |
| Cmd+Shift+F | Toggle fullscreen mode | Dashboard |
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.
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.
| Breakpoint | Width | Layout Changes |
|---|---|---|
| Desktop | 1280px and above | Full layout with sidebar, TOC, and multi-column dashboard grid |
| Tablet | 768px to 1279px | Sidebar collapses, dashboard grid reduces to 2 columns, TOC hidden |
| Mobile | Below 768px | Slide-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.