Share via


System.Performance.PerformanceLogDataProvider

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

The System.Performance.PerformanceLogDataProvider data source module type is used to provide log entry data from a directory that contains Windows performance log files. This module returns each generic log file’s entry data as System.Performance.Data data.

Usage

Use the module to provide performance log entry data as System.Performance.Data data from within a workflow..

Type Definition

<DataSourceModuleType ID="System.Performance.PerformanceLogDataProvider" Accessibility="Public">
  <Configuration>
    <xsd:element name="LogFileDirectory" type="xsd:string" />
    <xsd:element name="LogFilePattern" type="xsd:string" />
    <xsd:element name="LogIsUTF8" type="xsd:string" />
  </Configuration>
  <ModuleImplementation>
    <Composite>
      <MemberModules>
        <DataSource TypeID="System.Performance.PerformanceLogProviderDS" ID="DS">
          <LogFileType>5</LogFileType>
          <LogFileDirectory>$Config/LogFileDirectory$</LogFileDirectory>
          <LogFilePattern>$Config/LogFilePattern$</LogFilePattern>
          <LogIsUTF8>$Config/LogIsUTF8$</LogIsUTF8>
        </DataSource>
      </MemberModules>
      <Composition>
        <Node ID="DS" />
      </Composition>
    </Composite>
  </ModuleImplementation>
  <OutputType>System.Performance.Data</OutputType>
</DataSourceModuleType>

Parameters

The System.Performance.PerformanceLogDataProvider module supports the configuration parameters described in the following table.

Parameter Type Overrideable Description

LogFileDirectory

String

False

Required parameter. Contains the full path to the local directory to read the log file or files from.

LogFilePattern

String

False

Required parameter. Contains the file name or wildcard pattern to match for the log files.

LogIsUTF8

Boolean

False

Required parameter. Indicates whether the log file is UTF8-encoded. The value should be either true or false.

For information on the LogFileDirectory and LogFilePattern parameters, see System.ApplicationLog.GenericLogReader.

Remarks

For remarks, see System.ApplicationLog.GenericLogReader.

Composition

The System.Performance.PerformanceLogDataProvider module is a composite module that contains the member modules described in the following table.

Workflow Run Order Module Type Usage

1

System.Performance.PerformanceLogProviderDS

Internal module.

Errors

The following errors can occur from within the System.Performance.PerformanceLogDataProvider module.

EventID Reason

31708

The log directory specified in the LogFileDirectory parameter can no longer be found.

31709

The log directory specified in the LogFileDirectory parameter cannot be accessed.

31710

The current log file being processed has suddenly disappeared from the directory.

31711

The current log file being processed cannot be accessed. The module will continue to try and read the file.

None.

External Module References

None.

Sample

<Rule ID="Microsoft.Samples.WindowsPerfLogToPerformanceData" Target="Microsoft.Samples.TheApplication" Enabled="true">
 <DataSources>
    <DataSource ID="LogDS" TypeID="Perf!System.Performance.PerformanceLogDataProvider">
      <LogFileDirectory>C:\logs</LogFileDirectory>
      <LogFilePattern>*.log</LogFilePattern>
      <LogIsUTF8>false</LogIsUTF8>
    </DataSource>
  </DataSources>
  <ConditionDetection TypeID="System!System.Performance.DataGenericMapper" ID="Mapper">
    <ObjectName>$Target/Id$</ObjectName>
    <CounterName>$Data/Params/Param[1]$</CounterName>
    <PublisherName>PerformanceLog</PublisherName>
    <InstanceName/>
    <Value>$Data/Params/Param[2]$</Value>
  </ConditionDetection>
  <WriteActions>
    <WriteAction ID="WriteToDB" TypeID="SCLibrary!Microsoft.SystemCenter.CollectPerformanceData"/>
    <WriteAction ID="WriteToDW" TypeID="SCDW!Microsoft.SystemCenter.DataWarehouse.PublishPerformanceData"/>
  </WriteActions>

</Rule>

Information

   

Module Type

DataSourceModuleType

Input Type

None

Output Type

System.Performance.Data

Implementation

Composite

Library

System.Performance.Library