Garbage Collection Rate

Microsoft.JEE.PerformanceHealth.GarbageCollectorRateMonitor (UnitMonitor)

The performance monitor for the garbage collection rate of an application server.

Knowledge Base article:

Summary

The garbage collection rate performance monitor tracks the rate at which garbage collections are happening on the Java Virtual Machine associated with the application server.

Causes

An unhealthy state indicates that the garbage collector has exceeded the monitored threshold configured for the application server.

Resolutions

Start the application server with a larger memory configuration.
Move some deployed applications to another application server.

Element properties:

Target

Microsoft.JEE.GarbageCollector

Parent Monitor

System.Health.PerformanceState

Category

PerformanceHealth

Enabled

False

Alert Generate

True

Alert Severity

MatchMonitorHealth

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

Microsoft.JEE.ThresholdDeltaUnitMonitor

Remotable

True

Accessibility

Public

Alert Message

Garbage collector rate monitor exceeded

The garbage collector rate monitor exceeded its threshold for application server ID: {0}, Object Name: {1}, Counter Name: {2}, Instance Name: {3}

RunAs

Default

Source Code:

<UnitMonitor ID="Microsoft.JEE.PerformanceHealth.GarbageCollectorRateMonitor" Accessibility="Public" Enabled="false" Target="Microsoft.JEE.GarbageCollector" ParentMonitorID="Health!System.Health.PerformanceState" Remotable="true" Priority="Normal" TypeID="Microsoft.JEE.ThresholdDeltaUnitMonitor" ConfirmDelivery="true">

  <Category>PerformanceHealth</Category>

  <AlertSettings AlertMessage="Microsoft.JEE.PerformanceHealth.GarbageCollectorRateMonitor_AlertMessageResourceID">

    <AlertOnState>Warning</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>MatchMonitorHealth</AlertSeverity>

    <AlertParameters>

      <!-- The alert description should include key properties of:   -->

      <!-- * the deep monitored application server                   -->

      <!-- * the performance counter object name                     -->

      <!-- * counter name                                            -->

      <!-- * instance name                                           -->

      <AlertParameter1>$Target/Host/Property[Type="Microsoft.JEE.ApplicationServer.Monitored.Instance"]/Id$</AlertParameter1>

      <AlertParameter2>Garbage Collector</AlertParameter2>

      <AlertParameter3>JVM Garbage Collector Collection Count Change Rate</AlertParameter3>

      <AlertParameter4>$Target/Property[Type="Microsoft.JEE.GarbageCollector"]/GarbageCollectorName$</AlertParameter4>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="Microsoft.JEE.PerformanceHealth.GC.Rate.UnderThreshold" MonitorTypeStateID="UnderThreshold" HealthState="Success"/>

    <OperationalState ID="Microsoft.JEE.PerformanceHealth.GC.Rate.OverThreshold" MonitorTypeStateID="OverThreshold" HealthState="Warning"/>

  </OperationalStates>

  <Configuration>

    <ComputerName>$Target/Host/Property[Type="Microsoft.JEE.ApplicationServer.Monitored.Instance"]/HostName$</ComputerName>

    <Protocol>$Target/Host/Property[Type="Microsoft.JEE.ApplicationServer.Monitored.Instance"]/Protocol$</Protocol>

    <Port>$Target/Host/Property[Type="Microsoft.JEE.ApplicationServer.Monitored.Instance"]/Port$</Port>

    <BaseURL/>

    <URLSuffix/>

    <IntervalSeconds>900</IntervalSeconds>

    <TimeoutSeconds>300</TimeoutSeconds>

    <!-- Need to find the GCCollectionCount that has a sibling element     -->

    <!-- called GCName with a value of (for example) "PS Scavenge"         -->

    <!-- XPath should look like:                                           -->

    <!-- /Stats/GC/Properties/GCCollectionTime[../GCName = "PS Scavenge"]  -->

    <MetricName>/Stats/GC/Properties/GCCollectionCount[../GCName = "$Target/Property[Type="Microsoft.JEE.GarbageCollector"]/GarbageCollectorName$"]$</MetricName>

    <!-- The spec says that a value of 30 GC's per hour is the threshold -->

    <!-- as the monitor runs every 300 seconds (5 mins) an value of 5    -->

    <!-- GC's per interval has been chosen                               -->

    <Threshold>5</Threshold>

    <SampleCount>2</SampleCount>

  </Configuration>

</UnitMonitor>