Overall CPU Usage

ComTrade.EMC.Documentum.Windows.AgentExec.CPU.Usage.Monitor (UnitMonitor)

Monitors if the overall processor usage in percentage of a Job Execution Agent process and sub-processes is over a predefined threshold.

Knowledge Base article:

Summary

This monitor checks the total percentage processor time usage of a Job Execution Agent.

Configuration

The following configuration parameters are customizable:

IntervalSeconds - The recurring interval of time in seconds in which to run the script (the default value is set to 300 seconds).
SyncTime - The synchronization time specified by using a 24-hour format. No default value specified.
WarningLevel - The value that defines the warning threshold to be used in the comparison (the default value is set to 70 percentage).
CriticalLevel - The value that defines the critical threshold to be used in the comparison (the default value is set to 90 percentage).

Causes

In case of high processor time usage the executed jobs are possibly not optimized, or node has performance bottleneck.

Batch jobs can be scheduled for best performances.

Element properties:

Target

ComTrade.EMC.Documentum.Windows.AgentExec

Parent Monitor

System.Health.PerformanceState

Category

AvailabilityHealth

Enabled

False

Alert Generate

True

Alert Severity

MatchMonitorHealth

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

ComTrade.EMC.Documentum.Windows.AgentExec.ThreeStateMonitorTypeII

Remotable

True

Accessibility

Public

Alert Message

Job Execution Agent Overall CPU Usage

Overall CPU usage {0}\% of all dm_agent_exec processes for {1} repository exceeded threshold value.

RunAs

Default

Source Code:

<UnitMonitor ID="ComTrade.EMC.Documentum.Windows.AgentExec.CPU.Usage.Monitor" Accessibility="Public" Enabled="false" Target="CTDmWinDisc!ComTrade.EMC.Documentum.Windows.AgentExec" ParentMonitorID="Health!System.Health.PerformanceState" Remotable="true" Priority="Normal" TypeID="ComTrade.EMC.Documentum.Windows.AgentExec.ThreeStateMonitorTypeII" ConfirmDelivery="true">

  <Category>AvailabilityHealth</Category>

  <AlertSettings AlertMessage="ComTrade.EMC.Documentum.Windows.AgentExec.CPU.Usage.Monitor_AlertMessageResourceID">

    <AlertOnState>Error</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>MatchMonitorHealth</AlertSeverity>

    <AlertParameters>

      <AlertParameter1>$Data/Context/Property[@Name='OverallCPU']$</AlertParameter1>

      <AlertParameter2>$Target/Property[Type="CTDmLib!ComTrade.EMC.Documentum.Repository.Component"]/Name$</AlertParameter2>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="UIGeneratedOpStateIdAgentExecCPUUsageHealthy" MonitorTypeStateID="Healthy" HealthState="Success"/>

    <OperationalState ID="UIGeneratedOpStateIdAgentExecCPUUsageWarning" MonitorTypeStateID="Warning" HealthState="Warning"/>

    <OperationalState ID="UIGeneratedOpStateIdAgentExecCPUUsageCritical" MonitorTypeStateID="Critical" HealthState="Error"/>

  </OperationalStates>

  <Configuration>

    <IntervalSeconds>300</IntervalSeconds>

    <SyncTime/>

    <RepositoryName>$Target/Property[Type="CTDmLib!ComTrade.EMC.Documentum.Repository.Component"]/Name$</RepositoryName>

    <RepositoryId>$Target/Property[Type="CTDmLib!ComTrade.EMC.Documentum.Repository.Component"]/Id$</RepositoryId>

    <FilterData>1</FilterData>

    <WarningLevel>70</WarningLevel>

    <CriticalLevel>90</CriticalLevel>

    <ValueProperty>OverallCPU</ValueProperty>

    <TargetComputer>$Target/Host/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</TargetComputer>

  </Configuration>

</UnitMonitor>