How geekychris/local_log_search works
Little Log Peep is a local log search and analysis application, with a desktop-file indexing mode. Users configure sources, ingest and parse files into Lucene indices, search across indices, refine results with facets or pipe commands, and export or query saved tables. The README documents the principal log-ingestion and search flow; the source index confirms several core implementations. Other feature branches are retained from README/tree evidence, but their internal call paths are not inferred where source was not sampled.
Main entry points: LocalLogSearchApplication.java Spring application · SearchService.java Search and facets · DesktopIndexerManager.java Desktop indexing · TailerManager.java File tailing
Components 23
Service API
- Spring application
log-search-service/src/main/java/com/locallogsearch/service/LocalLogSearchApplication.java - Source management
log-search-service/src/main/java/com/locallogsearch/service/controller/LogSourceController.java - Search endpoint
log-search-service/src/main/java/com/locallogsearch/service/controller/SearchController.java - Index management
log-search-service/src/main/java/com/locallogsearch/service/controller/IndexController.java
Log Ingestion
- File tailing
log-search-core/src/main/java/com/locallogsearch/core/tailer/TailerManager.java - Log parsers
log-search-core/src/main/java/com/locallogsearch/core/parser - Lucene indexing
log-search-core/src/main/java/com/locallogsearch/core/index/IndexManager.java - Lucene indices
Desktop Files
- Desktop source API
log-search-service/src/main/java/com/locallogsearch/service/controller/DesktopSourceController.java - Desktop indexing
log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java - Document parsers
log-search-core/src/main/java/com/locallogsearch/core/desktop/parser
Search Analysis
- Search and facets
log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java - Pipe query parser
log-search-core/src/main/java/com/locallogsearch/core/pipe/PipeQueryParser.java - Pipe operations
log-search-core/src/main/java/com/locallogsearch/core/pipe/commands
Exports and AI
- Export endpoint
log-search-service/src/main/java/com/locallogsearch/service/controller/ExportController.java - Table export
log-search-service/src/main/java/com/locallogsearch/service/export/ExportService.java - Exported tables
log-search-service/src/main/java/com/locallogsearch/service/repository/ExportedTableRepository.java - SQL query UI
log-search-service/src/main/java/com/locallogsearch/service/controller/SqlQueryController.java - Query assistance
log-search-service/src/main/java/com/locallogsearch/service/controller/QueryHelperController.java - AI helpers
log-search-service/src/main/java/com/locallogsearch/service/ai
Other components
- Web or API user
- Ollama model
- Local log files
Connections 24
- Web or API user → Spring application: uses UI/API
- Spring application → Source management: routes source requests
- Spring application → Search endpoint: routes searches
- Spring application → Index management: routes index requests
- Local log files → File tailing: new entries
- File tailing → Log parsers: parses lines
- Log parsers → Lucene indexing: adds documents
- Lucene indexing → Lucene indices: commits index
- Source management → File tailing: manages sources
- Web or API user → Desktop source API: configures files
- Desktop source API → Desktop indexing: requests indexing
- Desktop indexing → Document parsers: parses files
log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java - Desktop indexing → Lucene indexing: indexes documents
log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java - Search endpoint → Search and facets: submits query
- Search and facets → Lucene indices: queries indices
- Search and facets → Pipe query parser: parses pipe syntax
log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java - Search and facets → Pipe operations: executes operations
log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java - Web or API user → Export endpoint: requests export
- Export endpoint → Table export: exports results
- Table export → Exported tables: persists tables
log-search-service/src/main/java/com/locallogsearch/service/export/ExportService.java - Web or API user → SQL query UI: queries exported data
- Web or API user → Query assistance: requests assistance
- Query assistance → AI helpers: delegates requests
log-search-service/src/main/java/com/locallogsearch/service/controller/QueryHelperController.java - AI helpers → Ollama model: prompts model
log-search-service/src/main/java/com/locallogsearch/service/ai/QueryHelperService.java