Reference
Status Guide
Every status indicator in the Agent GUI and the dashboard, and what to do when something isn't green.
Agent GUIAgent GUI — Status card
The connection card in the top-left of the Agent GUI shows three indicators: gRPC (backend connection), MT5 (terminal connection), and IPC (local service port).
| Status | Where | What it means |
|---|---|---|
| gRPC live | gRPC | Agent is authenticated and streaming with the backend. Commands can be received. |
| gRPC wait | gRPC | Agent is trying to connect. Check the Backend URL and API Key on the Setup tab. |
| gRPC down | gRPC | Connection failed. Check internet connectivity and that the backend host is reachable. |
| MT5 sync | MT5 | MT5 is logged in and positions are syncing on schedule. |
| MT5 lag | MT5 | MT5 is starting up or the watchdog is restarting the terminal. Wait ~15 seconds. |
| MT5 off | MT5 | MT5 failed to start or login failed. Check the MT5 Path and credentials on Setup. |
DashboardDashboard — Agent & account status
| Status | Where | What it means |
|---|---|---|
| healthy | Agent | Heartbeat received recently. Agent is online and operational. |
| offline | Agent | No heartbeat received in the last 2 minutes. Check the Windows service and connectivity. |
| connected | Broker account | Agent is logged into MT5 and account data is syncing. Trades can be executed. |
| disconnected | Broker account | Agent has not confirmed MT5 login for this account. Check the agent status first. |
AlertsDashboard — Alert status
| Status | Where | What it means |
|---|---|---|
| executed | Alert | Alert was received, routed to the agent, and the order was placed by MT5. |
| queued | Alert | Alert received and waiting for the agent to pick it up. |
| received | Alert | Alert payload saved. Pipeline is processing. |
| failed | Alert | Execution failed. MT5 rejected the order or the agent was offline. Check Logs. |
| no_agent | Alert | No connected agent available to route the alert to. Check agent connectivity. |
TimersBackground timers
Understanding the agent's internal schedule helps interpret delays you may see:
| Process | Interval | What it does |
|---|---|---|
| Heartbeat | 15 s | Sends agent health + MT5 status to the backend |
| Reconciliation | 30 s | Syncs positions, orders, and account info from MT5 to the dashboard |
| Watchdog | 10 s | Checks if MT5 is responsive; restarts it if frozen or disconnected |
| gRPC reconnect | 5–120 s | Exponential backoff reconnect if the gRPC stream drops |
ℹ
If a broker account shows disconnected immediately after setup, wait up to 30 seconds for the first reconciliation cycle to complete before troubleshooting.