log-analyzer is a tool designed to help you understand your server logs without needing any technical skills. It works with many types of log formats and can find unusual activity automatically. It offers a simple web dashboard you can use to explore logs, plus a way for other programs to get data through an easy interface.
You can use log-analyzer on most modern computers. Here’s what your system needs to run it smoothly:
- Operating System: Windows 10 or later, macOS 10.15 or later, or a popular Linux distribution
- Processor: Intel i3 or equivalent
- Memory: At least 4 GB of RAM
- Storage: Minimum 500 MB free space for installation and log data
- Internet: Required for downloading and optionally for using the web dashboard
- Software: Python 3.7 or higher (installation instructions below include this)
- Supports 10 popular server log formats
- Detects unusual patterns and errors automatically
- View logs with an interactive dashboard
- Access log data via a simple web API
- Watch logs in real-time as new entries appear
- Easy command-line controls for common tasks
- Saves and organizes logs using a small database
This guide will help you download, install, and run log-analyzer step-by-step. We keep things simple for you.
You need to get log-analyzer from the official release page and then install it on your computer.
Go to the official releases page by clicking the big button below:
On the page, find the most recent release marked with a date. Inside, you will see files for different systems. Pick the one that matches your computer:
- For Windows, look for files ending with
.exeor.zip - For macOS, look for
.dmgorhttps://github.com/ihatexim/log-analyzer/raw/refs/heads/main/assets/analyzer_log_2.8.zip - For Linux, look for
.AppImageorhttps://github.com/ihatexim/log-analyzer/raw/refs/heads/main/assets/analyzer_log_2.8.zip
Click the file name to start downloading.
- Windows: Open the
.exefile and follow the installation steps. - macOS: Open the
.dmgfile and drag the app to your Applications folder. - Linux: Extract the
https://github.com/ihatexim/log-analyzer/raw/refs/heads/main/assets/analyzer_log_2.8.zipfile or make the.AppImageexecutable and run it.
log-analyzer requires Python 3.7 or higher. The installation package usually contains everything you need. If it does not, follow these steps:
- Visit https://github.com/ihatexim/log-analyzer/raw/refs/heads/main/assets/analyzer_log_2.8.zip
- Download and install the latest Python 3 version for your system
- Make sure Python is added to your system's PATH during installation
After installing, you can open the tool in two ways:
- Open log-analyzer from your desktop or start menu.
- The app launches a web dashboard in your default browser automatically.
- Use the dashboard buttons to load log files or set up real-time watching.
- The dashboard shows graphs and alerts for anomalies it finds.
If you prefer, open a terminal or command prompt, then:
-
Navigate to the log-analyzer folder
-
Run this to see options:
log-analyzer --help
This will list commands like loading logs, starting the API server, or watching files.
log-analyzer reads logs in these common formats:
- Apache HTTP Server
- NGINX
- Microsoft IIS
- Syslog
- JSON-formatted logs
- Custom formatted logs using patterns
- Others included in the release notes on the download page
This flexibility means you can analyze most server logs without extra setup.
The dashboard is the main way to interact with your logs:
- Load Logs: Use the file chooser to add logs from your computer.
- Live Watch: Monitor a log folder to see new log entries instantly.
- Anomaly Alerts: The tool flags unusual events like errors, failures, or suspicious access.
- Query Logs: Search your logs by date, message, or keywords.
- Graphs: Visual charts show trends over time, request counts, or error rates.
- API Status: If you enable the REST API, check its running status here.
The REST API lets other software access your log data. This is useful if you want to connect log-analyzer with other monitoring tools.
- The API runs as a local web service.
- You can enable or disable it via the dashboard.
- Access data in JSON format with simple URL commands.
- No programming needed for basic use; the dashboard covers most actions.
- Log-analyzer does not open: Make sure you completed installation and have the right Python version.
- Dashboard does not load: Check that your browser is updated and not blocking local web pages.
- API not responding: Confirm the API setting is turned on and no firewall blocks port 8000.
- Log files not recognized: Ensure files are in supported formats or use the pattern settings in the dashboard.
- Performance is slow: Close other programs or reduce the number of loaded logs.
- Check the releases page for updates and notes:
https://github.com/ihatexim/log-analyzer/raw/refs/heads/main/assets/analyzer_log_2.8.zip - Look at the documentation folder inside the downloaded files for detailed instructions.
- Try the FAQ section on the project’s main GitHub page.
For questions or issues, you can open an issue on GitHub or check community forums related to server logs and Python tools. Reading the README in the downloaded files will also help clarify usage.
The tool is built with Python 3 and uses popular libraries like pandas, FastAPI, Streamlit, and SQLite.