Show TOC

 Creating a Report DefinitionLocate this document in the navigation structure

Use

A report definition is the basis of Central Performance History Reports. A definition of this type specifies which MTE classes are displayed in reports that are based on this definition. The report definition also contains, in Output Data Format, details about the aggregate type and resolution that are used for the report (see Aggregation).

Note

By default, only the frequently used output data formats are available. To be able to use all combinations of aggregate type and resolution in the report definition, set the additional reporting options (see Changing Extended Settings of the Central Performance History).

However, the following are not included in a report definition:

  • The time period from which the performance values of the report come
  • The performance values of the MTE classes selected for the report
  • The time at which the report is to be executed or information about repeated scheduling of the report as a job.

The definition of a report therefore contains all of the information about the report that does not change for repeated execution of the report. By separating the creation of the report definition from the report execution (see Scheduling and Executing a Report), you can execute a report definition manually or have it automatically executed repeatedly, without having to deal with the data basis and its formatting.

Procedure
  1. You can create a report definition from several functions:
    • In the overview screen of the CPH (transaction RZ23N), choose, in the Reporting group box, the Define Reports pushbutton.
    • In any screen that has an input field for a report definition, use the input help for this field to select a report. You can display the report definitions for any report in the list by choosing Display Details ().
    • You can create a report definition that contains the displayed MTE classes directly in the Detail Data for Monitoring Attributes screen of the Alert Monitor (see Display Detail Data and Tailor Display). To do this, choose Central Perf. History → Assign Report Definition.
  2. In all cases, the Display Report Definition screen appears. On this screen, you can both display and change existing report definitions and create new definitions.
  3. To create a new report definition, choose Create Report Definition(). To edit an existing report definition, enter the corresponding definition in the Report Name input field and choose Display «Change (). In both cases, the screen has the following structure:

  1. In the input fields, enter the name, the description and the output format of the report definition.
  2. A report definition consists of one or more groups. A group, in turn, consists of one or more selection criteria for MTEs or MTE classes. You can create selection criteria of this type in the Add Objects group box; you can use the following sources as the basis for a criterion of this type:
    Tab Page Description

    Select from database

    You can select MTEs for which entries exist in the CPH (see Displaying Contents of the Central Performance History).

    Select from Assignment

    You can select MTE classes to which a collection and reorganization schema is assigned; that is, that are (at least in the future) collected in the CPH.

    Direct input

    You can select any groups of MTEs by specifying the class name or by specifying monitoring attribute, monitoring object, context, or system (you can use the wildcard character (*) in each case).

    We recommend that you use one CPH in your system landscape. However, it is also possible to have local system histories. If this is the case, choose Remote Performance History as Data Source to create reports from a central location.

  3. Define the output of the associated data for a group in the report:
    Input Field Description

    Group Name

    Specifies the title of the corresponding data in the respective line or column (see Displaying Central Performance History Reports); you can also enter names of variables (see Variables in Group Names)

    Group Operation

    Specifies whether multiple CPH values should be combined for a data point of the report, and which calculation rule should be used to do so

    Tip

    The CPH contains the dialog response times of the individual application servers. However, the average value of the servers should be displayed in the report.

    You can use the following group operations that specify how the performance values for a time point are to be combined:

    • Single Values: The values are not combined, but rather displayed individually
    • Weighted Average Value: An average value is calculated from the values. The individual values are weighted using the corresponding number of measurements
    • Simple Average Value: An average value is calculated from the values without consideration of the number of measurement points
    • Total: The individual measured values are totaled
    • Minimum: The minimum number of measured values is displayed
    • Maximum: The maximum number of measured values is displayed

    Output Values

    Specifies whether the total or the average value of the measured values or the number of measurement points should be displayed in the report (for a short description of the structure of the CPH, see Displaying the Contents of the Central Performance History)

  4. To specify additional group properties, you must first activate the relevant functions. To do this, choose Edit → Advanced Settings On/Off:
    Input Field Description

    Allow group operation between diff. MTE classes

    Select this indicator if you specify different MTE classes within a group and want to combine the different entries with a Group Operation.

    Time zone

    Specify the time zone if the performance values for the report are to be converted to another time zone.

    Day Schema

    Specify a day schema to avoid including certain hours of the day in the calculation of the values.

    Calendar Schema

    Specify a calendar schema to avoid including certain days in the calculation of the values.

  5. Once you have made the group settings, include the group in the report definition by choosing Add () in the Add Objects group box.
    Note

    If you want to edit a group of the report definition again, select a line of the relevant group and choose the Copy Group pushbutton ().

  6. To create additional groups, first delete the entries in the table in the Add Objects group box. To do this, choose Delete Selected Lines ().
  7. To check the report definition, choose Check Report Definition (). The system checks whether the MTE classes exist in the CPH in the requested resolution.
    Note

    If you have just assigned the MTE classes to a collection and reorganization schema, there cannot yet be any performance values for these classes in the CPH. In this case, a corresponding message is harmless.

  8. Save the report definition.