Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider

Article
05/16/2012

Applies To: Operations Manager 2007 R2

The Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider data source module type returns performance counter data of the specified service on the target host of a rule or monitor. The module returns the data as System.Performance.Data data.

Usage

This module will issue a WMI query for performance data against the Service Control Manager at the specified frequency.

Type Definition

<DataSourceModuleType ID="Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider" Accessibility="Public">
  <Configuration>
    <xsd:element name="ServiceName" type="xsd:string" />
    <xsd:element name="ObjectName" type="xsd:string" />
    <xsd:element name="CounterName" type="xsd:string" />
    <xsd:element name="InstanceName" type="xsd:string" />
    <xsd:element name="Value" type="xsd:string" />
    <xsd:element name="Frequency" type="xsd:integer" />
  </Configuration>
  <OverrideableParameters>
    <OverrideableParameter ID="Frequency" ParameterType="int" Selector="$Config/Frequency$" />
  </OverrideableParameters>
  <ModuleImplementation>
    <Composite>
      <MemberModules>
        <DataSource TypeID="Microsoft.SystemCenter.NTService.FilteredWin32ServiceInformationProvider" ID="DS">
          <ComputerName>$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</ComputerName>
          <ServiceName>$Config/ServiceName$</ServiceName>
          <Frequency>$Config/Frequency$</Frequency>
        </DataSource>
        <ProbeAction TypeID="Windows!Microsoft.Windows.WmiProbe" ID="Probe">
          <NameSpace>\\$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$\ROOT\CIMV2</NameSpace>
          <Query>SELECT * FROM Win32_PerfFormattedData_PerfProc_Process WHERE IDProcess=$Data/Property[@Name='ProcessId']$</Query>
        </ProbeAction>
        <ConditionDetection TypeID="Performance!System.Performance.DataGenericMapper" ID="CD">
          <ObjectName>$Config/ObjectName$</ObjectName>
          <CounterName>$Config/CounterName$</CounterName>
          <InstanceName>$Config/InstanceName$</InstanceName>
          <Value>$Config/Value$</Value>
        </ConditionDetection>
      </MemberModules>
      <Composition>
        <Node ID="CD">
          <Node ID="Probe">
            <Node ID="DS" />
          </Node>
        </Node>
      </Composition>
    </Composite>
  </ModuleImplementation>
  <OutputType>Performance!System.Performance.Data</OutputType>
</DataSourceModuleType>

Parameters

The Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider module supports the following configuration parameters:

Parameter	Type	Description
ServiceName	String	Required parameter. Specifies the Windows NT service name.
ObjectName	String	Required parameter. Specifies the Windows NT performance object name.
CounterName	String	Required parameter. Specifies the name of the Windows NT performance counter.
InstanceName	String	Required parameter. Contains the Windows NT performance instance.
Value	String	Required parameter. Contains the numeric value for the performance value.
Frequency	Integer	Required parameter. The frequency in seconds at which the module is to request service performance information.

Counter Selection

The CounterName and ObjectName parameters identify the Windows performance counter to collect. The values entered here depend on the performance counters that are running on the computer that is being targeted with the workflow that contains the module. The Windows performance monitor can be used to identify available performance counters.

For example, the following configuration collects the average disk queue length on the logical disk object:

<CounterName>ArrivalRate</CounterName>
<ObjectName>HTTP Service Request Queue</ObjectName>

Value

The Value parameter is the string representation of the numeric performance value.

Composition

The Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider module is a composite module that contains the following member modules:

Workflow Run Order	Module Type	Usage
1	Microsoft.SystemCenter.NTService.FilteredWin32ServiceInformationProvider	Internal module. Retrieves the Process ID of the specified service. This Process ID is then passed to the subsequent module.
2	Microsoft.Windows.WmiProbe	Issues the WMI query to retrieve the performance related data as System.PropertyBagData data.
3	System.Performance.DataGenericMapper	Maps the incoming System.PropertyBagData data to to System.Performance.Data data.

Module Type	Usage
Microsoft.Windows.NTServiceStateProvider	Provides the state information of a specific Windows NT service.
Microsoft.Windows.Win32ServiceInformationProbe	Provides information about the specified Win32 service.

External Module References

The Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider module is a member of the following modules:

Module Type	Library	Usage

Remarks

Sample

Information


Module Type	DataSourceModuleType
Input Type	None
Output Type	a6fdf3a1-729f-41a2-ae3e-dfb3e8f28bc7
Implementation	Native
Library	Microsoft.SystemCenter.Library