| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| ref:mqtt [2023/11/25 19:28] – [Servers] client/list, not client_list ... and other missing topics digital man | ref:mqtt [2024/07/11 18:37] (current) – [Servers] Add server/+/highwater topic digital man |
|---|
| The control and monitoring of a specific Synchronet instance is done through this "host sub-topic" tree. | The control and monitoring of a specific Synchronet instance is done through this "host sub-topic" tree. |
| |
| Publishing any message to the **recycle** sub-topic of any host topic will initiate a recycling of that host's servers (all of them). | ^ Host sub-topic ^ Description ^ |
| | | recycle | Publishing any message to the **recycle** sub-topic of any host topic will initiate a recycling of that host's servers (all of them). | |
| | | pause | Publishing any message to the **pause** sub-topic of any host topic will initiate pause that host's servers (all of them), preventing the acceptance of any new incoming client connections. | |
| | | resume | Publishing any message to the **resume** sub-topic of any host topic will un-pause that host's servers (all of them), that we previously paused via the **pause** topic. | |
| |
| ===== Servers ===== | ===== Servers ===== |
| sbbs/MYBBS/host/MYCOMPUTER/server/term = ready 1/5 clients 223 served | sbbs/MYBBS/host/MYCOMPUTER/server/term = ready 1/5 clients 223 served |
| |
| The numeric //state// (first field of status) for each server is 0-5 corresponding with Stopped, Initializing, Ready, Reloading, Stopping, and Disconnected. | The //state// (first field of status) for each server is one of: |
| | * stopped |
| | * initializing |
| | * ready |
| | * paused |
| | * reloading |
| | * stopping |
| | * disconnected |
| |
| The server status contains more details/statistics and is published more often when "High" Public Verbosity is enabled. | The server status contains more details/statistics and is published more often when "High" MQTT->Publish Verbosity is enabled in [[util:SCFG]]. |
| |
| Publishing any message to the **recycle** sub-topic of any server topic will initiate a recycling of that server. | ^ Server sub-topic ^ Description ^ |
| | | recycle | Publishing any message to the **recycle** sub-topic of any server topic will initiate a recycling of that server. | |
| | | pause | Publishing any message to the **pause** sub-topic of any server topic will prevent that server from accepting any new incoming client connections. | |
| | | resume | Publishing any message to the **resume** sub-topic of any server topic will un-pause that server, returning to the "ready" state, accepting incoming client connections. | |
| |
| Each server topic has the following sub-topics for status reporting: | Each server topic has the following sub-topics for status reporting: |
| |
| * sbbs/+/host/+/server/+/**version** | * sbbs/+/host/+/server/+/**version** - name, version/revision, and build date/time/tool of server |
| * sbbs/+/host/+/server/+/**state**/+ - server state change events | * sbbs/+/host/+/server/+/**state/#** - server state change events |
| * sbbs/+/host/+/server/+/**client** - current count of connected clients and maximum number of concurrent clients supported by this server | * sbbs/+/host/+/server/+/**client** - current count of connected clients and maximum number of concurrent clients supported by this server |
| * sbbs/+/host/+/server/+/**client/list** - tab-delimited details of all connected clients, one client per line | * sbbs/+/host/+/server/+/**client/list** - tab-delimited details of all connected clients, one client per line |
| * sbbs/+/host/+/server/+/**client/action**+ - client actions (e.g. connect, disconnect) | * sbbs/+/host/+/server/+/**client/action/#** - client actions (e.g. connect, disconnect) |
| * sbbs/+/host/+/server/+/**served** - total clients served since server was started | * sbbs/+/host/+/server/+/**served** - total clients served since server was started |
| | * sbbs/+/host/+/server/+/**highwater** - highest concurrent client count since server was started |
| * sbbs/+/host/+/server/+/**error_count** - total errors logged since server was started | * sbbs/+/host/+/server/+/**error_count** - total errors logged since server was started |
| |
