How musachowdhury/python-syslog-server works
Fast Logger is a UDP syslog server with a web console for configuring engines and clients, managing access, monitoring processing, and browsing saved logs. Its main workflow receives sender datagrams, admits configured clients, applies configured regular-expression classes, and persists processed records to dated SQLite files; the console queries those files and can download results. The README documents auto-deletion and multi-engine operation, while excerpts show the engine, persistence, API, and selected UI calls. Other feature-to-API wiring is represented only where supported by the tree or sampled source.
Main entry points: fast_api_app.py HTTP API · auth.js Session and API client · server.py Server startup · factory.py Engine factory
Components 20
Web console
- Console pages
frontend/app/dashboard/page.js - Sign-in
frontend/app/login/page.js - Session and API client
frontend/app/auth.js - Engine management
frontend/app/dashboard/engine_management/page.js - Engine monitoring
frontend/app/dashboard/components/engineStatus.js - Log browsing
frontend/app/dashboard/browse_log/page.js
API and access
- HTTP API
backend/fast_api/fast_api_app.py - API dependencies
backend/fast_api/fast_api_dependency.py - API models
backend/fast_api/fast_api_data_models.py - Settings store
backend/interfaces/database.py - Server startup
backend/server.py
Log processing
- Engine factory
backend/interfaces/factory.py - Engine interface
backend/syslogger/interface.py - Regex engine
backend/syslogger/engine.py - Runtime configuration
backend/configuration.py
Persistence
- Dated log databases
backend/syslogger/database.py - Logging bridge
backend/syslogger/bridge.py - Storage controller
backend/syslogger/database.py
Other components
- Operator
- Log senders
Connections 21
- Operator → Sign-in: signs in
- Sign-in → Session and API client: authorizes
- Console pages → Session and API client: requests data
- Engine management → Session and API client: manages engines
- Engine monitoring → Session and API client: polls status
- Log browsing → Session and API client: queries logs
- Session and API client → HTTP API: HTTP requests
- Server startup → HTTP API: starts
- Server startup → Engine factory: configures
- HTTP API → API dependencies: authenticates
- HTTP API → API models: validates
- HTTP API → Settings store: reads/writes settings
- HTTP API → Engine factory: dispatches engine actions
- Engine factory → Engine interface: manages engines
- Engine interface → Regex engine: controls
- Log senders → Regex engine: sends datagrams
- Regex engine → Dated log databases: queues processed logs
- Logging bridge → Storage controller: forwards writes
- Storage controller → Dated log databases: writes and queries
- HTTP API → Storage controller: log operations
- Runtime configuration → Server startup: provides settings