4.47 Report_PrinterHealth

Use this Knowledge Script to generate a report about printer health. Printer health is determined by whether or not the printer is paused, and the queue length for printer jobs. Using this report, you can aggregate data by minute, hour, or day, and calculate statistics for each period, for example, the average value per hour.

This report uses data collected by the PrinterHealth script.

4.47.1 Resource Object

Report agent

4.47.2 Default Schedule

The default schedule for this script is Run once.

4.47.3 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

Data source

Select computer(s)

Select the computers whose data you want to include in your report.

Select the style

Select the style for the first page of your report:

  • By computer provides links to pages showing the data collected from individual computers (each page shows all the datastreams collected from a single computer)

  • 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 computer and datastream provides links to pages showing a single datastream collected from a computer

  • All datastreams on one page provides all the datastreams on a single page

The default is By computer.

Select time range

Select a Specific or Sliding date/time range from which the report should pull data. The default is Sliding.

Select peak weekday(s)

Select the days of the week to include in your report. The default is every day of the week.

Aggregation by

Select the time period by which the data in your report is presented. Select Minute, Hour, or Day. The default is Hour.

Aggregation interval

Specify the intervals to use to aggregate the data in your report. You can specify 1-5, 7, 8, 10, 12, 14, 15, 24, 28, 30, 60, or 90. The default is 1.

Statistics to show per period

Select a statistical method by which to display data in your report:

  • Average. The average value of data points for the aggregation interval (for example, the average value for 1 Hour).

  • Minimum. The minimum value of data points for the aggregation interval.

  • Maximum. The maximum value of data points for the aggregation interval.

  • Count. The number of data points for the aggregation interval.

  • Sum. The total value of data points for the aggregation interval.

  • 3Sigma. The average + (3 * standard deviation) and average - (3 * standard deviation).

  • Std. The standard deviation. The measure of how widely values are dispersed from the mean.

  • Box. Lower fence, 25% point, median, 75% point, and upper fence for the aggregation interval.

  • Open. The first value for the aggregation interval.

  • Close. The last value for the aggregation interval.

The default is Average.

Report settings

Include parameter help card?

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

Include table/chart/both?

Specify whether to include a table or chart, or both, of datastream values in the report. The default is Table.

Select chart style

Select the graphic properties for the charts in your report. The default chart style is Bar.

Select output folder

Select the parameters for your report’s output folder. The default folder prefix is NT_PrinterHealth.

Add job ID to output folder name?

Set to yes to add the job ID to the report’s output folder name. By default, the job ID is not included.

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

Select properties

Provide a name for the report and set any other report parameters. The default title is NT Printer Health.

Add time stamp to title?

Set to yes to add a time stamp to the title of your report, making each title unique. The time stamp shows the date and time the report was generated. The default is no.

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

Event notification

Event for report success?

Set to yes to raise an event if the report is successfully generated. The default is yes.

Event severity level for report success

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a report is generated successfully. The default is 35 (magenta event indicator).

Event severity level for report with no data

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a generated report contains no data. The default is 25 (blue event indicator).

Event severity level for report failure

Set the event severity level, from 1 to 40, to indicate the importance of an event in which report generation fails. The default is 5 (red event indicator).