[
https://issues.apache.org/jira/browse/QPID-5998?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Alex Rudyy updated QPID-5998:
-----------------------------
Description:
HA operational logging needs to follow the existing operational logging format
which is:
{noformat}
[subject] [object] [message]
{noformat}
* subject, is a principal of a user or entity performing operation or reporting
the message
* object, is an entity on which the operation is invoked or a source of a
message
* message, operational logging message
h4. Subjects
For operations performed by operator an operator principal should be provided
in a subject, for example
{noformat}
[mng:admin(/127.0.0.1:49540)]
{noformat}
For operational log messages reported on a local node about remote node
changes, a special Subject should be created identifying the local node in
format
{noformat}
[grp(/{0})vhn(/{1}))]
{noformat}
* \{0\}, group name
* \{1\}, node name
For example
{noformat}
[grp(/high_availability)vhn(/node1))]
{noformat}
where 'high_availability' is a group name and 'node1' is a node name
h4. Objects
If operation is performed on a local node and it effects the local node, a
local node object needs to be specified in format
{noformat}
[grp(/{0})vhn(/{1})]
{noformat}
* \{0\}, group name
* \{1\}, node name
If operation is performed/reported on a remote node or affects the entire group
the group object should be provided in format
{noformat}
[grp(/{0})]
{noformat}
h4. Messages
Operational log for local node creation
{noformat}
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1001 : Created
{noformat}
Operational log for local node deletion
{noformat}
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1002 : Deleted
{noformat}
Operational log for a remote node added into a group for a first time
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1003 : Added : Node : ''{0}'' ({1})
{noformat}
* \{0\}, node name
* \{1\}, node address
Operational log for a remote node deleted from a group
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1004 : Removed : Node : ''{0}'' ({1})
{noformat}
* \{0\}, node name
* \{1\}, node address
Operational log for a remote node joining a group (attaching)
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1005 : Joined : Node : ''{0}'' ({1})
{noformat}
* \{0\}, node name
* \{1\}, node address
Operational log for a remote node leaving a group (detaching)
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1006 : Left : Node : ''{0}'' ({1})
{noformat}
* \{0\}, node name
* \{1\}, node address
Operational log for requesting a transfer master on a node
{noformat}
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: group object, [grp(/\{0\})]
Message: HA-1007 : Master transfer requested : to ''{0}'' ({1})
{noformat}
* \{0\}, node name
* \{1\}, node address
Operational log for intruder node detected
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/\{0\})]
Message: HA-1008 : Intruder detected : Node ''{0}'' ({1})
{noformat}
* \{0\}, node name
* \{1\}, node address
Operational log when master looses majority
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/\{0\})]
Message: HA-1009 : Insufficient replicas contactable
{noformat}
Operational log for role being changed on local or remote node
{noformat}
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: groupobject, [grp(/\{0\})]
Message: HA-1010 : Role changed reported: Node ''{0}'' ({1}) from ''{2}'' to
''{3}''
{noformat}
* \{0\}, node name
* \{1\}, node address
* \{2\}, previous role
* \{3\}, new role
Operational log for attribute change: quorumOverride
{noformat}
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1011 : Minimum group : {0}
{noformat}
* \{0\}, new value
Operational log for attribute change: priority
{noformat}
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1012 : Priority : {0}
{noformat}
* \{0\}, new value
Operational log for attribute change: designatedPrimary
{noformat}
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1013 : Designated primary : {0}
{noformat}
* \{0\}, new value
was:
HA operational logging needs to follow the existing operational logging format
which is:
{noformat}
[subject] [object] [message]
{noformat}
* subject, is a principal of a user or entity performing operation or reporting
the message
* object, is an entity on which the operation is invoked or a source of a
message
* message, operational logging message
h4. Subjects
For operations performed by operator an operator principal should be provided
in a subject, for example
{noformat}
[mng:admin(/127.0.0.1:49540)]
{noformat}
For operational log messages reported on a local node about remote node
changes, a special Subject should be created identifying the local node in
format
{noformat}
[grp(/{0})vhn(/{1}))]
{noformat}
* \{0\}, group name
* \{1\}, node name
For example
{noformat}
[grp(/high_availability)vhn(/node1))]
{noformat}
where 'high_availability' is a group name and 'node1' is a node name
h4. Objects
If operation is performed on a local node and it effects the local node, a
local node object needs to be specified in format
{noformat}
[grp(/{0})vhn(/{1})]
{noformat}
* \{0\}, group name
* \{1\}, node name
If operation is performed/reported on a remote node or affects the entire group
the group object should be provided in format
{noformat}
[grp(/{0})]
{noformat}
h4. Messages
We agreed to extend the current set of operational logging messages to report
cases when remote node is added into a group for a first time and when remote
node is deleted.
Operational log for local node creation
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1001 : Created
Operational log for local node deletion
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1002 : Deleted
Operational log for a remote node added into a group for a first time
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1003 : Added : Node : ''{0}'' ({1})
* \{0\}, node name
* \{1\}, node address
Operational log for a remote node deleted from a group
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1004 : Removed : Node : ''{0}'' ({1})
* \{0\}, node name
* \{1\}, node address
Operational log for a remote node joining a group (attaching)
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1005 : Joined : Node : ''{0}'' ({1})
* \{0\}, node name
* \{1\}, node address
Operational log for a remote node leaving a group (detaching)
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/{0}))]
Message: HA-1006 : Left : Node : ''{0}'' ({1})
* \{0\}, node name
* \{1\}, node address
Operational log for requesting a transfer master on a node
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: group object, [grp(/\{0\})]
Message: HA-1007 : Master transfer requested : to ''{0}'' ({1})
* \{0\}, node name
* \{1\}, node address
Operational log for intruder node detected
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/\{0\})]
Message: HA-1008 : Intruder detected : Node ''{0}'' ({1})
* \{0\}, node name
* \{1\}, node address
Operational log when master looses majority
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: group object, [grp(/\{0\})]
Message: HA-1009 : Insufficient replicas contactable
Operational log for role being changed on local or remote node
Subject: local node subject, [grp(/{0})vhn(/{1})]
Object: groupobject, [grp(/\{0\})]
Message: HA-1010 : Role changed reported: Node ''{0}'' ({1}) from ''{2}'' to
''{3}''
* \{0\}, node name
* \{1\}, node address
* \{2\}, previous role
* \{3\}, new role
Operational log for attribute change: quorumOverride
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1011 : Minimum group : {0}
* \{0\}, new value
Operational log for attribute change: priority
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1012 : Priority : {0}
* \{0\}, new value
Operational log for attribute change: designatedPrimary
Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
Object: local node object, [grp(/{0})vhn(/{1})]
Message: HA-1013 : Designated primary : {0}
* \{0\}, new value
> [Java Broker] HA operational logging messages should be consistent in use of
> tense and terse phrasing
> -----------------------------------------------------------------------------------------------------
>
> Key: QPID-5998
> URL: https://issues.apache.org/jira/browse/QPID-5998
> Project: Qpid
> Issue Type: Bug
> Components: Java Broker
> Reporter: Alex Rudyy
> Assignee: Alex Rudyy
> Priority: Blocker
> Fix For: 0.30
>
>
> HA operational logging needs to follow the existing operational logging
> format which is:
> {noformat}
> [subject] [object] [message]
> {noformat}
> * subject, is a principal of a user or entity performing operation or
> reporting the message
> * object, is an entity on which the operation is invoked or a source of a
> message
> * message, operational logging message
> h4. Subjects
> For operations performed by operator an operator principal should be provided
> in a subject, for example
> {noformat}
> [mng:admin(/127.0.0.1:49540)]
> {noformat}
> For operational log messages reported on a local node about remote node
> changes, a special Subject should be created identifying the local node in
> format
> {noformat}
> [grp(/{0})vhn(/{1}))]
> {noformat}
> * \{0\}, group name
> * \{1\}, node name
> For example
> {noformat}
> [grp(/high_availability)vhn(/node1))]
> {noformat}
> where 'high_availability' is a group name and 'node1' is a node name
> h4. Objects
> If operation is performed on a local node and it effects the local node, a
> local node object needs to be specified in format
> {noformat}
> [grp(/{0})vhn(/{1})]
> {noformat}
> * \{0\}, group name
> * \{1\}, node name
> If operation is performed/reported on a remote node or affects the entire
> group the group object should be provided in format
> {noformat}
> [grp(/{0})]
> {noformat}
> h4. Messages
> Operational log for local node creation
> {noformat}
> Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
> Object: local node object, [grp(/{0})vhn(/{1})]
> Message: HA-1001 : Created
> {noformat}
> Operational log for local node deletion
> {noformat}
> Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
> Object: local node object, [grp(/{0})vhn(/{1})]
> Message: HA-1002 : Deleted
> {noformat}
> Operational log for a remote node added into a group for a first time
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: group object, [grp(/{0}))]
> Message: HA-1003 : Added : Node : ''{0}'' ({1})
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> Operational log for a remote node deleted from a group
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: group object, [grp(/{0}))]
> Message: HA-1004 : Removed : Node : ''{0}'' ({1})
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> Operational log for a remote node joining a group (attaching)
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: group object, [grp(/{0}))]
> Message: HA-1005 : Joined : Node : ''{0}'' ({1})
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> Operational log for a remote node leaving a group (detaching)
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: group object, [grp(/{0}))]
> Message: HA-1006 : Left : Node : ''{0}'' ({1})
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> Operational log for requesting a transfer master on a node
> {noformat}
> Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
> Object: group object, [grp(/\{0\})]
> Message: HA-1007 : Master transfer requested : to ''{0}'' ({1})
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> Operational log for intruder node detected
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: group object, [grp(/\{0\})]
> Message: HA-1008 : Intruder detected : Node ''{0}'' ({1})
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> Operational log when master looses majority
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: group object, [grp(/\{0\})]
> Message: HA-1009 : Insufficient replicas contactable
> {noformat}
> Operational log for role being changed on local or remote node
> {noformat}
> Subject: local node subject, [grp(/{0})vhn(/{1})]
> Object: groupobject, [grp(/\{0\})]
> Message: HA-1010 : Role changed reported: Node ''{0}'' ({1}) from ''{2}'' to
> ''{3}''
> {noformat}
> * \{0\}, node name
> * \{1\}, node address
> * \{2\}, previous role
> * \{3\}, new role
> Operational log for attribute change: quorumOverride
> {noformat}
> Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
> Object: local node object, [grp(/{0})vhn(/{1})]
> Message: HA-1011 : Minimum group : {0}
> {noformat}
> * \{0\}, new value
> Operational log for attribute change: priority
> {noformat}
> Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
> Object: local node object, [grp(/{0})vhn(/{1})]
> Message: HA-1012 : Priority : {0}
> {noformat}
> * \{0\}, new value
> Operational log for attribute change: designatedPrimary
> {noformat}
> Subject: operator subject, ex [mng:admin(/127.0.0.1:49540)]
> Object: local node object, [grp(/{0})vhn(/{1})]
> Message: HA-1013 : Designated primary : {0}
> {noformat}
> * \{0\}, new value
--
This message was sent by Atlassian JIRA
(v6.2#6252)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
