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. |
Related Modules
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 |
|
Input Type |
None |
Output Type |
|
Implementation |
Composite |
Library |
System.Performance.Library |