feat: Performance-Logging — PERF-Zeilen in log.txt, Perf-Export via Dashboard

- Lua: appendPerfLine() schreibt via print() in die FS25-log.txt
  (getTime()-Timing pro Funktion: collect, fields, vehicles, vehicleMeta,
   commands, weather, soil_<layer>; idle-Sampling alle 5 s auf leeren Frames)
- Lua: perfLogEnabled via config.xml <performanceLog enabled="false"/>
- Server: /api/perf-export — liest PERF-Zeilen aus log.txt, sammelt
  Systeminfo (OS, CPU, Kerne, RAM, GPU) und Mod-Konfiguration,
  schreibt perf_export.txt in das modSettings-Verzeichnis
- Server: Server-Version (Build-Tag) statt Go-Compiler-Version im Export
- Dashboard: Diagnose-Sektion in Mod-Konfiguration mit Toggle +
  Exportieren-Button (Settings → Mod-Konfiguration → Diagnose)

Author: Cypris2010

FS25_FarmMonitor/FarmMonitor.lua

@@ -304,6 +304,7 @@ function FarmMonitor:loadConfig()
         commandInterval  = 1,
         soilResolution   = 128,
         soilRowsPerTick  = 2,
+        perfLogEnabled   = false,
     }
 
     local cfg = {}
@@ -322,6 +323,8 @@ function FarmMonitor:loadConfig()
             cfg.commandInterval = getInt("exportIntervals.commands#seconds", defaults.commandInterval)
             cfg.soilResolution  = getInt("soilMap.resolution#value",         defaults.soilResolution)
             cfg.soilRowsPerTick = getInt("soilMap.rowsPerTick#value",        defaults.soilRowsPerTick)
+            local perfVal = getXMLBool(xmlId, "farmMonitor.performanceLog#enabled")
+            cfg.perfLogEnabled  = perfVal == true
             delete(xmlId)
         end)
         if not ok then
@@ -348,6 +351,8 @@ function FarmMonitor:loadConfig()
             f:write('        <resolution value="'   .. defaults.soilResolution  .. '"/>\n')
             f:write('        <rowsPerTick value="'  .. defaults.soilRowsPerTick .. '"/>\n')
             f:write('    </soilMap>\n')
+            f:write('    <!-- Performance logging: writes perf.csv to modSettings folder -->\n')
+            f:write('    <performanceLog enabled="false"/>\n')
             f:write('</farmMonitor>\n')
             f:close()
             print("[FarmMonitor] Created default config.xml at: " .. path)
@@ -362,6 +367,8 @@ function FarmMonitor:loadConfig()
     FarmMonitor.commandInterval     = cfg.commandInterval * 1000
     FarmMonitor.soilResolution      = cfg.soilResolution
     FarmMonitor.soilRowsPerTick     = cfg.soilRowsPerTick
+    FarmMonitor.perfLogEnabled      = cfg.perfLogEnabled
+    FarmMonitor.perfIdleTimer       = 0
 
     print("[FarmMonitor] Config loaded:")
     print(string.format("[FarmMonitor]   Haupt-Export    : %d s", cfg.mainInterval))
@@ -371,6 +378,13 @@ function FarmMonitor:loadConfig()
     print(string.format("[FarmMonitor]   IPC-Commands    : %d s", cfg.commandInterval))
     print(string.format("[FarmMonitor]   Soil-Aufloesung : %d px", cfg.soilResolution))
     print(string.format("[FarmMonitor]   Soil-RowsPerTick: %d", cfg.soilRowsPerTick))
+    print(string.format("[FarmMonitor]   Perf-Logging    : %s", cfg.perfLogEnabled and "an" or "aus"))
+end
+
+local function appendPerfLine(fn, modMs, frameDt)
+    local ts = getDate("%Y-%m-%dT%H:%M:%S")
+    local dtStr = frameDt ~= nil and string.format(" dt=%.1fms", frameDt) or ""
+    print(string.format("[FarmMonitor] PERF %s %s: %.1fms%s", ts, fn, modMs, dtStr))
 end
 
 function FarmMonitor:deleteMap()
