Share via


UnitMonitor

Applies To: System Center 2012 - Operations Manager, System Center 2012 R2 Operations Manager, System Center 2012 SP1 - Operations Manager

Defines an implementation of a unit monitor type definition that determines the health of targeted class type instances.

Schema Hierarchy

ManagementPack
  Monitoring
    Monitors
      UnitMonitor

Syntax

<UnitMonitor Id=”UnitMonitorID” Comment=”Comment” Accessibility=”Public/Internal” Enabled=”True/False” Target=”TargetClassID” ParentMonitorID=”ParentMonitorID” Remotable=”True/False” Priority=”Normal” RunAs=”SecureReferenceID” TypeID=”UnitMonitorTypeID”>
  <Category></Category>
  <AlertSettings AlertMessage=”StringResourceID”>…</AlertSettings>
  <OperationalStates>…</OperationalStates>
  <Configuration>…</Configuration> 
</UnitMonitor>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of a UnitMonitor element.

Attributes

Attribute Description

ID

Required attribute. Represents the identity of the element. To learn how to identify your element in a management pack, see Element Identity and Namespace Conventions.

Comment

Optional attribute. Represents commentary by the management pack author.

Enabled

Required attribute. Defines whether or not this monitor is by default enabled or disabled.

Target

Required attribute. The ID of the targeted class type.

ParentMonitorID

Required attribute. The monitor to which this monitor rolls up on the same class type.

Remotable

Optional attribute. Defines whether or not this monitor will run for agentless monitoring. Default value is true.

Accessibility

Required attribute. Defines the visibility of the monitor.

RunAs

Optional attribute. Refers to a SecureReference type ID. All instances of this monitor type will run under the credentials set for the secure reference.

TypeID

Required attribute. The ID UnitMonitorType type from which this monitor gets its configuration schema definition.

Priority

Optional attribute for internal use only. If specified, always set to “Normal.”

Accessibility Attribute Values

Value Description

Public

Indicates that the monitor is visible to external management packs.

Internal

Indicates that the monitor is not visible to external management packs.

Enabled Attribute Values

Value Description

True

The monitor is enabled when its target class has been discovered.

False

The monitor is disabled even when its target class has been discovered.

Child Elements

Element Description

Category (UnitMonitor)

Required element. Represents the category name of a unit monitor.

AlertSettings (UnitMonitor)

Optional element. Defines the alert to generate when the monitor reflects a specified unhealthy state.

OperationalStates

Required element. Contains mappings between health states and the monitor type states defined in the monitor’s unit monitor type.

OperationalStates

Required element. Provides the appropriate configuration data based on the configuration schema defined in a monitor’s unit monitor type.

Parent Elements

Element Description

Monitors

Contains monitor definitions targeted at a specific class type.

Remarks

Unit monitors are implementations of the various unit monitor types that are defined in the core system management packs. Each unit monitor type accesses instrumentation data from such sources as Windows events, Windows performance, application logs, and Simple Network Management Protocol (SNMP). These types define a workflow that is designed to determine the two or three operational states of the monitor. A unit monitor type is health agnostic and serves to provide the workflow framework and configuration definition of the monitor. For more information, see UnitMonitorType.

The unit monitor serves to implement any one of the unit monitor types. It is responsible for mapping its own health state to the monitor type states that are defined by the unit monitor type. It is also responsible for providing the correct configuration XML in accordance with the type schema.

Unit monitors always roll up to a parent aggregate monitor and, ultimately, up to one of the aggregate monitors that are defined in the System.Library management pack. For more information, see AggregateMonitor

Example

