PerformanceCondition Property
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
The PerformanceCondition property specifies a Microsoft Windows Performance Monitor counter, a comparison operator and value, and enables raising a Microsoft® SQL Server™ 2000 Agent alert based on system activity.
Syntax
object
.PerformanceCondition [=value]
Parts
- object
Expression that evaluates to an object in the Applies To list
- value
String that specifies a Windows Performance Monitor object, counter, and instance as described in Remarks
Data Type
String
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetPerformanceCondition(SQLDMO_LPBSTR pRetVal)
HRESULT SetPerformanceCondition(SQLDMO_LPCSTR NewValue)
Note
SQL-DMO strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.
Remarks
When setting the PerformanceCondition property, value uses the syntax:
ObjectName
|
CounterName
|
Instance
|
ComparisonOp
|
CompValue
| Part | Description |
|---|---|
ObjectName |
Name of a monitored Microsoft SQL Server object |
CounterName |
Name of a counter exposed by the object |
Instance |
Name of an instance of the counter |
ComparisonOp |
One of the relational operators =, >, or < |
CompValue |
Numeric value compared |
For example, to create an alert raised when the average wait time for an extent lock rises above 1 second (1,000 milliseconds), set the PerformanceCondition property using the string:
SQLServer:Locks|Average Wait Time (ms)|Extent|>|1000
Many SQL Server Performance Monitor counters do not define instance parameters. When an instance parameter is not applicable, indicate that no instance is selected using an empty Instance part in the value string, as in:
SQLServer:Access Methods|Page Splits/sec||>|50
For more information about SQL Server objects exposing Performance Monitor counters, see Using SQL Server Objects.