WEB Debug + Trace

Co-Authored-By: brekotis <93345790+brekotis@users.noreply.github.com>
2026-09-16 07:24:10 +03:00 · 2026-08-25 12:59:41 +03:00
parent 0779cd0901
commit e774bc8c9a
48 changed files with 3744 additions and 435 deletions
@@ -0,0 +1,69 @@
+use super::*;
+
+const WEB_DEBUG_RENDERERS: usize = 2;
+const WEB_DEBUG_STATUS_PAGE_BYTES: usize = 8 * 1024 * 1024;
+const WEB_DEBUG_GROUP_SCRATCH_BYTES: usize = 4 * 1024 * 1024;
+
+/// Validates process-wide body, header, queue, static, and debug reservations.
+pub(super) fn validate(limits: &WebLimitsConfig) -> Result<()> {
+    let body_reservation = limits
+        .max_body_readers
+        .checked_mul(limits.max_body_bytes)
+        .ok_or_else(|| {
+            ProxyError::Config("web.limits body reader reservation overflowed usize".to_string())
+        })?;
+    if body_reservation > limits.max_body_bytes_global
+        || limits.max_body_bytes_global > u32::MAX as usize
+    {
+        return config_error(
+            "web.limits max_body_readers * max_body_bytes must fit max_body_bytes_global and u32",
+        );
+    }
+    let http_header_reservation = limits
+        .max_http_connections
+        .checked_mul(limits.max_header_bytes)
+        .ok_or_else(|| {
+            ProxyError::Config("web.limits HTTP header reservations overflow usize".to_string())
+        })?;
+    let debug_ring_index = limits
+        .debug_records_capacity
+        .checked_mul(std::mem::size_of::<usize>())
+        .ok_or_else(|| ProxyError::Config("web.limits debug index overflowed usize".to_string()))?;
+    let status_pages = WEB_DEBUG_RENDERERS
+        .checked_mul(WEB_DEBUG_STATUS_PAGE_BYTES)
+        .ok_or_else(|| ProxyError::Config("web.debug status pages overflowed usize".to_string()))?;
+    let debug_reservation = limits
+        .debug_bytes_global
+        .checked_add(
+            debug_ring_index
+                .checked_mul(WEB_DEBUG_RENDERERS)
+                .ok_or_else(|| {
+                    ProxyError::Config("web.debug snapshot indexes overflowed usize".to_string())
+                })?,
+        )
+        .and_then(|value| {
+            WEB_DEBUG_RENDERERS
+                .checked_mul(WEB_DEBUG_GROUP_SCRATCH_BYTES)
+                .and_then(|scratch| value.checked_add(scratch))
+        })
+        .ok_or_else(|| {
+            ProxyError::Config("web.debug reservations overflowed usize".to_string())
+        })?;
+    let reserved = limits
+        .pending_bytes_global
+        .checked_add(limits.max_body_bytes_global)
+        .and_then(|value| value.checked_add(limits.max_static_bytes))
+        .and_then(|value| value.checked_add(debug_ring_index))
+        .and_then(|value| value.checked_add(status_pages))
+        .and_then(|value| value.checked_add(debug_reservation))
+        .and_then(|value| value.checked_add(http_header_reservation))
+        .ok_or_else(|| ProxyError::Config("web.limits byte ceilings overflow usize".to_string()))?;
+    if reserved > limits.memory_envelope_bytes
+        || limits.memory_envelope_bytes > MAX_WEB_MEMORY_ENVELOPE_BYTES
+    {
+        return config_error(
+            "web.limits memory reservations must fit memory_envelope_bytes within 4 GiB",
+        );
+    }
+    Ok(())
+}