You can configure alert queries in vRealize Log Insight to send notification events to vRealize Operations Manager when specific vRealize Log Insight queries return results above a given threshold.
Notification events that vRealize Log Insight generates are associated with resources in vRealize Operations Manager. You can read more about resources in the vRealize Operations Manager Getting Started Guide (Custom UI).
- Verify that you are logged in to the vRealize Log Insight web user interface. The URL format is https://log_insight-host, where log_insight-host is the IP address or host name of the vRealize Log Insight virtual appliance.
- Verify that an administrator has configured the connection between vRealize Log Insight and vRealize Operations Manager to enable alert integration. See Configure Log Insight to Send Notification Events to vRealize Operations Manager.
- On the Interactive Analytics tab, run the query for which you want notifications to be sent .
- From the Create or manage alerts menu on the right of the Search button, click and select Create Alert from Query.
- In the Add Alert dialog box, type a name for the alert, and provide a short and meaningful description of the event that triggers the alert.
The alert name and description are included in the notification event that vRealize Log Insight sends.
- Deselect the Email option. To receive the email notifications, provide at least one email address.
Use commas to separate multiple addresses.
- Select Send to vRealize Operations Manager.
- Provide a fallback object.
When integrated with vRealize Operations Manager 6.0 and above, alerts are sent as notifications to the virtual machines, ESX hosts, or vCenter Server objects that caused the alert. Alerts raised by other entities are sent to the selected fallback object.
- Click Select.
- In the Select Fallback Object dialog box, enter a resource name or browse for an object in the list.
Option Description Active Objects Select to view only resources that are powered on. All Objects Select to view all resources, regardless of their power state.
- (Optional) From the Criticality drop-down menu, select the criticality level for the notification events that appear in the vRealize Operations Manager Custom user interface.
- (Optional) To cancel the alert in vRealize Operations Manager if it is not triggered within a certain period, select the Auto Cancel check box and enter the cancellation period.
- Set the alert threshold.
Alert Type Selection Any Match
Select the On any match option.
Queries run every 5 minutes.
Based on the event type
Select the When a new event type is seen for the first time in the last <time period> option and select a time from the drop-down menu.
Queries run every 5 minutes.
Based on number of events within a period of time
Select the third option and use the drop-down menus to set the parameters.
Queries run based on your selection in the drop-down menu.
Based on chart values
Select the fourth option and use the drop-down menus to configure the parameters.Note: This alert type is available only if you select to group events according to at least one field. You cannot create this alert type for charts that visualize only time series.
Queries run based on your selection in the second drop-down menu.The orange line in the preview chart shows the current threshold.
- Click Save.
When the alert query returns results that match the alert criteria, a notification event is sent to vRealize Operations Manager. Alert queries run on a predefined schedule and are triggered only once for a given threshold time range.
The locations of the notification events depend on the vRealize Operations Manager user interface that you use. See Log Insight Notification Events in vRealize Operations Manager.
Example: Configure a Notification Alert to vRealize Operations Manager
Assume that in vRealize Operations Manager, you have a virtual machine resource named vm-abc.
You have configured vRealize Log Insight to pull events from the vCenter Server system where the virtual machine vm-abc runs.
You want to receive a notification in vRealize Operations Manager each time the vm-abc virtual machine is powered off.
Here is how to configure vRealize Log Insight to send these notification events to vRealize Operations Manager.
- In the search text box, type Power Off virtual machine.
- Click Add a Filter, select vc_vm_name and type vm-abc.
- Click Search.
If the vm-abc virtual machine has been powered off during the selected time range, the search returns all instances that occurred.
- From the drop-down menu on the right of the Search button, select Add Alert.
- In the Add Alert dialog box, enter a name and description for the alert, deselect the Email option, and select Send to vRealize Operations Manager.
- Click Select, type vm-abc, and click Search to find the vm-abc resource in the list.
- Click the vm-abc resource in the list to add it.
- (Optional) Modify the criticality level that is displayed in the vRealize Operations Manager Custom user interface.
- (Optional) Select an auto-cancel setting and cancellation period.
- Under Raise an alert, select on any match.
- Click Save.
vRealize Log Insight polls the vCenter Server system at five-minute intervals. If the query returns a new power off virtual machine task from the virtual machine vm-abc, vRealize Log Insight sends a notification event that is associated with the vm-abc resource in vRealize Operations Manager.
What to do next
You can enable, disable, or delete your saved alerts.