Share via

Microsoft.SystemCenter.NTService.Frequency.PerfCounterProvider

  • Article

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