This page is deprecated in favour of documentation provided at http://xdaq.web.cern.ch

Configuring the Sensor

Running and configuring the xmas::sensor::Application

Before you can use the XMAS monitoring facilities, you need to install the XDAQ Power Pack. The XPlore discovery services must also be include in order to use the XMAS facilities.

There are two configuration modes available.

• auto configuration The auto configuration instruct the sensor to load the sensor settings automatically through the provided paramater for each services loaded into the XDAQ process. This method allow the sensor to dynamically re-configure whenever a new service is loaded into the XDAQ processe. The association between the settings file and the service is done by the combination of the search path plus the sensor attribute of a give XDAQ application. For instance in the example above the sensor will search for the setting for the executive services on the following URL:

http://xdaq.web.cern.ch/xdaq/setup/${XDAQ_ZONE}/sensor/executive.sensor

where ${XDAQ_ZONE} is defined in the environment variable of just use default if undefined.

• static configuration The static configuration give explicitely the list of sensor settings that must be loaded upon loading of the sensot application into the XDAQ process.

The xmas::sensor::Application application must be defined either in the XDAQ profile.xml or in the XDAQ configuration file as follows:

...

${XDAQ_ROOT}/lib/libslp.so ${XDAQ_ROOT}/daq/xslp/lib/${XDAQ_OS}/${XDAQ_PLATFORM}/libxslp.so ${XDAQ_ROOT}/daq/xplore/lib/${XDAQ_OS}/${XDAQ_PLATFORM}/libxplore.so

true http://xdaq.web.cern.ch/xdaq/setup/${XDAQ_ZONE}/sensor true (.*) monitor-l0 ${XDAQ_ROOT}/daq/ws/addressing/lib/linux/${XDAQ_PLATFORM}/libwsaddressing.so ${XDAQ_ROOT}/daq/ws/eventing/lib/linux/${XDAQ_PLATFORM}/libwseventing.so ${XDAQ_ROOT}/daq/xmas/utils/lib/${XDAQ_OS}/${XDAQ_PLATFORM}/libxmasutils.so ${XDAQ_ROOT}/daq/xmas/sensor/lib/${XDAQ_OS}/${XDAQ_PLATFORM}/libxmassensor.so

The Sensor XML file

Sensor settings are given in an XML file according the following schema http://xdaq.web.cern.ch/xdaq/xsd/2006/xmas-10. The file is suffixed .sensor , E.g. executive.sensor . The XML defines a number of monitor objects that are responsible to detect changes and/or retrive values of a specified number of data elements. Data elements, variables that are contained in qualified infospaces, are specified by means of a flashlist. Each monitor object is configured with a number of samplers. Each sampler indicates the way the metrics are produced. There are two type of samplers. The instant sampler and the history sampler.

• instant sampler is used for istantaneous values. Only the last retrieved value is remember.
• history samplre is used keep record of a number of samples for a window of time.

The tag attribute is used to stamp the metrics produced and can be used for filter operations or for redirecting the collected metrics to different collectors. It is a good practice to define one sensor settings per service.