reqlog

README

reqlog

Search and trace requests across microservices, files, and Docker logs — fast.
Debug distributed systems using simple key/value search (e.g. request_id, trace_id) without relying on centralized tracing.

Installation

Go Install

go install github.com/sagarmaheshwary/reqlog/cmd/reqlog@latest

macOS / Linux

curl -sSL https://raw.githubusercontent.com/sagarmaheshwary/reqlog/master/install.sh | bash

• Auto-detects OS/arch
• Installs latest version
• Installs to /usr/local/bin

Verify:

reqlog -v

Windows

Download from:

https://github.com/sagarmaheshwary/reqlog/releases

Then:

• unzip
• add to PATH

Verify:

reqlog -v

Quick Start

Search logs using common request tracing keys like: request_id, req_id, trace_id, and correlation_id.

Search log files:

reqlog abc123

Search Docker containers:

reqlog -S docker abc123

Example output:

2026-03-20T14:10:01.000Z [api-gateway]       | calling order service level=info request_id=abc123
2026-03-20T14:10:02.000Z [order-service]     | fetching order level=info request_id=abc123
2026-03-20T14:10:03.000Z [inventory-service] | checking stock level=info request_id=abc123

Usage

reqlog [flags] <search_value>

Basic Search

reqlog abc123

reqlog searches ./logs by default.

Key-Based Search

reqlog -k request_id abc123
reqlog -k event_key order.created

Log Format Detection

reqlog automatically detects JSON logs by default.

reqlog -k trace_id trace-123

Force JSON or text parsing explicitly when needed:

reqlog --format json abc123
reqlog --format text abc123

Docker Logs

reqlog -S docker -s api-gateway abc123

Service Filtering

reqlog -s order-service abc123

-s filters container names when using Docker logs; otherwise, it filters log file names.

Context Around Matches

Show surrounding log lines before and after each match:

reqlog -c 2 abc123

Limiting Results

Return first N matches per source:

reqlog -n 10 abc123

Tail-style shorthand is also supported:

reqlog -100 abc123

Return globally latest N matches across all sources:

reqlog -l -n 10 abc123

Time Filtering

reqlog --since 10m abc123
reqlog --since 2026-04-29 abc123
reqlog --since 2026-04-29T14:00:00Z abc123
reqlog --since 2026-04-29T14:00:00.123Z abc123
reqlog --since 1710943200 abc123

JSON Output

Structured output for piping and integrations:

reqlog -o json abc123
reqlog -o json abc123 | jq .

Output structure:

{
  "timestamp": "2026-03-20T14:00:05Z",
  "service": "order-service",
  "message": "request started",
  "level": "info",
  "request_id": "abc123"
}

Live Log Streaming

reqlog -f abc123

Full usage guide: docs/usage.md

Why not just use grep?

Problem	grep	reqlog
Multi-file search	⚠️ manual	✅ built-in
Request tracing	❌	✅
JSON logs	❌	✅
Chronological flow	❌	✅
Service context	❌	✅

reqlog = grep for distributed systems

Supported Log Formats

Supported Timestamp Formats

• RFC3339 / ISO-8601
  • with or without fractional seconds
• Unix timestamps
  • seconds (10 digits)
  • milliseconds (13 digits)
  • microseconds (16 digits)
  • nanoseconds (19 digits)

Timestamps are normalized to millisecond precision in output (fixed 3 digits).

Text Logs

• Timestamp must appear as the first field
• Supports key=value fields

2026-03-20T14:00:00Z request_id=abc123 start request
2026-03-20T14:00:00.123Z request_id=abc123 processing
1710943200 request_id=abc123 unix seconds
1710943200123 request_id=abc123 unix milliseconds

JSON Logs

• One JSON object per line
• Supported timestamp fields: time, timestamp, ts

{ "time": "2026-03-20T14:10:00Z", "request_id": "abc", "message": "start" }
{ "time": "2026-03-20T14:10:00.456Z", "request_id": "abc", "message": "processing" }
{ "ts": 1710943200, "request_id": "abc", "message": "unix seconds" }
{ "ts": 1710943200123, "request_id": "abc", "message": "unix milliseconds" }

Roadmap

Core Features

• Flexible timestamp parsing (RFC3339 / RFC3339Nano)
• Text log parsing (key=value)
• JSON log parsing
• Wildcard support in --service (e.g. order-service*)
• Unix timestamp support (logs + --since)
• Optimize --limit (early exit / streaming)
• --latest flag (Return latest N entries globally)
• --context flag (show surrounding lines)
• --output=json for piping and integrations
• --fields flag for JSON logs

Performance & Scalability

• Parallel scanning
• General performance improvements

Integrations

• File logs
• Docker logs
• SSH-based multi-host logs?

Companion web UI for reqlog: https://github.com/sagarmaheshwary/reqlog-ui

Support & Contributions

If you find this project useful, consider giving it a ⭐ — it helps others discover it.

Feedback, contributions, and discussions are very welcome. Feel free to open an issue or submit a PR.

License

MIT