Basic events
Home > Select Project > Sitemap > Alert > Event Configuration New
The following explains how to add, modify, and share default event templates, depending on the platform to be monitored. In Event Configuration New
, select the Default tab.
It can be used by only the members with the Alert settings role. For more information about the member roles, see the following.
Basic event templates
Basic event templates are provided based on the product of the created project. You can activate a desired event by selecting Activation on the utmost left of the event list.
The provided event templates are as follows. The default value set in Indicator can be changed to a desired one.
-
Active Transaction
Category:
app_counter
If the number of active transactions (
active_tx_count
) exceeds 100, a warning (Warning) level notification is sent. -
Agent Alive Check
Category:
agent_status_summary
It sends a warning (Warning) level notification when data collection from the agent fails (
isActive
==false
).NoteThis template event can occur even if the network is disconnected.
-
Apdex 100 by kind
Category:
app_counter
If the application performance metric percentage (
apdex100
) by agent type is less than 95%, a warning (Warning) level notification is sent, and if it is less than 90%, a critical (Critical) level notification is sent. -
Apdex 100 by project
Category:
app_counter
If the application performance metric percentage (
apdex100
) for all agents in the project is less than 95%, a warning (Warning) level notification is sent, and if it is less than 90%, a critical (Critical) level notification is sent. -
Server CPU
Category:
app_host_resource
If the host's CPU utilization (
cpu
) exceeds 70%, a warning (Warning) level notification is sent. If it exceeds 90%, a critical (Critical) level notification is sent. -
Server Memory
Category:
app_host_resource
If the host's memory utilization (
mem
) exceeds 70%, a warning (Warning) level notification is sent. If it exceeds 90%, a critical (Critical) level notification is sent. -
Transaction Error Count
Category:
app_counter
If the number of transaction errors (
tx_error
) exceeds 10, a warning (Warning) level notification is sent. -
Transaction Response Time
Category:
app_counter
If the average response time (
resp_time
) for transactions continues to exceed 2,000 ms (2 seconds) for 10 consecutive times, a warning (Warning) level notification is sent.
For more information about the fields applied to the basic event templates, see the following.
Modifying event
You can modify the metric values applied in basic event templates for changing the warning notification occurrence criteria. In addition, you can change the notification occurrence criteria through various option settings. Select on the event to modify. The event editing screen appears. Modify the following items and then select Save.
Define event condition
You can set the criteria for event occurrence conditions.
-
Simulation: If you set event conditions and then select the button, the result of the set event can be predicted.
NoteFor more information on how to use the time selector, see the following.
-
Indicatorsettings: You can set the thresholds for the Warning or Critical notifications. Set an operator and then enter thresholds.
-
Operators:
>
(greater than),>=
(greater than or equal to),<
(less than),<=
(less than or equal to),==
(equal to) -
You can enter a positive number, negative number, or 0 as the threshold, but whether to enter a negative number may differ depending on the selected event template.
Note-
Depending on the provided event template, the notification levels that can be set may differ.
-
You can select one of Warning and Critical. However, you cannot disable both two items.
-
-
Consecutive: You can send notifications based on the count that meets the specified event conditions.
-
Not used: Notifications are sent each time any event occurs.
-
Consecutive: Notifications are sent each time any event occurs as many as you specified.
-
-
Pause: No notification is sent for the selected time after receiving the notification.
NoteIf the Resolved notification feature is active, notifications are not sent for the set period after sending a notification in RECOVERED state.
-
Resolved notification: When this option is enabled, the events appear as In progress in the Event History menu. When an event of Critical or Warning level is resolved, normal (RECOVERED) notifications are received. This function can be enabled or disabled by selecting the toggle button.
NoteFor more information about Event History, see the following.
The criteria for sending notifications differ depending on the following conditions:
Consecutive | Resolved notification | Action |
---|---|---|
Not used | On | Notifications are sent when the specified event conditions are met or resolved. |
Off | The notifications are sent whenever the specified conditions are met. | |
Consecutive N Occurrences | On | Notifications are sent when a condition is met at least N times or an event is resolved at least N times. |
Off | A notification is sent if the event conditions you set are met more than N times. After sending a notification, the count is reset and it is recounted. |
Select event target
You can set to send events that occur only on specific agents as notifications. Click the Agent (Instance) item and then select a desired agent.
-
Depending on the provided template, selectable targets may differ.
-
To check the event occurrence status for the selected targets, select RUN in Define event condition.
- If you do not select a target, notifications are sent to all agents included in the project. When an event occurs across all agents, it can generate numerous notifications.
Basic information and notification setting
You can write a title and message for the event received as a notification, and then select the recipients.
-
Activate events: You can enable the current events.
-
Event title: The event name of the basic template has been specified. You can edit the event name as you want.
-
Message: The message of the basic template has been specified. You can edit the message as you want. If the button is clicked, you can see the history of previously entered messages.
TipYou can write a message by entering the
${Tag}
or${Field}
variable in the message field.In Analysis > Metrics Search, select Category and then check the
${Tag}
or${Field}
variable that can be entered. For the Category name of the current event template, see the Category in the following -
Test alert: When receiving notifications as events, you can pre-check the specified event name and message. Testing is possible only when the required items (Indicatorsettings, Event title, and Message) are all entered.
Note-
During testing, substitutions for actual metric values or variables do not work.
-
Test notifications are sent only to users with the recipient tag set in the Event reception option. If you select Receive all, a test notification is sent to all users.
-
-
Event reception: You can select members to receive notifications from current events.
-
Receive all: You can send notifications to all the members in the project.
-
Receive selected tags: It sends notifications to project members and 3rd-party plugins with the selected tags. Click Add tag or to select a tag from the tag list.
NoteIn Alert > Notifications, you can set the tags in project members and 3rd-party plug-ins. For more information, see the following.
-
Adding an event
You can edit a basic event template to add your own notification.
-
On the upper right of the screen, select Add alert settings.
-
Select an event to add from the template list.
-
Set the options in the Select event target, Select event target, and Basic information and notification setting sections in turn.
-
After all settings are made, select Save on the upper right of the screen.
You can see newly added events in the event list.
-
To use it differently from basic event templates, edit the Event title item and then save it.
-
For more information about the basic event templates, see the following.
-
For more information about the event condition setting, see the following.
Deleting an event
You can delete the embedded or added events.
-
Select in the event to delete from the event list.
-
In the event modification screen, select Delete on the upper right of the screen.
-
If the deletion confirmation window appears, select Delete again.
The deleted event cannot be restored.
Setting the duplicated alerts
The Agent duplication alert option is an alert notification that occurs when multiple agents with the same ID are set among the agents being monitored, causing duplicate collection of metrics. See the related options among the agent settings to check that there are duplicate agent names. It is recommended to use this function when an alert occurs due to duplicate agents in deployment such as blue and green.
When multiple agents with the same name are running simultaneously, notifications are not received for the time selected in the Agent duplication alert option at the top of the event list.
Modifying to JSON format
You can modify event settings in JSON format.
-
On the upper right of the screen, select JSON .
-
When the editing window appears, modify the content in JSON format.
-
After all changes are made, select Save on the upper right of the screen.
If the modified content does not match the JSON format, an error message appears at the bottom of the screen and the changes cannot be saved. The displayed error message may differ depending on the format.
The JSON data structure is as follows:
{
"metaId": "infra001",
"displayName": "CPU",
"stateful": true,
"selectCondition": {},
"warningEnabled": true,
"criticalEnabled": true,
"receiver": [],
"warningThreshold": "cpu > 70",
"criticalThreshold": "cpu > 90",
"repeatCount": 1,
"silentPeriod": 60000,
"enabled": false,
"message": "CPU = ${cpu}"
},
The fields in JSON data are associated with the following options in event settings.
JSON field | Option |
---|---|
metaId | Unique identifier for the selected template |
displayName | Event title |
stateful | Resolved notification |
selectCondition | Select target |
warningEnabled | Whether the Warning event is active or not |
criticalEnabled | Whether the Critical event is active or not |
receiver | List of key values in the Event reception > Receive selected tags option |
warningThreshold | Threshold setting of the Warning event |
criticalThreshold | Threshold setting of the Critical event |
repeatCount | Consecutive N Occurrences |
silentPeriod | Pause |
enabled | Activate events |
message | Message |
Default Sharing events
You can save the Default event settings as a JSON file to share them with other users or import them from other users.
Export
-
On the upper right of the screen, select JSON .
-
If the JSON edition window appears, select Export.
-
Once the JSON file has been downloaded, forward it to others for sharing.
-
The format of the JSON file name is event-rules-
YYYY
-MM
-DD
.json. -
After searching for events, you can use the export feature to download only the searched list as a JSON file.
Import
-
On the upper right of the screen, select .
-
Using the Export function, select a JSON file to download.
-
If the JSON edition window appears, select Add to list or Overwrite.
It is recommended to use this function for the products of the same type. You can import event settings from the projects for other products, but it does not work.
Searching event
You can search the event by event name or metric in the event list. Enter a string in the search field and then select .
After searching for events, you can use the export feature to download only the searched list as a JSON file. For more information about the export feature, see the following.