CLI Reference

npm install -g logpare

npx logpare server.log

logpare [options] [files...]

logpare server.log

logpare access.log error.log debug.log

cat /var/log/syslog | logpare

tail -f app.log | logpare

journalctl -u myapp | logpare

# Summary format (default)
logpare server.log

# Detailed format with all metadata
logpare --format detailed server.log

# JSON format for programmatic processing
logpare --format json server.log

# Write to file
logpare --output compressed.txt server.log

# JSON to file
logpare -f json -o result.json server.log

# Use with pipes
cat access.log | logpare -o summary.txt

# Shallow depth for simple logs
logpare --depth 3 system.log

# Deep depth for complex logs
logpare --depth 6 application.log

# More aggressive grouping
logpare --threshold 0.3 noisy.log

# More conservative grouping
logpare --threshold 0.5 structured.log

# Limit for memory efficiency
logpare --max-children 50 huge.log

# Cap templates for large files
logpare --max-clusters 500 large.log

# Show only top 20 templates
logpare --max-templates 20 server.log

# Show all templates
logpare --max-templates 0 server.log

logpare --help

logpare --version

# Compress a log file
logpare server.log

# Output:
# === Log Compression Summary ===
# Input: 10,847 lines → 23 templates (99.8% reduction)
#
# Top templates by frequency:
# 1. [4,521x] INFO Connection from <*> established
# 2. [3,892x] DEBUG Request <*> processed in <*>

logpare --format detailed error.log

# Output:
# === Detailed Compression Results ===
#
# Template #1 (450 occurrences)
#   Pattern: ERROR Connection to <*> failed
#   Severity: error
#   First seen: line 1
#   Last seen: line 998
#   Sample values: [["192.168.1.100"], ["192.168.1.101"]]
#   URLs: api.example.com, cdn.example.com
#   Status codes: 500, 503

logpare --format json server.log > result.json

# Process with jq
logpare -f json server.log | jq '.templates[] | select(.severity == "error")'

# Pretty print
logpare -f json server.log | jq .

# Compress recent logs
tail -1000 /var/log/syslog | logpare

# Monitor live logs
tail -f app.log | logpare

# Compress journal logs
journalctl -u nginx | logpare -f detailed

# Kubernetes pod logs
kubectl logs my-pod | logpare

# Docker container logs
docker logs my-container | logpare

# High compression (fewer templates)
logpare --depth 3 --threshold 0.3 noisy.log

# High fidelity (more templates)
logpare --depth 6 --threshold 0.5 structured.log

# Memory-efficient
logpare --max-clusters 500 --max-children 50 huge.log

export LOGPARE_DEPTH=5
logpare server.log  # Uses depth=5

export LOGPARE_THRESHOLD=0.3
logpare server.log  # Uses threshold=0.3

export LOGPARE_FORMAT=detailed
logpare server.log  # Uses detailed format

# Option 1: Use npx
npx logpare server.log

# Option 2: Install globally
npm install -g logpare

# Option 3: Use npm exec
npm exec logpare server.log

# Reduce memory usage
logpare --max-clusters 500 --max-children 50 huge.log

# Or process in chunks
head -100000 huge.log | logpare