Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions sqlite-cloud/_nav.ts
Original file line number Diff line number Diff line change
Expand Up @@ -299,6 +299,7 @@ const sidebarNav: SidebarNavStruct = [
},
{ title: "Backups", filePath: "backups", type: "inner", level: 0 },
{ title: "Query Analyzer", filePath: "analyzer", type: "inner", level: 0 },
{ title: "Logs", filePath: "logs", type: "inner", level: 0 },
{ title: "Extensions", filePath: "extensions", type: "inner", level: 0 },
{ title: "Weblite (REST API)", filePath: "weblite", type: "inner", level: 0 },

Expand Down
84 changes: 84 additions & 0 deletions sqlite-cloud/platform/logs.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
---
title: Logs
description: View detailed insights into your SQLite Cloud project's operations to monitor activity, debug issues, and track system behavior in real time.
category: platform
status: publish
slug: logs
---
import VideoPlayer from '@commons-components/Video/VideoPlayer.astro';
import logsVideo from '@docs-website-assets/introduction/video/dashboard_logs.mp4';


Logs provide detailed insights into your SQLite Cloud project's operations, helping you monitor activity, debug issues, and track system behavior in real time. The Logs panel displays a comprehensive view of all events occurring across your cluster nodes.


---

## Key Features

- **Log Monitoring**: View recent log entries with manual refresh capability to get the latest activity
- **Filtering Options**: Filter logs by time range, specific nodes, and search through messages
- **Detailed Context**: Each log entry includes timestamp, severity level, source, and detailed message information

<VideoPlayer src={logsVideo} />

---

## Accessing Logs

Navigate to the **Logs** section from your SQLite Cloud dashboard to view your project's log entries. The interface displays logs in a table format with the following columns:

- **Time**: Timestamp when the event occurred (in UTC)
- **Level**: Severity level of the log entry
- **Source**: Component or service that generated the log
- **Log Type**: Category of the log entry
- **Message**: Detailed description of the logged event

---

## Filtering Logs

### Timestamp Range

Use the timestamp range selector to filter logs by time period. Available options include:

- Last 30 minutes
- Last hour
- Last 12 hours
- Last day
- Last 3 days
- Last week
- Last 2 weeks
- Last 30 days
- Custom date range (using the calendar picker)

### Node Filtering

Filter logs by specific cluster nodes using the **Nodes** section on the left sidebar. You can:

- Search for specific nodes using the search box
- Select individual nodes to view their logs
- View the node location (e.g., US East)

### Search Logs

Use the search box at the top of the logs table to filter entries by message content. This helps you quickly locate specific errors or events.

---

## Viewing Log Details

Click on any log entry to view detailed information in the **Log Details** panel. This panel displays:

- **Timestamp**: Exact time of the event
- **Level**: Severity level
- **Source**: Originating component
- **Node ID**: Specific node that generated the log
- **Log Type**: Category of the event
- **Message**: Full message with complete error details or event information

---

## Refreshing Logs

Click the **Refresh** button in the top-right corner to manually update the log list and view the most recent entries. This ensures you're viewing the latest activity from your cluster.