help folks read logs (#112)

* add more description to the troubleshooting guide * adjust the log format to match more recent glog * include a config for the lnav tool, which will help colorize, browse, and search the logs. Next up: install an ffmpeg log callback for consistency.
2025-11-20 09:56:07 -05:00 · 2021-03-09 00:04:54 -08:00
parent 2d45799b7d
commit 2808d5e139
3 changed files with 145 additions and 22 deletions
--- a/misc/moonfire_log.json
+++ b/misc/moonfire_log.json
@@ -0,0 +1,41 @@
+{
+    "$schema": "https://lnav.org/schemas/format-v1.schema.json",
+    "moonfire_log": {
+        "title": "Moonfire Log",
+        "description": "The Moonfire NVR log format.",
+        "timestamp-format": ["%Y%m%d %H:%M:%S.%L"],
+        "url": "https://github.com/scottlamb/mylog/blob/master/src/lib.rs",
+        "regex": {
+            "std": {
+                "pattern": "^(?<level>[EWIDT])(?<timestamp>\\d{4} \\d{2}\\d{2}\\d{2}\\.\\d{3}) +(?<thread>[^ ]+) (?<module_path>[^ \\]]+)\\] (?<body>(?:.|\\n)*)"
+            }
+        },
+        "level-field": "level",
+        "level": {
+            "error": "E",
+            "warning": "W",
+            "info": "I",
+            "debug": "D",
+            "trace": "T"
+        },
+        "opid-field": "thread",
+        "value": {
+            "thread": {
+                "kind": "string",
+                "identifier": true
+            },
+            "module_path": {
+                "kind": "string",
+                "identifier": true
+            }
+        },
+        "sample": [
+            {
+                "line": "I20210308 21:31:24.255 main moonfire_nvr] Success."
+            },
+            {
+                "line": "W20210303 22:20:53.081 s-west_side-main moonfire_base::clock] getting next packet took PT8.153173367S!"
+            }
+        ]
+    }
+}