Home

Welcome to the log-intelligence-engine wiki!

log-intelligence-engine

A production-grade log parsing and intelligence engine that ingests raw log files, classifies severity levels, analyzes error patterns, and generates structured JSON intelligence reports.

---

What Is This?

log-intelligence-engine is a modular Python engine built to make sense of raw, unstructured log data. It ingests log files in common formats, classifies every entry by severity, analyzes error and warning rates, and produces a structured JSON intelligence report — ready for downstream consumption by dashboards, alerting systems, or human operators.

This is the kind of tooling real NOC and CloudOps teams build when they need visibility into what their systems are actually saying.

---

Wiki Navigation

Page	Description
Architecture	System design, component breakdown, and data flow
Setup & Configuration	Environment setup and config.ini reference
Usage Guide	Running the engine and interpreting intelligence reports
Runbook	NOC-style operational procedures for log triage
Troubleshooting	Common issues, error messages, and fixes
Roadmap	Planned features and future integrations

---

Quick Stats

Property	Detail
Language	Python 3.x
Input	Raw log files (.log, .txt)
Output	Structured JSON intelligence report
Classification	CRITICAL, ERROR, WARNING, INFO, DEBUG
Health Scoring	HEALTHY, DEGRADED, CRITICAL
Report Format	JSON

---

At a Glance

Raw Log Files → parser.py → classifier.py → analyzer.py → reporter.py → JSON Report
     ↓                                                                        ↓
logs/input/                                                         logs/output/report.json

---

Sample Intelligence Report

{
    "generated_at": "2026-03-07T13:00:00+00:00",
    "total_files_analyzed": 1,
    "summary": [
        {
            "file": "sample.log",
            "health_status": "HEALTHY",
            "total_entries": 10000,
            "error_rate": 0.17,
            "warning_rate": 0.00,
            "level_counts": {
                "INFO": 9983,
                "ERROR": 17
            }
        }
    ]
}

---

Part of the Alex-CloudOps observability portfolio — built to demonstrate production-grade log intelligence and NOC engineering practices.