Log Analysis CLI Reference
Command: md-log
Alternate: mdengine log-to-md
Arguments
| Name |
Type |
Required |
Default |
Choices |
Description |
--config |
Path |
optional |
None |
— |
YAML config path |
--input |
Path |
optional |
None |
— |
Log file or directory (repeatable) |
--output |
Path |
optional |
None |
— |
Output directory |
--preset |
str |
optional |
None |
— |
Parser preset name (e.g. generic, springboot, logback, json) |
--line-regex |
str |
optional |
None |
— |
Custom line regex (named groups: timestamp, level, message, …) |
--auto-detect |
flag |
optional |
false |
— |
Auto-detect parser preset from log sample |
--preset-dir |
str |
optional |
None |
— |
Directory with user preset YAML files (repeatable; also MD_LOG_PRESET_DIRS, ~/.mdengine/log/presets) |
--async |
flag |
optional |
false |
— |
Enqueue background job (prints job_id; SQLite job store) |
--export-jsonl |
flag |
optional |
false |
— |
Export embedding-ready JSONL chunks |
--export-parquet |
flag |
optional |
false |
— |
Export embedding-ready Parquet chunks |
--resume |
flag |
optional |
false |
— |
Enable incremental checkpoint resume |
--frontmatter |
flag |
optional |
false |
— |
Emit YAML frontmatter on artifacts |
--source |
str |
optional |
'tail' |
['tail', 'stdin', 'kafka', 'redis', 'websocket'] |
— |
--config |
Path |
optional |
None |
— |
— |
--input |
Path |
optional |
None |
— |
File path for tail source |
--output |
Path |
optional |
None |
— |
— |
Exit codes
| Code |
Meaning |
| 0 |
Success |
| 1 |
Runtime conversion failure |
| 2 |
Invalid usage or missing input |