findlog

Command-line tool that finds a failure in a log file and prints the lines around it.

pip install findlog
findlog server.log --around "Connection refused"

Install from source

git clone https://github.com/shauryaR790/findlog-py.git
cd findlog-py
pip install -e ".[dev]"

Commands

findlog server.log --around "Connection refused"
findlog server.log --line 8421
findlog server.log --around "Connection refused" --save
findlog server.log --around "Connection refused" --json
findlog server.log --around "Connection refused" --brief
findlog app.log.gz --around "error"
kubectl logs my-pod | findlog - --around "Connection refused"

What it reports

For a matching line, findlog prints:

• first match line number
• occurrence count
• lines before and after
• other errors and warnings in the same window
• file and line from a stack trace when the log includes one

It groups repeated matches that happen close together into one incident.

It does not guess root cause. It shows what the log contains near the failure.

Options

Exit codes: 0 ok, 1 no match, 2 bad input, 3 file error.

Example

findlog server.log --around "Connection refused"

FINDLOG
------------------------------------

MATCH
  Connection refused

FIRST FAILURE
  line 5

OCCURRENCES
  3

RELATED
  Database connection failed
  Database unavailable

FOLLOWED BY
  line 12  Shutdown

Python API

from findlog import analyze_log

result = analyze_log("server.log", query="Connection refused")
print(result.primary_incident.first_match_line)

Notes

• Reads files line by line. Does not load the whole file into memory.
• Runs offline. Does not upload logs.
• Does not modify the source log.

License

MIT License. See LICENSE.