What | nameofinstance.xml |
---|---|
Description | Configuration for the SystemMetrics module |
schema location | https://fewsdocs.deltares.nl/schemas/version1.0/systemMetrics.xsd |
The significant changes on the Delft-FEWS architecture for the 2017.02 roadmaps has rendered certain elements of the SystemMetrics from the McStatus section meaningless. In below configuration examples it is documented, which configuration elements have been removed from 2017.02 (see "no longer present in 2017.02 and later" comments on this page). Note that the SystemMetrics module uses the McStatusView and FssStatusView. Unfortunately these two views have not been available in all the delivered 2017.02 release packages. New versions of McStatusView and FssStatusView will be officially present in 2018.01 again. Ask Fews support if you need the McStatusView and FssStatusView in 2017.02 or use the view_creation script from the latest 2017.02 mc build. In 2017.02 and later, please remove the following elements from the SystemMetrics module configuration file (parameters and filters should probably cleaned up as well) otherwise errors will be logged: <oclListenerParameterId>M.S.ocl</oclListenerParameterId> <fslListenerParameterId>M.S.fsl</fslListenerParameterId> <synchListenerParameterId>M.S.synchL</synchListenerParameterId> <synchRunnerParameterId>M.S.synchR</synchRunnerParameterId> <synchTaskListenerParameterId>M.S.synchTL</synchTaskListenerParameterId> <tmLauncherParameterId>M.S.tmLa</tmLauncherParameterId> <tmChaserParameterId>M.S.tmC</tmChaserParameterId> <tmLogProcessorParameterId>M.S.tmLP</tmLogProcessorParameterId> <sysMonListenerParameterId>M.S.sysmL</sysMonListenerParameterId> <sysMonMonitorParameterId>M.S.sysmM</sysMonMonitorParameterId> <sysMonHeartbeatParameterId>M.S.sysmH</sysMonHeartbeatParameterId> |
The significant changes on the Delft-FEWS architecture for the 2018.02 roadmaps has rendered the FssStatus section meaningless. In below configuration examples it is documented, which configuration elements have been removed from 2018.02 (see "no longer present in 2018.02 and later" comments on this page). In 2018.02 and later, please remove the following elements from the SystemMetrics module configuration file (parameters and filters should probably cleaned up as well) otherwise errors will be logged: <buildVersionParameterId>M.N.build</buildVersionParameterId> |
The SystemMonitor in the client and the Admin Interface provide monitoring of the Delft-FEWS live system. In addition, the Delft-FEWS SystemMetrics module can be run regularly within a workflow to store several of these statistics as timeseries into the database. This workflow is only available in Direct Database Access mode (DDA), and should therefore be provided a workflow mapping to a DDA FSS. There are a number of configuration requirements when using SystemMetrics. It is required to define a dummy location and a number of qualifiers and parameters. Timeseries are stored in non-equidistant timestep: one value for every time the module runs. See the sample configuration below for reference.
<moduleInstanceDescriptor id="SystemMetrics"/> |
<location id="metrics" name="SystemMetrics"> <description>SystemMetrics</description> <shortName>SystemMetrics</shortName> <x>-1</x> <y>-1</y> <z>-1</z> </location> |
|
NB. The SystemMetrics module requires that the correct fssId is provided in the Forecasting Shell configuration, i.e. fews.master.mcproxy.conf. Ensure you've replaced the obsolete argument nl.wldelft.fews.system.synch.MasterControllerSynchroniserFactory and provide the fssId instead.
<forecastshell> <run path="d:/opt/mcs/FSS00/FewsShell/bin"/> <jvm path="d:/opt/jre/bin/java"> <arg id="0" value="-Xmx1024M"/> </jvm> <lib id="0" path="d:/opt/mcs/FSS00/FewsShell/bin"/> <class name="nl.wldelft.fews.system.shellserver.ForecastingShell"> <arg id="0" value="FSS00"/> ... |
<qualifier id="MC00"/> <qualifier id="MC01"/> <qualifier id="MC02"/> <!-- before 2018.02, it was possible to collect system metrics per fss --> <!-- <qualifier id="FSS00"/> <qualifier id="FSS01"/> <qualifier id="FSS02"/> <qualifier id="FSS03"/> --> |
|
<workflowDescriptor id="SystemMetrics" name="SystemMetrics" forecast="true" visible="true"> <description>SystemMetrics</description> <viewPermission>Forecaster</viewPermission> </workflowDescriptor> |
<?xml version="1.0" encoding="UTF-8"?> <workflow version="1.1" xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews https://fewsdocs.deltares.nl/schemas/version1.0/workflow.xsd"> <activity> <moduleInstanceId>SystemMetrics</moduleInstanceId> </activity> </workflow> |
|