According to the architecture of the TMA Framework
the TMA_Monitor
component provides a generic interface that can be used by the probes installed in the different layers of the system to send data about the collected measurements and events.
These data are then stored in the TMA_Knowledge
component, where it will be available to be used in by the TMA_Analyze
, TMA_Planning
, and TMA_Execute
components.
The monitoring interface receives data regarding a broad range of components in a generic fashion. To use this interface, the protocol defined here must be followed, to assure the basic security properties in the data transmission (integrity and confidentiality).
Sequence diagram for the usage of the monitor component.
Each probe starts its activity with an authentication synchronous message, in which it will receive is probeId
and the token to use in the ensuing messages.
All communication is performed over SSL sockets.
Each of the post observations interactions is an asynchronous message, which includes the obtained token in the headers.
The messages format allows to aggregate multiple metrics and observations before sending, to avoid the communication overhead.
The messages to be submitted to the TMA_Monitor
follow the JSON
schema specified in tma-m_schema, which is currently in the version 0.3
.
The figure below presents a representation of this schema, which is also explained below.
Format of the data to be provided to the monitor component.
Each message includes:
probeId
-- obtained during authenticationresourceId
-- identifies the resource that is the subject of the attached datamessageId
-- control informationsentTime
-- control informationdata
-- an array of objects, each one including:type
-- event or measurementdescriptionId
-- identifies the event or measurement, and an array ofobservations
-- each one is a pair oftime
-- at which the specific observation was performedvalue
-- the observerd value which can be 0 in the case ofevent
.
Documentation is available at development and server.
Documentation is available at development, libraries and probes.