products:promonitor:6.8:monitorsguide:netweaver:customsapcontrolmonitoring

Custom SapControl monitoring

This monitor will give the possibility to extend the monitoring of components using the 
SAP start service framework, such as Web dispatcher, ICM or application servers.
It will discover metrics from the SAPControl services and let you customize how you want to monitor them.

Configuration hints

  • Use the load Metrics button to discover the available metrics from a system.
  • You can then select the metrics you want and create surveillance rules for each one.
  • Metric paths will automatically be filled in the table.
  • You can replace branches of the path by a variable like %INSTANCE% or %DISK% to use it in the alarm message or in the metric target in order to make that rule a generic one.
  • For each line of surveillance, you can send alarms and metrics.

Authorizations

  • This monitor requires to work with a SAPControl connector
  • Authorizations to execute GetAlerts and GetAlertsTree must be granted to the connector's user

Thresholds

The threshold syntax is similar than the one in CCMS:

  • G2W:50 → 50 is the threshold to set a WARNING
  • W2M:80 → 80 is the threshold to move from WARNING to MAJOR
  • M2W:70 → 70 is the threshold to move from MAJOR to WARNING
  • You can combine multiple rules: G2W:50 W2M:80 M2W:70

Severity letters:

  • G: Green
  • W: Warning
  • m: minor
  • M: Major
  • C: Critical

Alarm message

You can build the alarm message by using the variables declared in the metric path, but also following ones:

  • %THRESH%: the threshold that has been breached
  • %VALUE%: the value of the metric
  • %VALUNIT%: the unit of the metric

Custom performance metrics

  • You can define custom metrics on any discovered performance metric
  • Use the Monitor name to define the name of your metric (Mind naming convention)
  • Use Target field to define the metric tags. You can use path variables as tag value:
    • MTE: %INSTANCE%\FileSystem\%FS%\UsedSpace
    • Target: instance:%INSTANCE%,filesystem:%FS%

Alternative metric

  • Many metrics have different naming from system to system
  • The Alternative check box can be used to define an alternative metric path to the previous rule.
  • You can define several alternative paths that you need, but it has to be mapped to the same metric.

Surveillance table

ParameterDescription
ActiveTo enable/disable a rule
MandatoryIf set to true, an error alarm will be generated if no metrics can be collected at the specified path
AlternativeIf set to true, the metric defined in this rule is an alternative to the previous one. This field is convenient to describe a metric which have different naming from one system to another, and stay with a generic configuration.
Monitor tree elementThe path to the metric
Monitor nameThe name to use for the generated metric
Alarm messageThe alarm message definition
ThresholdThe threshold definition, using CCMS style syntax, for example: G2W:80 W2C:90
TargetA coma separated list of tags: tag_name:tag_value. Variables defined in the metric path can be used here
DeltaIf you want to monitor a delta within time instead of an absolute value, you can enable that field and set a value in the delta time field. Useful when you work on metrics that are only reset at system startup.
Delta time (min)The length of the period to compute delta value of a metric
AlarmEnable to activate alarm sending
MetricEnable to activate metric sending

Examples

ActiveMandatoryAlternativeMonitor tree elementMonitor nameAlarm messageThresholdTargetDeltaDelta time (min)AlarmMetric
truetruefalse%INSTANCE%\CPU\UtilizationCPU_UTILIZATIONCPU utilization is %VALUE% (>%THRESH%)G2W:60 W2C:90instance:%INSTANCE%false0truetrue

Effect : Generates a WARNING alarm if CPU is between 60 and 90, and a Critical alarm if over 90. Generates a metric with the instance name as a target value

Examples

ActiveMandatoryAlternativeMonitor tree elementMonitor nameAlarm messageThresholdTargetDeltaDelta time (min)AlarmMetric
truetruefalse%INSTANCE%\Connections\Failed_connectionsFAILED_CONNECTION_60MIN%VALUE% failed connections since last 60 min (>=%THRESH%)G2W:100instance:%INSTANCE%true60truetrue

Effect : Sends an WARNING alarm if more than 100 failed connections occurred within the last 60 min. Generates a metric with instance name as target.

/home/clients/8c48b436badcd3a0bdaaba8c59a54bf1/wiki-web/data/pages/products/promonitor/6.8/monitorsguide/netweaver/customsapcontrolmonitoring.txt · Last modified: 2024/09/26 14:58 by rbariou