Managing notifications
The Notifications tab allows you to configure notifications. You can configure conditions to continuously monitor logs by getting real-time events (along with a report) delivered to your email address or to send events to BMC ProactiveNet Performance Management.
Saved searches are the building blocks for creating notifications. You cannot configure a notification on the basis of a saved search that is shared by other users. But you can clone the saved search and then use the cloned copy to configure a notification. For more information, see Managing-saved-searches.
Before you begin
Create a saved search for which you want to create a notification.
Create an external configuration that you can use while creating a notification.
The following table provides additional information links for performing the preceding configurations:
Goal | Additional information |
|---|---|
Creating saved searches | |
Configuring external systems supported | |
Configuring an SMTP server |
Viewing and searching configured notifications
The Notifications tab allows you to manage the notifications that you configured. To access this tab, navigate to Administration > Notifications. From here, you can perform the following actions:
In this topic |
|---|
Related topics
If a problem occurs
The Notifications tab provides the following information:
Adding a notification
To add a notification, on the Administration > Notifications tab, click Add Notification, provide the following information, and click Save.
Configuring an alert or report
The following table lists the information that you must specify for configuring an alert or report:
Specifying details for logging events on external systems
After you select the notification destination for logging events on a BMC ProactiveNet Performance Management server or a particular BMC ProactiveNet Performance Management cell, provide the following details:
Specifying details for sending email notifications
The following table lists information that you must specify for sending email notifications:
Creating templates with custom notifications messages
While configuring an alert or report, you can choose to use the default template or create a new template with custom messages to send notifications.
Depending on the notification destination selected, the following kinds of templates can be created:
- Template for logging events on a supported external system
- Template for sending email notifications
To create a template, select a notification destination, click Create on the left panel, and provide the following details depending on whether you are creating a template for logging an event or sending an email.
Macros for creating custom messages
You can use macros in the Message field while creating templates. These macros denote objects that can be used to substitute common details specified while creating a notification. For example, saved search name, search string, count of results, and so on. The macros are substituted with appropriate values at run time when the notification is triggered.
To see an example of how macros can be used as a message for sending email notifications, see Example of the template message for sending emails.
The following table provides a list of default macros that can be used in the Message field while creating a template.
Macro Syntax | Macro description |
|---|---|
${NAME} | Name of the notification that was used for logging the event or sending the email notification. |
${QUERYNAME} | Name of the saved search used in the notification. |
${QUERYSTR} | Search string used corresponding to the saved search name. |
${COUNT} | Number of search results returned by the search query. |
${STARTTIME} | Indicates the start point for the search duration. |
${ENDTIME} | Indicates the end point for the search duration. |
${URL} | The URL for logging on to IT Data Analytics. |
${HOST} | Name of the target hosts from which the data is collected. Note: If the search query used in the notification is not specific to a particular host, then instead of the actual host name, the macro displays the value as "multiple hosts". |
${APPNAME} | Indicates the name of the application configured in BMC TrueSight Operations Management, that you specified at the time of configuring an alert or report. Note: To use this macro, you must have already integrated IT Data Analytics with BMC TrueSight Operations Management. For more information, see Integrating-with-BMC-TrueSight-Operations-Management. |
${APPID} | Indicates the ID associated with the application configured in BMC TrueSight Operations Management, that you specified at the time of configuring an alert or report. Note: To use this macro, you must have already integrated IT Data Analytics with BMC TrueSight Operations Management. For more information, see Integrating-with-BMC-TrueSight-Operations-Management. |
Example of the template message for sending emails
The following table provides an example of a template message and the actual message used for sending an email notification.
Template message | Actual message (email body) |
|---|---|
Saved search ${QUERYNAME} has result count: ${COUNT} for duration: [${STARTTIME}] to [${ENDTIME}] <div>Dear User,</div><br/><div> This email is for information only. Please do not respond to it.</div><br/><div> The configured notification, ${NAME} containing query, [${QUERYSTR}], with name ${QUERYNAME}, has been triggered. </div><br/><div> Result Count: ${COUNT}, Launch URL: ${URL}</div><br/><div> You can login and change the notification. Click <b> Administration > Notifications</b> to navigate to the notifications page.</div> | Saved search ITDA_Log_Monitoring has result count: 3567 for duration: 01/30/2015 11:30:30 GMT to 02/06/2015 11:30:30 GMT Dear User, This email is for information only. Please do not respond to it. The configured notification ITDA_Log_Monitoring_Notification, containing query, COLLECTOR_NAME="ITDA_logs", with name ITDA_Log_Monitoring, has been triggered. Result Count: 3567, Launch URL: Show in BMC TrueSight IT Data Analytics You can login and change the notification. Click Administration > Notifications to navigate to the notifications page. |