@@ -493,40 +507,62 @@ function FarmMonitor:update(dt)
         FarmMonitor:exportAutoDriveMarkers()
     end
 
+    local perfOn = FarmMonitor.perfLogEnabled
+    local heavyFrame = false
+    local t0
+
     FarmMonitor.timer = FarmMonitor.timer + dt
     if FarmMonitor.timer >= FarmMonitor.updateInterval then
         FarmMonitor.timer = 0
+        t0 = perfOn and getTime() or nil
         FarmMonitor:collectAndSave()
+        if perfOn then appendPerfLine("collect", getTime() - t0, dt) end
+        heavyFrame = true
     end
 
     FarmMonitor.fieldTimer = FarmMonitor.fieldTimer + dt
     if FarmMonitor.fieldTimer >= FarmMonitor.fieldInterval then
         FarmMonitor.fieldTimer = 0
+        t0 = perfOn and getTime() or nil
         FarmMonitor:collectAndSaveFields()
+        if perfOn then appendPerfLine("fields", getTime() - t0, dt) end
+        heavyFrame = true
     end
 
     FarmMonitor.vehicleTimer = FarmMonitor.vehicleTimer + dt
     if FarmMonitor.vehicleTimer >= FarmMonitor.vehicleInterval then
         FarmMonitor.vehicleTimer = 0
+        t0 = perfOn and getTime() or nil
         FarmMonitor:collectAndSaveVehicles()
+        if perfOn then appendPerfLine("vehicles", getTime() - t0, dt) end
+        heavyFrame = true
     end
 
     FarmMonitor.vehicleMetaTimer = FarmMonitor.vehicleMetaTimer + dt
     if FarmMonitor.vehicleMetaTimer >= FarmMonitor.vehicleMetaInterval then
         FarmMonitor.vehicleMetaTimer = 0
+        t0 = perfOn and getTime() or nil
         FarmMonitor:collectAndSaveVehicleMeta()
+        if perfOn then appendPerfLine("vehicleMeta", getTime() - t0, dt) end
+        heavyFrame = true
     end
 
     FarmMonitor.commandTimer = FarmMonitor.commandTimer + dt
     if FarmMonitor.commandTimer >= FarmMonitor.commandInterval then
         FarmMonitor.commandTimer = 0
+        t0 = perfOn and getTime() or nil
         FarmMonitor:processCommands()
+        if perfOn then appendPerfLine("commands", getTime() - t0, dt) end
+        heavyFrame = true
     end
 
     FarmMonitor.weatherTimer = FarmMonitor.weatherTimer + dt
     if FarmMonitor.weatherTimer >= FarmMonitor.weatherInterval then
         FarmMonitor.weatherTimer = 0
+        t0 = perfOn and getTime() or nil
         FarmMonitor:collectAndSaveWeather()
+        if perfOn then appendPerfLine("weather", getTime() - t0, dt) end
+        heavyFrame = true
     end
 
     -- Incremental soil layer export: runs every tick, samples a few rows at a time
@@ -536,6 +572,16 @@ function FarmMonitor:update(dt)
     if FarmMonitor.soilState ~= nil then
         FarmMonitor:stepSoilExport()
     end
+
+    -- Idle baseline: sample frame dt every 5 s on frames with no heavy mod work
+    if perfOn and not heavyFrame then
+        FarmMonitor.perfIdleTimer = FarmMonitor.perfIdleTimer + dt
+        if FarmMonitor.perfIdleTimer >= 5000 then
+            FarmMonitor.perfIdleTimer = 0
+            appendPerfLine("idle", 0, dt)
+        end
+    end
+
 end
 
 function FarmMonitor:draw() end
@@ -3015,9 +3061,10 @@ function FarmMonitor:initSoilState()
         cellSize    = terrainSize / res,
         half        = terrainSize / 2,
         rowsPerTick = FarmMonitor.soilRowsPerTick or 2,
-        layerIdx    = 1,          -- C: current layer in round-robin
-        currentRow  = 0,          -- A: next row to sample
-        values      = {},         -- accumulator for current layer
+        layerIdx         = 1,          -- C: current layer in round-robin
+        currentRow       = 0,          -- A: next row to sample
+        values           = {},         -- accumulator for current layer
+        layerStartTime   = getTime(),  -- for perf logging
     }
 end
 
