products:promonitor:6.8:monitorsguide:netweaver:workprocesses

Work processes

Work processes are the actual workers in SAP. It is important to check their state, availability and run time. 
This monitor will watch work processes of all kinds, with the ability to tune the monitoring for specific tasks or cases.
It will detect long running processes, stopped or private processes, compute the usage ratio,
and notify as soon as a threshold on those metrics is reached.

Configuration hints

  • This monitor allows to send an alarm if it finds too many work processes in a given state, or if some are running for too long.
  • To start the configuration, create a rule in the surveillance table.
  • You can use the User filter to watch processes used by a specific user or group of users (regular expression)

Task filter

  • Select the specific task for which you want to check the processes.
  • You can also select ANY if you want to build a general rule to match any kind of work process

State filter

  • Will select only the work processes of the give state.
  • This allows to monitor the number of processes being in a given state, for example PRIVATE or STOPPED, which are states you want to avoid.

Runtime threshold

  • You can set the maximum runtime for a given type of work process.
  • All WP matching the task and state filter, running for more than threshold will generate an alarm

Count threshold

  • You can set the maximum number work processes to be in a given state, in absolute value or in ratio of the total.
  • For example, to get an alarm when 80% of DIALOG work processes are RUNNING.
  • The threshold will be used only if aggregate is active.
  • If Per instance is OFF, the count threshold will be compared against work processes of all active application servers.
  • Activate per instance when you want to get alarms for each application server individually
    • Example: More than 80% DIALOG WP used on one instance

Aggregate settings

  • Activate aggregate option for detecting and alerting when a number of WP matching the filter is above threshold.
    • Example: More than 80% DIALOG WP in RUNNING state
  • Deactivate aggregate to receive alarms for each individual WP:
    • Example: WP #1 is in STOPPED state.

Note:

  • Thresholds are independent and can be set to 0 if not used.

Surveillance table

ParameterDescription
ActiveUse this field to activate or deactivate a line of configuration.
TaskThe type of workprocess to watch, or ANY to watch all.
StatusWatch for the processes of the given status
UserA filter to match only the process used by the given user. Regular expressions may be used.
Runtime threshold (elapsed in sec)The threshold for the maximum runtime (seconds) of a given process. Does not depend on the configured status.
Count threshold (nb or %)The threshold for the number of processes being in the defined status. Use an absolute value or a percentage of the total number of processes available for the given task (specify % unit).
SeverityThe level of severity of the alarm generated by this line of surveillance.
AggregateIf checked, The total number of WPs matching the filter will be reported.
Per instanceIf checked, The workprocesses usage will computed by instance, instead of globally
Auto clearIf checked, the alarm will be cleared as soon as the alarm condition is not met anymore.
Alarm tagThis field allows to add custom text within the alarm message. %MSG% variable will contain the actual generated message and can be used such as: “my_prefix %MSG% my_suffix”. By default, tag will be used as prefix.
AlarmIf checked, this line of surveillance will be used for alarm generation.
MetricIf checked, this line of surveillance will be used for QOS generation.
ReportIf checked, this line of surveillance will used for showing threshold and severity in the daily report

Examples

ActiveTaskStatusUserRuntime threshold (elapsed in sec)Count threshold (nb or %)SeverityAuto clearAlarm tagAlarmMetricReport
trueDIALOGRUNNING*9080%MAJORtrue truefalsefalse

Effect : Send a MAJOR alarm for any DIALOG process running a task since more than 90 sec or if 80% of the DIALOG processes are in RUNNING state.

Examples

ActiveTaskStatusUserRuntime threshold (elapsed in sec)Count threshold (nb or %)SeverityAuto clearAlarm tagAlarmMetricReport
trueDIALOGPRIV*01CRITICALtrue truefalsefalse

Effect : Send a CRITICAL alarm if one DIALOG process is in PRIVATE status

Examples

ActiveTaskStatusUserRuntime threshold (elapsed in sec)Count threshold (nb or %)SeverityAuto clearAlarm tagAlarmMetricReport
trueANYSTOPPED*01CRITICALtrue truefalsefalse

Effect : Send a CRITICAL alarm if any process is in STOPPED state

Examples

ActiveTaskStatusUserRuntime threshold (elapsed in sec)Count threshold (nb or %)SeverityAuto clearAlarm tagAlarmMetricReport
trueSPOOLRUNNINGJDOE1200WARNINGfalse truefalsefalse

Effect : Send a WARNING alarm each time user JDOE runs a SPOOL task for more than 120 seconds. Do not clear the alarm

Generated metrics

metricIdmetricUnitmetricTargetmetricDescription
WORKPROCESSES_PERCENTAGE_USEDPercent or Work processes[INSTANCE][TASK][STATUS]Sends the usage ratio of a work process of a given type
WORKPROCESSES_USED_COUNTPercent or Work processes[INSTANCE][TASK][STATUS]Sends the number of a work processes of a given type
WORKPROCESSES_FREE_COUNTWork processes[INSTANCE][TASK]Sends the number of work processes in WAITING state for a given task
/home/clients/8c48b436badcd3a0bdaaba8c59a54bf1/wiki-web/data/pages/products/promonitor/6.8/monitorsguide/netweaver/workprocesses.txt · Last modified: 2025/02/10 16:27 by rbariou