3.28 WebPagePerf

Use this Knowledge Script to monitor the performance of Web pages in a SharePoint Web application.

Performance is measured in terms of the bandwidth you specify. Bandwidth is the number of bytes transferred to and from Web applications. This script raises an event if a log entry exceeds the bandwidth threshold you set. The script will only raise events if the number of bytes transferred to and from Web applications is greater than 0 MB.

For SharePoint 2007, this script retrieves performance information by scanning the SharePoint log entries. The script uses the current date’s log file to retrieve the performance information. The script uses the Usage Analysis logs found in the following folder:

\Program Files\Common Files\Microsoft Shared\Web server extensions\12\LOGS\guid of Webpp\

For SharePoint 2010 or later , this script retrieves performance information by reading from the logging database.

3.28.1 Configuring Security Manager for WebPagePerf

Before you can run the WebPagePerf Knowledge Script, configure AppManager Security Manager for the specific agents from the SharePoint server farm you want to monitor.

To configure Security Manager for the WebPagePerf Knowledge Script:

  1. Select the agent or agents you want this script to monitor. These agents should contain information for all sites and Web applications from the farm.

  2. On the Custom tab in AppManager Security Manager, add a custom entry and complete the following fields for the agent or agents you selected in the previous step:

    Field

    Description

    Label

    SharePoint_SQL

    Sub-label

    ServerName\SharePointInstanceName

    Because separate SQL instances are created, and the WebPagePerf Knowledge Script gets data from the logging database in a SharePoint instance, you need to provide the database server name, along with the instance name related to SharePoint in SQL.

    Value 1

    Specify the user name for the SQL Server account.

    Value 2

    Specify the password for the SQL Server account.

    Value 3

    Leave this field blank.

    Extended application support

    Required field. Encrypts the user name and password in Security Manager.

  3. Run the WebPagePerf script on the agent or agents as needed.

3.28.2 Resource Objects

SharePoint Server: Web Applications

3.28.3 Default Schedule

The default interval for this script is every 24 hours.

3.28.4 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

General Settings

Job failure event notification

Event severity when job fails

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the job fails to monitor the performance of Web pages in a SharePoint Web application. The default is 5.

Monitor Web Page Performance

Event Notification

Raise event if log entries exceed the bandwidth threshold?

Select Yes to raise an event in which log entries exceed the bandwidth threshold you specify. The default is Yes.

Event severity when bandwidth exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the bandwidth exceeds the threshold. The default is 8.

Threshold -- maximum bandwidth

Specify the maximum bandwidth allowed before an event is raised. This script supports a maximum bandwidth of 4096 MB. The default is 1 MB.

Raise event if Web page performance information collected successfully?

Select Yes to raise an event in which details of Web page performance are collected successfully. The default is unselected.

Event severity when Web page performance information collected successfully

Set the event severity level, from 1 to 40, to indicate the importance of an event in which Web page performance data is collected successfully. The default is 25.

Raise event if no data is available?

Select Yes to raise an event if no bandwidth information exists for the Web page on the SharePoint server. The default is unselected.

Event severity when no data is available

Set the event severity level, from 1 to 40, to indicate the importance of an event in which no bandwidth information exists. The default is 11.

Data Collection

Collect data for matching log entries?

Select Yes to collect data for charts and reports. The default is unselected.