The following XML sample demonstrates how to define a unit monitor of a predefined monitor type, Microsoft.Windows.2SingleEventLog2StateMonitorType, which uses the Windows event log to collect instrumentation data. To view the definition of Microsoft.Windows.2SingleEventLog2StateMonitorType, see UnitMonitorType.

      
<UnitMonitor ID="Microsoft.Windows.Client.Vista.NetworkAdapter.NetworkAdapterConnectionHealth" Accessibility="Public" Enabled="false" Target="Vista!Microsoft.Windows.Client.Vista.NetworkAdapter" ParentMonitorID="SystemHealth!System.Health.AvailabilityState" Remotable="true" Priority="Normal" TypeID="Windows!Microsoft.Windows.2SingleEventLog2StateMonitorType" ConfirmDelivery="false">
  <Category>AvailabilityHealth</Category>
  <AlertSettings AlertMessage="Microsoft.Windows.Client.Vista.NetworkAdapter.NetworkAdapterConnectionHealth.AlertMessage">
    <AlertOnState>Error</AlertOnState>
    <AutoResolve>true</AutoResolve>
    <AlertPriority>Normal</AlertPriority>
    <AlertSeverity>Error</AlertSeverity>
    <AlertParameters>
      <AlertParameter1>$Target/Property[Type="System!System.Entity"]/DisplayName$</AlertParameter1>
    </AlertParameters>
  </AlertSettings>
  <OperationalStates>
    <OperationalState ID="Disconnected" MonitorTypeStateID="FirstEventRaised" HealthState="Error" />
    <OperationalState ID="Connected" MonitorTypeStateID="SecondEventRaised" HealthState="Success" />
  </OperationalStates>
  <Configuration>
    <FirstComputerName>$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</FirstComputerName>
    <FirstLogName>System</FirstLogName>
    <FirstExpression>
      <And>
        <Expression>
          <SimpleExpression>
            <ValueExpression>
              <XPathQuery>EventSourceName</XPathQuery>
            </ValueExpression>
            <Operator>Equal</Operator>
            <ValueExpression>
              <Value>Tcpip</Value>
            </ValueExpression>
          </SimpleExpression>
        </Expression>
        <Expression>
          <And>
            <Expression>
              <SimpleExpression>
                <ValueExpression>
                  <XPathQuery>Params/Param[2]</XPathQuery>
                </ValueExpression>
                <Operator>Equal</Operator>
                <ValueExpression>
                  <Value>$Target/Property[Type="System!System.Entity"]/DisplayName$</Value>
                </ValueExpression>
              </SimpleExpression>
            </Expression>
            <Expression>
              <SimpleExpression>
                <ValueExpression>
                  <XPathQuery>EventDisplayNumber</XPathQuery>
                </ValueExpression>
                <Operator>Equal</Operator>
                <ValueExpression>
                  <Value>4202</Value>
                </ValueExpression>
              </SimpleExpression>
            </Expression>
          </And>
        </Expression>
        <Expression>
          <Not>
            <Expression>
              <SimpleExpression>
                <ValueExpression>
                  <Value>$Target/Property[Type="WindowsClient!Microsoft.Windows.Client.NetworkAdapter"]/AdapterType$</Value>
                </ValueExpression>
                <Operator>Equal</Operator>
                <ValueExpression>
                  <Value>Wireless</Value>
                </ValueExpression>
              </SimpleExpression>
            </Expression>
          </Not>
        </Expression>
        <Expression>
          <Not>
            <Expression>
              <SimpleExpression>
                <ValueExpression>
                  <Value>$Target/Property[Type="WindowsClient!Microsoft.Windows.Client.NetworkAdapter"]/AdapterType$</Value>
                </ValueExpression>
                <Operator>Equal</Operator>
                <ValueExpression>
                  <Value>Infrared Wireless</Value>
                </ValueExpression>
              </SimpleExpression>
            </Expression>
          </Not>
        </Expression>
      </And>
    </FirstExpression>
    <SecondComputerName>$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</SecondComputerName>
    <SecondLogName>System</SecondLogName>
    <SecondExpression>
      <And>
        <Expression>
          <SimpleExpression>
            <ValueExpression>
              <XPathQuery>EventSourceName</XPathQuery>
            </ValueExpression>
            <Operator>Equal</Operator>
            <ValueExpression>
              <Value>Tcpip</Value>
            </ValueExpression>
          </SimpleExpression>
        </Expression>
        <Expression>
          <And>
            <Expression>
              <SimpleExpression>
                <ValueExpression>
                  <XPathQuery>Params/Param[2]</XPathQuery>
                </ValueExpression>
                <Operator>Equal</Operator>
                <ValueExpression>
                  <Value>$Target/Property[Type="System!System.Entity"]/DisplayName$</Value>
                </ValueExpression>
              </SimpleExpression>
            </Expression>
            <Expression>
              <SimpleExpression>
                <ValueExpression>
                  <XPathQuery>EventDisplayNumber</XPathQuery>
                </ValueExpression>
                <Operator>Equal</Operator>
                <ValueExpression>
                  <Value>4201</Value>
                </ValueExpression>
              </SimpleExpression>
            </Expression>
          </And>
        </Expression>
      </And>
    </SecondExpression>
  </Configuration>
</UnitMonitor>

See Also

Reference

UnitMonitorType