Skip to content

Agent Zero AI framework

better logging in websockets

frdel85d8c4894e4b
diff --git a/python/helpers/websocket_manager.py b/python/helpers/websocket_manager.py
index ca9b0efbf..8b53df6f0 100644
--- a/python/helpers/websocket_manager.py
+++ b/python/helpers/websocket_manager.py
@@ -1,6 +1,6 @@
from __future__ import annotations
-import asyncio
+import asyncio, os
import time
import threading
from collections import defaultdict, deque
@@ -15,6 +15,7 @@ from python.helpers.defer import DeferredTask
from python.helpers.print_style import PrintStyle
from python.helpers import runtime
from python.helpers.websocket import ConnectionNotFoundError, WebSocketHandler, WebSocketResult
+from python.helpers.state_monitor import _ws_debug_enabled
BUFFER_MAX_SIZE = 100
BUFFER_TTL = timedelta(hours=1)
@@ -79,7 +80,8 @@ class WebSocketManager:
# Internal: development-only debug logging to avoid noise in production
def _debug(self, message: str) -> None:
- if runtime.is_development():
+ value = os.getenv("A0_WS_DEBUG", "").strip().lower()
+ if value in {"1", "true", "yes", "on"}:
PrintStyle.debug(message)
def _ensure_dispatcher_loop(self) -> None:
@@ -329,7 +331,7 @@ class WebSocketManager:
)
raise
- if runtime.is_development():
+ if _ws_debug_enabled():
PrintStyle.info(
"Registered WebSocket handler %s namespace=%s for events: %s"
% (handler.identifier, namespace, ", ".join(validated_events))
@@ -389,7 +391,8 @@ class WebSocketManager:
connection_count = sum(
1 for conn_identity in self.connections if conn_identity[0] == namespace
)
- PrintStyle.info(f"WebSocket connected: namespace={namespace} sid={sid}")
+ if _ws_debug_enabled():
+ PrintStyle.info(f"WebSocket connected: namespace={namespace} sid={sid}")
await self._run_lifecycle(namespace, lambda h: h.on_connect(sid))
await self._flush_buffer(identity)
if self._server_restart_enabled:
@@ -405,9 +408,10 @@ class WebSocketManager:
},
handler_id=self._identifier,
)
- PrintStyle.info(
- f"server_restart broadcast emitted to namespace={namespace} sid={sid}"
- )
+ if _ws_debug_enabled():
+ PrintStyle.info(
+ f"server_restart broadcast emitted to namespace={namespace} sid={sid}"
+ )
lifecycle_payload = {
"namespace": namespace,
"sid": sid,
diff --git a/python/websocket_handlers/state_sync_handler.py b/python/websocket_handlers/state_sync_handler.py
index 8d86620c8..b6689b6ed 100644
--- a/python/websocket_handlers/state_sync_handler.py
+++ b/python/websocket_handlers/state_sync_handler.py
@@ -3,7 +3,7 @@ from __future__ import annotations
from python.helpers import runtime
from python.helpers.print_style import PrintStyle
from python.helpers.websocket import WebSocketHandler, WebSocketResult
-from python.helpers.state_monitor import get_state_monitor
+from python.helpers.state_monitor import get_state_monitor, _ws_debug_enabled
from python.helpers.state_snapshot import (
StateRequestValidationError,
parse_state_request_payload,
@@ -19,11 +19,13 @@ class StateSyncHandler(WebSocketHandler):
monitor = get_state_monitor()
monitor.bind_manager(self.manager, handler_id=self.identifier)
monitor.register_sid(self.namespace, sid)
- PrintStyle.info(f"[StateSyncHandler] connect sid={sid}")
+ if _ws_debug_enabled():
+ PrintStyle.debug(f"[StateSyncHandler] connect sid={sid}")
async def on_disconnect(self, sid: str) -> None:
get_state_monitor().unregister_sid(self.namespace, sid)
- PrintStyle.info(f"[StateSyncHandler] disconnect sid={sid}")
+ if _ws_debug_enabled():
+ PrintStyle.debug(f"[StateSyncHandler] disconnect sid={sid}")
async def process_event(self, event_type: str, data: dict, sid: str) -> dict | WebSocketResult | None:
correlation_id = data.get("correlationId")
@@ -39,11 +41,12 @@ class StateSyncHandler(WebSocketHandler):
correlation_id=correlation_id,
)
- PrintStyle.debug(
- f"[StateSyncHandler] state_request sid={sid} context={request.context!r} "
- f"log_from={request.log_from} notifications_from={request.notifications_from} timezone={request.timezone!r} "
- f"correlation_id={correlation_id}"
- )
+ if _ws_debug_enabled():
+ PrintStyle.debug(
+ f"[StateSyncHandler] state_request sid={sid} context={request.context!r} "
+ f"log_from={request.log_from} notifications_from={request.notifications_from} timezone={request.timezone!r} "
+ f"correlation_id={correlation_id}"
+ )
# Baseline sequence must be reset on every state_request (new sync period).
# V1 policy: seq_base starts >0 to allow simple gating checks.
@@ -61,7 +64,8 @@ class StateSyncHandler(WebSocketHandler):
sid,
reason="state_sync_handler.StateSyncHandler.state_request",
)
- PrintStyle.debug(f"[StateSyncHandler] state_request accepted sid={sid} seq_base={seq_base}")
+ if _ws_debug_enabled():
+ PrintStyle.debug(f"[StateSyncHandler] state_request accepted sid={sid} seq_base={seq_base}")
return self.result_ok(
{
diff --git a/run_ui.py b/run_ui.py
index 2b6433da5..93b259c62 100644
--- a/run_ui.py
+++ b/run_ui.py
@@ -500,7 +500,7 @@ def run():
asgi_app,
host=host,
port=port,
- log_level="error",
+ log_level="info",
access_log=_settings.get("uvicorn_access_logs_enabled", False),
ws="wsproto",
)