How summved/log-generator works
SIEM Log Generator is a local TypeScript CLI for producing synthetic security logs and delivering them to configured outputs, with replay, attack-chain simulation, threat-framework coverage, ML analysis, and monitoring. The main workflow is CLI/configuration → generation (optionally across workers) → filtering and output/history; separate commands drive replay and analysis. Source excerpts and the SOURCE INDEX support several internal calls; README statements support documented capabilities whose implementation was not sampled, so those links are cited to the README.
Main entry points: cli.ts CLI commands · LogGeneratorManager.ts Generation manager · outputManager.ts Output manager · BaseGenerator.ts Source generators
Components 32
Generation runtime
- Generation manager
src/LogGeneratorManager.ts - Generator factory
src/generators/createGenerators.ts - Source generators
src/generators/BaseGenerator.ts - Security operations generator
src/generators/SecurityOperationsGenerator.ts - Template rendering
src/utils/templateEngine.ts - Worker generation
src/workers/GenerationWorkers.ts - Flow control
src/workers/backpressure.ts
Output and replay
- Output manager
src/utils/outputManager.ts - Log formatters
src/utils/formatters.ts - Log history
src/utils/storage.ts - Log replay
src/replay/ReplayManager.ts - Historical log files
src/utils/logFiles.ts
Threat simulation
- MITRE filtering
src/utils/mitreFilter.ts - MITRE mapping
src/utils/mitreMapper.ts - Chain manager
src/chains/AttackChainManager.ts - Chain execution
src/chains/AttackChainEngine.ts - Step log factory
src/chains/StepLogFactory.ts - Chain definitions
src/types/attackChain.ts - D3FEND mapping
src/utils/d3fendMapper.ts
Analysis and monitoring
- Behavioral profiling
src/ml/logProfile.ts - Volume analysis
src/ml/volumeAnalysis.ts - Anomaly detection
src/ml/logOutliers.ts - IOC analysis
src/ml/indicators.ts - Text classification
src/ml/logTextClassifier.ts - Prometheus metrics
src/utils/metricsCollector.ts - Health endpoints
src/utils/httpServer.ts - Application logging
src/utils/logger.ts
CLI and configuration
- CLI commands
src/cli.ts - Config manager
src/config/index.ts - Config validator
src/utils/configValidator.ts
Other components
- Operator
- Configured SIEM
Connections 36
- Operator → CLI commands: runs commands
README.md - CLI commands → Generation manager: starts generation
src/cli.ts - CLI commands → Config manager: loads configuration
src/cli.ts - Generation manager → Config manager: reads settings
src/LogGeneratorManager.ts - Generation manager → Config validator: validates configuration
src/LogGeneratorManager.ts - Generation manager → Generator factory: creates generators
src/LogGeneratorManager.ts - Generator factory → Source generators: instantiates sources
src/generators/createGenerators.ts - Generation manager → Security operations generator: creates SOC generator
src/LogGeneratorManager.ts - Source generators → Template rendering: renders templates
src/generators/BaseGenerator.ts - Source generators → MITRE mapping: maps techniques
src/generators/BaseGenerator.ts - Generation manager → MITRE filtering: filters generated logs
src/LogGeneratorManager.ts - Generation manager → Worker generation: dispatches generation
src/LogGeneratorManager.ts - Worker generation → Flow control: applies flow control
- Generation manager → Output manager: hands off logs
src/LogGeneratorManager.ts - Output manager → Log formatters: formats logs
src/utils/outputManager.ts - Output manager → Log history: stores history
src/utils/outputManager.ts - Output manager → Configured SIEM: sends configured output
README.md - CLI commands → Chain manager: runs chain commands
src/cli.ts - Chain manager → Chain execution: executes chain
src/chains/AttackChainManager.ts - Chain execution → Step log factory: creates step logs
src/chains/AttackChainEngine.ts - Chain manager → Chain definitions: loads chain model
src/chains/AttackChainManager.ts - CLI commands → D3FEND mapping: reports coverage
src/cli.ts - CLI commands → Log replay: runs replay
src/cli.ts - Log replay → Log history: reads history
src/replay/ReplayManager.ts - CLI commands → Historical log files: analyzes historical files
src/cli.ts - CLI commands → Behavioral profiling: learns profiles
src/cli.ts - Behavioral profiling → Historical log files: reads log files
src/ml/logProfile.ts - CLI commands → Volume analysis: forecasts volume
src/cli.ts - Volume analysis → Historical log files: reads log files
src/ml/volumeAnalysis.ts - CLI commands → Anomaly detection: detects anomalies
src/cli.ts - CLI commands → IOC analysis: extracts indicators
src/cli.ts - CLI commands → Text classification: classifies text
src/cli.ts - Generation manager → Prometheus metrics: records metrics
src/LogGeneratorManager.ts - Generation manager → Health endpoints: starts monitoring
src/LogGeneratorManager.ts - Generation manager → Application logging: logs runtime events
src/LogGeneratorManager.ts - Configured SIEM → Operator: receives generated logs
README.md