Overview

Reports allow you to generate custom insights by transforming your logs into interactive charts and detailed reports. Create dashboards with multiple widgets to visualize trends, track metrics, and share insights with your team.

What Are Reports?

A report is a customizable dashboard that:

• Contains multiple widgets (charts, tables, stats)
• Pulls data from your project logs
• Can be private or public
• Allows drag-and-drop layout customization
• Updates in real-time based on log data

Common Use Cases

• System Monitoring - Track CPU, memory, disk usage over time
• Error Tracking - Visualize error rates and critical issues
• Performance Dashboards - Monitor response times and throughput
• Business Metrics - Track user activity, conversions, orders
• Public Status Pages - Share system health publicly

Reports Dashboard

Navigate to Reports from the sidebar to access your reports.

Page Layout

Page Title: "Reports"
Description: "Generate custom insights by transforming your logs into interactive charts and detailed reports"

Reports List

Each report is displayed as a list item showing:

• Report Title - Clickable link to the report dashboard
• Visibility Badge - Shows "PRIVATE" or "PUBLIC"
• Public Link Icon - For public reports only, opens the public URL in a new tab

Report Actions

Each report has action icons:

• Edit (pencil icon) - Opens the edit modal to change title or visibility
• Delete (trash icon) - Removes the report after confirmation
• Link (link icon) - Opens public URL (PUBLIC reports only)

Empty State

When no reports exist:

• Message: No custom message (standard empty list)
• Create your first report using the Create button

Report Visibility

Reports can have two visibility settings:

Private

• Only accessible to authenticated users in the dashboard
• Viewed at /dashboard/reports/:slug
• No public sharing link
• Default for new reports

Public

• Accessible without login at /reports/:slug
• Can be shared with anyone via public URL
• Shown with a link icon in reports list
• Useful for status pages and stakeholder dashboards

Creating Reports

Click the Create button (top-right) to create a new report.

You'll configure:

• Report Title - Descriptive name for the report
• Visibility - Private or Public

See Creating & Managing Reports for detailed instructions.

Report Widgets

Reports contain widgets that visualize your log data.

Available Widget Types

• Total Value - Display a single metric (count, sum, average, etc.)
• Line Chart - Show trends over time
• Bar Chart - Compare values across groups
• Table - Display detailed log entries
• Pie Chart - Show distribution of values

Each widget pulls data from a selected project and can be customized with filters, time ranges, and display options.

See Report Widgets for detailed widget configuration.

Report Layout

Dashboard View (Owner)

When you open a report at /dashboard/reports/:slug:

• Drag widgets to reposition them
• Resize widgets by dragging corners
• Add widgets using the "Create Widget" button
• Edit/Delete widgets using widget action icons
• Refresh widgets to update data

Layout changes are saved automatically.

Public View

When viewing a public report at /reports/:slug:

• Widgets are read-only (no editing)
• No drag-and-drop or resize
• No action icons (refresh, edit, delete)
• Clean view for sharing

Pagination

The reports list supports pagination when you have many reports. Use pagination controls at the bottom to navigate between pages (50 reports per page).