Alert
In ServiceWatch, you can set threshold criteria for the metrics to be monitored, and create and manage alert policies that generate alert notifications when the specified conditions are met.
Create Alert Policy
You can create an alert policy for a metric and set the criteria for triggering alerts. To create an alert policy, follow these steps.
Click the All Services > Management > ServiceWatch menu. 1. Navigate to the Service Home page.
Click the Alert > Alert Policy menu on the Service Home page. 2. Navigate to the Alert Policy List page.
on the Alert Policy List page, click the Create Alert Policy button. 3. Navigate to the Create Alert Policy page.
In the Basic Information Input area, after entering the name and description of the alert policy, click the Select Metric button. 4. Select Indicator popup window opens.
Metric Selection In the popup window, after selecting the metric to create an alert policy, click the Confirm button. 5. Indicator and Condition Settings area is displayed.
Category RequiredDetailed description Indicator classification Required Display the metrics that can be monitored in ServiceWatch, filtered as All or Key Metrics, in the metric list Indicator List Area Required List of metrics that can be monitored in ServiceWatch - Click the + button in front of the namespace and dimension to view the sub-level list
- When you select a metric to monitor, it is displayed as a chart in the Selected Metric area
- If the metric is associated with a namespace, the Service Dashboard is shown
- Clicking the Service Dashboard navigates to the detailed page of that dashboard
Search filter area - After setting the search items to filter, click the Apply Filter button to filter the metric list - Namespace-Dimension Name: Search based on the sub-dimension names of the selected namespace
- Metric Name: Search by entering the exact metric name
- Resource Name: Search by entering the exact resource name
- Resource ID: Search by entering the exact resource ID
- Keyword: Search based on the selected top-level category and the entered keyword
- Proceed with item-specific searches excluding metric name, resource name, resource ID, and tag-key
- Tag Key: Search using the selected tag key
Selected indicator area - Monitoring chart for the selected metric in the metric list area - Data graph collected during the period applied to the chart
- When the mouse cursor is placed on the graph, a popup displays the time, data value, and metric data information for that point
- You can drag the mouse to zoom in on a specific area of the graph
- Clicking the label displayed in the legend shows detailed information for that legend in a popup
- In the table area within the chart, you can view and edit legend labels, statistics, and aggregation periods
- Legend: color per legend
- You can click a legend color to change it to another color
- Period: period applied to the chart
- Metric: displays the selected metric’s namespace, resource name, and metric name
- Statistics: select the method for aggregating metric data
- You can choose among Average (default), Minimum, Maximum, Sum
- Aggregation period: select the aggregation period unit for the metric value
- You can select among 1 minute, 5 minutes (default), 15 minutes, 30 minutes, 1 hour, 3 hours, 6 hours, 12 hours, 1 day
- Delete: delete the legend
- Legend: color per legend
Table. Indicator selection popup itemsIndicator and Condition Settings area, set the threshold values for triggering alerts.
Category Required statusDetailed description namespace - Namespace of the selected metric Indicator name - Name of the selected metric unit - Data unit of the selected metric Evaluation scope Required Time (seconds) range for alarm evaluation - Input allowed up to a maximum of 604,800 seconds in multiples of 60, starting from 60
- If set to a value smaller than the collection interval or not a multiple of the collection interval, alarm evaluation may be applied abnormally
Statistics Required Select the method for calculating metric data over the evaluation period - Sum: the total of all data point values collected during the period
- Average: the value obtained by dividing the Sum over the specified period by the number of data points during that period
- Minimum: the lowest value observed during the specified period
- Maximum: the highest value observed during the specified period
Additional configuration Selection Setting evaluation count, violation count, and missing data handling method - If the additional configuration is set to Use, you can set the evaluation count and violation count used when evaluating alerts. If the number of violations meets the condition within the evaluation count during the evaluation period (seconds), the alert state changes to Alert
- Evaluation Count: Number of evaluations that trigger an alarm
- 1 ~ 8,640 can be entered
- Violation Count: Allowed number of violations up to alarm generation
- 1 ~ Evaluation Count can be entered
- Evaluation Count: Number of evaluations that trigger an alarm
- If the evaluation period is less than 1 hour (3,600 seconds), evaluation count/evaluation period can be set up to a maximum of 1 day (86,400 seconds)
- If the evaluation period is 1 hour (3,600 seconds) or more, evaluation count/evaluation period can be set up to a maximum of 7 days (604,800 seconds)
- If the additional configuration is set to Use, you can specify how to handle missing data during alert evaluation.
- Treat missing data as missing (Missing)
- Treat missing data as ignored to maintain the current alert state (Ignore)
- Treat missing data as satisfying the condition (Breaching)
- Treat missing data as normal, not satisfying the condition (Not breaching)
Condition setting Required - Condition Operator: Select a condition operator to compare the calculated metric value with the threshold after computing metric data over the evaluation period
- Threshold: Set a threshold to compare the calculated metric value with the condition operator after computing metric data over the evaluation period
- Input allowed up to 0 ~ 2,147,483,647
- Condition: Description of the alert state (Alert) change condition based on the configured Condition Operator and Threshold
Alert level Required Select alert level based on the importance of the alert policy Resource ID - Metric monitoring target resource ID Resource name - Metric monitoring target resource name Table. Indicator and Condition Setting ItemsIn the Notification Settings area, select the users who will receive notifications when an alarm occurs.
- Only users with a login history (users who have registered an email or mobile phone number) can be added as notification recipients.
- You can add up to 100 notification recipients.
- If there is no user to add, you can create a user on the IAM service’s User Creation page. * For detailed information on user creation, see 사용자 생성하기.
- The notification receipt method (E‑mail or SMS) can be changed on the Notification Settings page after selecting Service > Alerts as the notification target. * For detailed information about notification settings, see 알림 설정 확인하기.
- Add tag information in the Additional Information Input area.
- After reviewing the summary information, click the Generate button. 9. A popup window notifying the creation of an alert policy opens.
- Click the Confirm button. 10. Alert policy creation is complete.
Check detailed alarm policy information
You can view and manage detailed information about alert policies. To view detailed information about the alert policy, follow these steps.
- All Services > Management > ServiceWatch Click the menu. 1. Navigate to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. 2. Go to the Alert Policy List page.
- Click the Alert Level button displayed in the Alert Policy menu to filter and view only the list of alert policies for that level.
- On the Alert Policy List page, click the alert policy name to view detailed information. 3. Navigate to the Alarm Policy Details page.
Category Detailed description Alert Policy Status Alert policy status - Active: The alert policy is active
- Inactive: The alert policy is inactive
- Activate or Deactivate button can be clicked to change
Delete alarm policy Delete the relevant alarm policy Alarm status Current alarm status - Normal: when the metric does not meet the configured condition
- Insulfficient data: when the metric data cannot be retrieved (missing, nonexistent, not arrived)
- Alert: when the metric meets the configured condition
- When the alarm status is Alert, display the alarm level (>High, Middle, Low) as well
Metric Monitoring Chart Metric monitoring chart for the configured period - For details on the monitoring chart, refer to 지표 모니터링하기
Information Classification Tab Information tabs for alarm policies - Details, alerts, alarm history, tags, operation history
- You can view the relevant information by clicking each tab
Table. Alarm detail items
When sorting alarm policy names in the alarm policy list, follow the sorting rules below.
- Whitespace and control characters
- Some special characters (
!"#$%&’()*+,-./) - Numbers (
0–9) - Some special characters (
;<=>?@) - English (
A–Z,a–z, case-insensitive) - other special characters (
[\]^_`) - Other characters
Detailed Information
On the Alert Policy List page, you can view the basic information and metric information of the selected alert policy.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource Name | Resource name
|
| Resource ID | Unique resource ID in the service |
| Constructor | User who created the service |
| Creation date and time | Service creation date and time |
| Modifier | User who edited the service information |
| Modification date and time | Date and time the service information was modified |
| Alert Policy Name | Name of the alert policy |
| Category | How to create alarm policies
|
| namespace | Metric namespace |
| Indicator name | Indicator Name |
| Evaluation scope | Time range for alert evaluation |
| unit | Unit of indicator data |
| Evaluation count | Alert policy evaluation count |
| Number of violations | Number of alarm policy violations |
| Statistics | Method for calculating metric data during the evaluation period |
| Evaluation interval | Evaluation interval: evaluation range (unit) x number of evaluations |
| Condition | Alert state (Alert) change condition based on the configured condition operator and threshold |
| Alert level | Alarm level when an alarm occurs |
| Target metric information area | Description of the alert policy target metric, resource ID, and resource name |
Notification
Alert Policy List page allows you to view the notification recipients of the selected alert policy.
| Category | Detailed description |
|---|---|
| Notification Recipients List | User ID, creation date/time, last login, status information
|
| Delete | Delete all selected users from the notification recipient list
|
| More | Change the notification status (enable/disable) for the selected user in the notification recipient list
|
| Add notification recipient | Ability to add new notification recipients
|
- Only users with a login history (users who have registered an email or mobile phone number) can be added as notification recipients.
- You can add up to 100 notification recipients.
- If there is no user to add, you can create a user on the IAM service’s User Creation page. * For detailed information on user creation, please refer to 사용자 생성하기.
- The notification reception method (E-mail or SMS) can be changed on the Notification Settings page after selecting the notification target as Service > Alert. * For detailed information about notification settings, refer to 알림 설정 확인하기.
Alert History
On the Alarm Policy List page, you can view the alarm status change history of the selected alarm policy.
| Category | Detailed description |
|---|---|
| Alarm History List | Alarm status change timestamp, change status classification information, alarm description
|
| View Details | You can view detailed alarm history information and source code in JSON format
|
Tag
On the Alert Policy List page, you can view the tag information of the selected alert policy and add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag key and value information |
| Edit tag | Modify or delete existing tag information, or add new tags
|
Job History
You can view the operation history of the selected alert policy on the Alert Policy List page.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Edit Alert Policy
You can modify the target metrics and policy settings of the alert policy. To modify the alert policy, follow these steps.
- All Services > Management > ServiceWatch Click the menu. 1. Navigate to the Service Home page.
- Service Home on the page, click the Alert > Alert Policy menu. 2. Navigate to the Alert Policy List page.
- On the Alert Policy List page, click the alert policy name to view its details. 3. Navigate to the Alert Policy Details page.
- Click the Edit button of Metric Information on the Detailed Information tab of the Alert Policy Details page. 4. 지표 정보 수정 The popup window opens.
- After modifying the indicator information and policy settings, click the Confirm button. 5. A popup window notifying the indicator modification opens.
- For detailed information on metric modification items, refer to 경보 정책 생성하기.
- Click the Confirm button. 6. The alert policy modification is complete.
Disable alert policy
You can disable the alarm policy to stop sending notifications when the alarm status changes. Even if the alert policy is disabled, alert evaluation continues, and alert history accumulates as the alert state changes. However, notifications are not sent.
If you want to block notifications for a specific period, you can disable the corresponding alert policy.
To disable the alert policy, follow these steps.
- Click the All Services > Management > ServiceWatch menu. 1. Go to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. 2. Navigate to the Alert Policy List page.
- Click the Deactivate button on the Alarm Policy Details page. 3. Alert Policy Deactivation Notification A popup window opens.
- Click the Confirm button. 4. Check the status of the alert policy.
Activate alert policy
You can enable the alert policy to resume sending notifications when the alert status changes. To enable the alert policy, follow these steps.
- Click the All Services > Management > ServiceWatch menu. 1. Go to the Service Home page.
- On the Service Home page, click the 경보 > 경보 정책 menu. 2. Navigate to the Alert Policy List page.
- On the Alert Policy Details page, click the Enable button. 3. Alert Policy Activation Notification A popup window opens.
- Click the Confirm button. 4. Check the status of the alert policy.
Delete Alert Policy
You can delete unused alarm policies. To delete an alert policy, follow these steps.
- All Services > Management > ServiceWatch Click the menu. 1. Go to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. 2. Go to the Alert Policy List page.
- On the Alert Policy List page, select the checkbox of the alert policy you want to delete, then click the Delete button. 3. A popup window appears to notify the deletion of the alarm policy.
- You can delete multiple alert policies simultaneously.
- You can also delete individually by clicking the Delete button at the far right of each alert policy, or by clicking the Delete Alert Policy button on the Alert Policy Details page.
- Click the Confirm button. 4. The alert policy will be deleted.