Configuration Reports

  • Article

Applies To: System Center Operations Manager 2007

Note

This topic has been updated in the latest version of the System Center Management Pack Authoring Guide on the TechNet Wiki.

Configuration reports in Operations Manager 2007 track changes in the properties of monitored objects. Following is a description of each Configuration generic report that includes a description of its report controls and report parameters. The parameter block of each report that can be copied into the definition of a linked report is also included.

Configuration Changes

Management Packs contain discoveries that collect object properties that are relevant for the management of the application. The data for the Configuration Changes report is derived from a delta-discovery done in the data warehouse where each discovery value is compared to the last known. If a change is detected, the changed property, the old and the new value and the time the change was discovered are recorded in the data warehouse.

The ID of the Configuration Changes report is Microsoft.SystemCenter.DataWarehouse.Report.ConfigurationChange.

Controls and Parameters

The controls that are used in the Configuration Changes report are shown in the following table with the parameters that each populates.

Control Parameters Description

Relative Data Time Picker

StartDate_BaseType

StartDate_BaseValue

StartDate_OffsetType

StartDate_OffsetValue

EndDate_BaseType

EndDate_BaseValue

EndDate_OffsetType

EndDate_OffsetValue

TimeZone

TimeZoneName

All alerts that were raised in the date and time range are included in the report. These are the standard date parameters described in Common Parameters.

This control can be removed if a defined relative data time range is provided for the parameter.

Monitoring Object XML Picker

ObjectList

ManagementGroupId

Specifies the groups or objects that are included in the report. This includes an ID from the data warehouse so that the parameters cannot be populated without the control. This is the standard Object XML Picker control described in Common Report Controls.

This control should not be removed from the report.

Parameter Block

The following is the parameter block for the Configuration Changes report. You can copy it into a linked report based on the Configuration report to replicate the controls of the base report.

<ParameterBlock columns="3" xmlns="https://schemas.microsoft.com/mom/reporting/2007/ReportParameterSettings">
   <Controls>
      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.RelativeDateTimePicker">
         <ReportParameters>
            <ReportParameter name="TimeZone" binding="TimeZone">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.TimeZone</Prompt>
            </ReportParameter>
            <ReportParameter name="TimeZoneName" binding="TimeZoneName" />
            <ReportParameter name="StartDate_BaseType" binding="StartDate_BaseType" />
            <ReportParameter name="StartDate_BaseValue" binding="StartDate_BaseValue">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.StartDateTime</Prompt>
            </ReportParameter>
            <ReportParameter name="StartDate_OffsetType" binding="StartDate_OffsetType" />
            <ReportParameter name="StartDate_OffsetValue" binding="StartDate_OffsetValue" />
            <ReportParameter name="EndDate_BaseType" binding="EndDate_BaseType" />
            <ReportParameter name="EndDate_BaseValue" binding="EndDate_BaseValue">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.EndDateTime</Prompt>
            </ReportParameter>
            <ReportParameter name="EndDate_OffsetType" binding="EndDate_OffsetType" />
            <ReportParameter name="EndDate_OffsetValue" binding="EndDate_OffsetValue" />
         </ReportParameters>
      </Control>
      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.MonitoringObjectXmlPicker" columnSpan="2">
         <ReportParameters>
            <ReportParameter name="ObjectList">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.ObjectList</Prompt>
            </ReportParameter>
            <ReportParameter name="ManagementGroupId" binding="GroupList" />
         </ReportParameters>
      </Control>
   </Controls>
</ParameterBlock>

Custom Configuration

A management pack contains discoveries that collect information specific to the management pack. For all selected objects the Custom Configuration report displays the properties discovered by management packs. By checking the box a property can be selected to be printed on the report. The controls to the right allow defining the order of the selected properties from left (higher in the parameter list) to right (lower in the parameter list).

The ID of the Custom Configuration report is Microsoft.SystemCenter.DataWarehouse.Report.CustomConfiguration.

Controls and Parameters

The controls that are used in the Custom Configuration report are shown in the following table with the parameters that each populates.

Control Parameters Description

Relative Data Time Picker

StartDate_BaseType

StartDate_BaseValue

StartDate_OffsetType

StartDate_OffsetValue

EndDate_BaseType

EndDate_BaseValue

EndDate_OffsetType

EndDate_OffsetValue

TimeZone

TimeZoneName