@@ -3083,10 +3130,15 @@ function FarmMonitor:stepSoilExport()
             print("[FarmMonitor] ERROR writing layer_" .. name .. ": " .. tostring(writeErr))
         end
 
+        if FarmMonitor.perfLogEnabled then
+            appendPerfLine("soil_" .. name, getTime() - st.layerStartTime, nil)
+        end
+
         -- Advance to next layer (C: round-robin)
-        st.layerIdx   = (st.layerIdx % #st.layers) + 1
-        st.currentRow = 0
-        st.values     = {}
+        st.layerIdx       = (st.layerIdx % #st.layers) + 1
+        st.currentRow     = 0
+        st.values         = {}
+        st.layerStartTime = getTime()
     end
 end
 

Server/dashboard.html

@@ -5266,6 +5266,24 @@ <h2>Aktive Warnungen</h2>
         ${cfgRow('Auflösung', 'Pixelgröße des Rasters. Empfohlen: 128.<br>Werte: 32 / 64 / 128 / 256 / 512.', 'mcfg-soil-res', mcs.resolution ?? 128, 32, 512, 'px')}
         ${cfgRow('Zeilen pro Tick', 'Zeilen pro Spiel-Tick.<br>Höher = schnellere Aktualisierung, mehr Last. Empfohlen: 2.', 'mcfg-soil-rows', mcs.rowsPerTick ?? 2, 1, 16, 'Zeilen')}
       </div>
+      <div style="font-size:12px;color:var(--muted);font-weight:700;text-transform:uppercase;letter-spacing:.06em;margin-top:4px">Diagnose</div>
+      <div class="placeable-item">
+        <div class="placeable-item-info">
+          <div class="placeable-item-name">Performance-Logging</div>
+          <div class="placeable-item-uid">Schreibt PERF-Zeilen in die log.txt. Nur für Diagnose aktivieren.</div>
+        </div>
+        <label class="toggle">
+          <input type="checkbox" id="mcfg-perflog" ${modConfigCache?.perfLog ? 'checked' : ''}>
+          <span class="toggle-slider"></span>
+        </label>
+      </div>
+      <div class="placeable-item">
+        <div class="placeable-item-info">
+          <div class="placeable-item-name">Perf-Export erstellen</div>
+          <div class="placeable-item-uid" id="perf-export-status">Systeminfo + Konfiguration + Messungen → perf_export.txt</div>
+        </div>
+        <button onclick="perfExport()" class="edit-mode-btn active" style="padding:6px 14px;white-space:nowrap">Exportieren</button>
+      </div>
       <div style="display:flex;align-items:center;justify-content:flex-end;margin-top:4px">
         <button onclick="saveModConfig()" class="edit-mode-btn active" style="padding:7px 18px">Speichern</button>
       </div>
@@ -5292,6 +5310,19 @@ <h2>Aktive Warnungen</h2>
   } catch(e) { console.warn('mod-config fetch failed', e); }
 }
 
+async function perfExport() {
+  const status = document.getElementById('perf-export-status');
+  if (status) status.textContent = 'Exportiere …';
+  try {
+    const res = await fetch('/api/perf-export', { method: 'POST' });
+    if (!res.ok) throw new Error(res.statusText);
+    const data = await res.json();
+    if (status) status.textContent = '✓ Exportiert: ' + data.path;
+  } catch(e) {
+    if (status) status.textContent = '✗ Fehler: ' + e.message;
+  }
+}
+
 async function saveModConfig() {
   const get = id => parseInt(document.getElementById(id)?.value ?? '0', 10);
   const cfg = {
@@ -5306,6 +5337,7 @@ <h2>Aktive Warnungen</h2>
       resolution:  get('mcfg-soil-res'),
       rowsPerTick: get('mcfg-soil-rows'),
     },
+    perfLog: document.getElementById('mcfg-perflog')?.checked ?? false,
   };
   try {
     const res = await fetch('/api/mod-config', {