Assembly: Microsoft.EnterpriseManagement.OperationsManager (in microsoft.enterprisemanagement.operationsmanager.dll)
Usage
| Visual Basic |
|---|
Dim instance As ConnectorFrameworkProxy Dim connectorId As Guid Dim batchSize As Integer Dim failures As ConnectorTieredOperationFailure() Dim returnValue As ConnectorMonitoringAlert() returnValue = instance.GetMonitoringAlertsWithBatchSizeForTiers(connectorId, batchSize, failures) |
Syntax
| Visual Basic |
|---|
Public Function GetMonitoringAlertsWithBatchSizeForTiers ( _ connectorId As Guid, _ batchSize As Integer, _ <OutAttribute> ByRef failures As ConnectorTieredOperationFailure() _ ) As ConnectorMonitoringAlert() |
| C# |
|---|
public ConnectorMonitoringAlert[] GetMonitoringAlertsWithBatchSizeForTiers ( Guid connectorId, int batchSize, out ConnectorTieredOperationFailure[] failures ) |
| C++ |
|---|
public: array<ConnectorMonitoringAlert^>^ GetMonitoringAlertsWithBatchSizeForTiers ( Guid connectorId, int batchSize, [OutAttribute] array<ConnectorTieredOperationFailure^>^% failures ) |
| J# |
|---|
public ConnectorMonitoringAlert[] GetMonitoringAlertsWithBatchSizeForTiers ( Guid connectorId, int batchSize, /** @attribute OutAttribute() */ /** @ref */ ConnectorTieredOperationFailure[] failures ) |
| JScript |
|---|
|
|
Parameters
- connectorId
-
The globally unique identifier (GUID) for the monitoring connector to get alerts for.
- batchSize
-
The approximate maximum batch size to return.
- failures
-
The array of failures that may have occurred for various tiers.
Return Value
An array of ConnectorMonitoringAlert objects, limited by the batchSize parameter, that contain the alerts for the specified monitoring connector.Remarks
The batchSize limitation allows you to perform the get monitoring alerts operation in small batches, thereby avoiding a timeout failure. The batchSize is the total across all tiers, not per tier.
It is good practice to limit the number of alerts obtained by a single call. When you perform this GetMonitoringAlertsWithBatchSizeForTiers method you should check to see if the count property of the returned collection equals or exceeds the batchSize. If the count property of the returned collection equals or exceeds the batchSize then you should acknowledge the alerts received, and call this function again to get the next batch of alerts. Only when the returned collection is less than the batchSize can you be sure that you have received all of the alerts.
This method gets alerts only from the bookmark date to the current time less 30 seconds.
After you get the Monitoring alert, you need to acknowledge that alert with an AcknowledgeMonitoringAlertsForTiers. Failure to acknowledge an alert will result in subsequent calls to get new alerts returning the already received alerts.