All alerts that were raised in the date and time range are included in the report. These are the standard date parameters described in Common Parameters.

This control can be removed if a defined relative data time range is provided for the parameter.

Monitoring Object XML Picker

ObjectList

ManagementGroupId

Specifies the groups or objects that are included in the report. This includes an ID from the data warehouse so that the parameters cannot be populated without the control. This is the standard Object XML Picker control described in Common Report Controls.

This control should not be removed from the report.

Report Column Picker

Columns

Specifies the columns to be included in the output of the report and the columns that are used to filter the returned data. This is described below in more detail.

This control can be removed if a set of column definitions is provided for this parameter.

Columns Parameter

The Columns parameter defines the columns to include in the output of the report and the columns that are used to filter the output. The following table lists the values that are required to define each column.

ID Node

Specifies the node defining the ID of the property. If the Operations console is used, this will be the GUID of the property. This should be changed to an $MPElement variable so that the management pack can be transferred between management groups.

Visible Attribute

Specifies the attribute with a value of True or False that determines whether the column is displayed. If the value is False, the column is only used to filter the output.

Filter Node

If used, this node identifies the column as being used for filtering the output. The Type attribute can be either Contains or Equals, and the content of the node includes the text to match.

If the column should only be displayed, but not used for filtering, the filter node is not included.

All properties are included as a single parameter entry using the syntax shown in the following example. This example shows a report that uses the following parameters of the Microsoft.Windows.Computer class and is filtered for computers that include ‘srv’ in the name:

  • PrincipalName

  • IPAddress

  • ActiveDirectorySite

<Data>
   <Columns>
      <Column Visible="True">
         <ID>$MPElement[Name="Windows!Microsoft.Windows.Computer"]/PrincipleName$</ID>
         <Filter Type="Contains">srv</Filter>
      </Column>
      <Column Visible="True">
         <ID>$MPElement[Name="Windows!Microsoft.Windows.Computer"]/IPAddress$</ID>
      </Column>
      <Column Visible="True">
         <ID>$MPElement[Name="Windows!Microsoft.Windows.Computer"]/ActiveDirectorySite$</ID>
      </Column>
   </Columns>
</Data>

Parameter Block

The following is the parameter block for the Custom Configuration report. You can copy it into a linked report based on the Custom Configuration report to replicate the controls of the base report.

<ParameterBlock columns="6" xmlns="https://schemas.microsoft.com/mom/reporting/2007/ReportParameterSettings">
   <Controls>
      <Control columnSpan="1" type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.RelativeDateTimePicker">
         <ReportParameters>
            <ReportParameter name="TimeZone" binding="TimeZone">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.TimeZone</Prompt>
            </ReportParameter>
            <ReportParameter name="TimeZoneName" binding="TimeZoneName" />
            <ReportParameter name="StartDate_BaseType" binding="StartDate_BaseType" />
            <ReportParameter name="StartDate_BaseValue" binding="StartDate_BaseValue">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.StartDateTime</Prompt>
            </ReportParameter>
            <ReportParameter name="StartDate_OffsetType" binding="StartDate_OffsetType" />
            <ReportParameter name="StartDate_OffsetValue" binding="StartDate_OffsetValue" />
            <ReportParameter name="EndDate_BaseType" binding="EndDate_BaseType" />
            <ReportParameter name="EndDate_BaseValue" binding="EndDate_BaseValue">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.EndDateTime</Prompt>
            </ReportParameter>
            <ReportParameter name="EndDate_OffsetType" binding="EndDate_OffsetType" />
            <ReportParameter name="EndDate_OffsetValue" binding="EndDate_OffsetValue" />
         </ReportParameters>
      </Control>
      <Control columnSpan="3" type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.MonitoringObjectXmlPicker">
         <ReportParameters>
            <ReportParameter name="ObjectList">
               <Prompt>Microsoft.SystemCenter.DataWarehouse.Report.Library!Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.ObjectList</Prompt>
            </ReportParameter>
            <ReportParameter name="ManagementGroupId" binding="GroupList" />
         </ReportParameters>
      </Control>
      <Control columnSpan="2" type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.ReportColumnPicker">
         <ReportParameters>
            <ReportParameter name="Properties" />
            <ReportParameter name="ColumnList" binding="ColumnList" />
         </ReportParameters>
      </Control>
   </Controls>
</ParameterBlock>

See Also

Concepts

Common Parameters
Date Report Controls
Common Report Controls