14.44 WatchList

Use this Knowledge Script to generate a report detailing the top or bottom N computers, by number or percent, that generated the selected datastreams.

14.44.1 Resource Object

Report agent

14.44.2 Default Schedule

The default schedule is Run once.

14.44.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How To Set It

Data source

Top or bottom

Select either Top or Bottom as a filtering criterion.

Number N

Set the value of the Top or bottom parameter (for example, top 5 or bottom 5).

Number or percent

Select whether the report defines the top or bottom N by number or percent (for example, top 5 or bottom 5 percent).

Top or bottom by

Select which type of datastream values take precedence in the report:

  • Average

  • Minimum

  • Maximum

For example, if you are reporting on the Top 5 computers and you set this parameter to Average, then the top 5 computers with the highest average values for the selected datastreams are included in the report.

In this case, the maximum and minimum values are also included, but the average values are listed first in the table, and the average values are by default given a unique graphic style in the chart.

The report always includes all three values for the sake of comparison, but the type of value you select for this parameter is given precedence in the report.

Select data wizard

Select the data for your report by Knowledge Script or by datastream.

Select the style

Select the style for the first page of the report:

  • By datastream provides links to pages showing a side-by-side comparison of values for the same datastream collected from different computers (each page shows, for example, the value of the NT_CpuResource-All Threads(#) datastream from each computer)

  • By Knowledge Script provides links to pages showing all datastreams collected by a Knowledge Script (each page shows all datastreams collected from all computers on which the script has run)

Select time range

Filter the data for your report by a specific or sliding time range. The default is Sliding.

Select peak weekday(s)

Filter the data for your report by the days of the week.

Report settings

Include parameter help card?

Set to y to include a table in the report that lists parameter settings for the report script. The default is y.

Include table/chart/both?

Select the type of datastream values you want to include in the report:

  • Table (table only)

  • Chart (chart only)

  • Both (table and chart)

Select chart style

Define the graphic properties of the charts in your report.

Top/bottom N series style

Select the graphical style of the data series representing the top or bottom N datastreams.

Select output folder

Set parameters for the output folder.

Add job ID to output folder name?

Set to y to append the job ID to the name of the output folder.

A job ID helps you correlate a specific instance of a Report Script with the corresponding report.

The default is n.

Select properties

Set miscellaneous report properties as desired.

Add time stamp to title?

Set to y to append a time stamp to the title of the report, making each title unique. The time stamp contains the date and time the report was generated.

A time stamp allows you to run consecutive iterations of the same report without overwriting previous output.

The default is n.

Event notification

Event for report success?

Set to y to raise an event when the report is successfully generated. The default is y.

Severity level for report success

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 35 (magenta level indicator).

Severity level for report with no data

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 25 (blue level indicator).

Severity level for report failure.

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default is 5 (red level indicator).