JSONL Lab

A powerful and intuitive Visual Studio Code extension for viewing and analyzing JSONL (JSON Lines) log files. Transform your log files into an interactive, filterable table interface for easier analysis.

Features

🔍 Smart Log Parsing

• Automatic detection of common log fields (timestamp, level, message, logger)
• Support for various JSONL log formats
• Compatible with standard logging frameworks

📊 Interactive Table View

• Sortable columns
• Multi-level filtering
• Timestamp range filtering
• Full text search across all fields

🎨 Visual Enhancements

• Color-coded log levels
• Formatted JSON detail view
• Optimized column wrapping
• Clean, modern interface

Quick Start

1. Install the extension
2. Open any .jsonl or .ndjson file
3. Start analyzing your logs in the table interface!

Smart Features

Advanced Filtering

• Text Search: Filter logs by any content
• Log Levels: Select multiple levels (debug, info, warn, error, etc.)
• Time Range: Filter by specific date/time ranges
• Combine filters for precise analysis

Intelligent Field Detection

Automatically recognizes common field names:

• Time: timestamp, time, @timestamp, datetime
• Level: level, severity, priority
• Message: message, msg, text, description
• Source: logger, service, component, source

Color-Coded Log Levels

• 🔘 Trace: Gray
• 🔵 Debug: Blue
• 🟢 Info: Green
• 🟡 Warning: Yellow
• 🔴 Error: Red
• 🟣 Critical: Purple
• 🟤 Fatal: Dark Red

Usage Tips

Sorting and Organization

• Click column headers to sort
• Click any row to view complete JSON details
• Use level filters to focus on specific types of logs

Working with Time

• Filter logs by specific time ranges
• Clear time filters with one click
• Automatic timezone handling

Large Files

For optimal performance with large files:

• Use filters to narrow down the data
• Sort by timestamp for chronological analysis
• Use text search to find specific events

Requirements

• Visual Studio Code 1.102.0 or higher

Privacy & Telemetry

JSONL Lab includes optional telemetry to help improve the extension. The telemetry:

• Respects your privacy: Only anonymized usage data is collected
• Follows VS Code settings: Uses your VS Code telemetry preferences
• No personal data: File paths, content, or personal information is never collected
• Transparent: All tracking is clearly documented

You can disable telemetry entirely through VS Code's settings: Settings > Telemetry Level > Off

License

Licensed under CC BY-NC-ND 4.0. See LICENSE for details.

JSONL Lab - Making log analysis a breeze! 🚀