From 5489e92e31dda8818e7b7e5a40823cda2634c9e1 Mon Sep 17 00:00:00 2001 From: Evgeny Poberezkin <2769109+epoberezkin@users.noreply.github.com> Date: Thu, 28 Jan 2021 20:51:17 +0000 Subject: [PATCH] message management (#32) * message management rfc * update message management rfc * message management ideas (WIP) * message management updated * messages RFC * update agent MSG constructor to include recipient/broker/sender message IDs and timestamps * remove agent command ACK - agent automatically acknowledges server messages * correct messages doc --- docs/logging.md | 70 ------------------------------------------------- 1 file changed, 70 deletions(-) delete mode 100644 docs/logging.md diff --git a/docs/logging.md b/docs/logging.md deleted file mode 100644 index 04d2784aaf..0000000000 --- a/docs/logging.md +++ /dev/null @@ -1,70 +0,0 @@ -# SMP agent logging - -## Problem and proposed solution. - -SMP agent performs multiple actions in response to the client commands and to the messages received from other SMP agents (wrapped in SMP protocol messages). - -Customary approach for the network protocol clients is to have a debug/verbose mode that enables logging of all sent and received messages and any other actions that the client performs. - -This document proposes a logging format for SMP agent that would be enabled if the agent is run with `--verbose` / `-v` command line option. - -We can also consider logging the database operations that change the data. - -## Types of actions and the associated log line format. - -### Client connected / disconnected - -``` -client n connected to Agent -client n disconnected from Agent -``` - -where `n` is a sequential number of a connected agent client, starting from 1 (over the agent run-time). - -### Server connected / disconnected - -``` -Agent connected to host:port -Agent disconnected from host:port -``` - -### Received command from the client - -``` -n --> A : corrId connAlias parsed_command // raw_command -``` - -`raw_command` is added only in case of parsing failure. - -### Sent command to SMP server - -``` -A --> host:port : corrId queueId parsed_command -``` - -### Received response / message from the SMP server - -``` -A <-- host:port : corrId queueId parsed_command // raw_command -``` - -In case the response is a message or notification, corrId should be replaced with `_` - -### Interpreted ("unwrapped") SMP message as agent message - -``` -Agent msg : connAlias parsed_message // raw_message -``` - -### Sent response / message to the client - -``` -n <-- A : corrId connAlias parsed_command // raw_command -``` - -### Database changes - -``` -DB : insert/delete/update table key -DB : insert/delete/update table key -``` \ No newline at end of file