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.
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:
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.
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. |
Run the WebPagePerf script on the agent or agents as needed.
SharePoint Server: Web Applications
The default interval for this script is every 24 hours.
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. |