Alarm
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 alert generation. To create an alert policy, follow these steps.
All Services > Management > ServiceWatch Click the menu. 1. Navigate to the Service Home page.
Service Home page, click the Alert > Alert Policy menu. 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.
In the Select Indicator popup, after selecting the indicator for the alert policy, click the Confirm button. 5. Metrics and Condition Settings area is displayed.
Category RequiredDetailed description Indicator classification Required Display the monitorable metrics 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: Enter the exact metric name to search
- Resource Name: Enter the exact resource name to search
- Resource ID: Enter the exact resource ID to search
- 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 by 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 name 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
- 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: Choose how to aggregate metric data
- Options: Average (default), Minimum, Maximum, Sum
- Aggregation period: Select the aggregation period unit for metric values
- Options: 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 itemsIn the Indicator and Condition Settings area, set the threshold values for alarm generation.
Category RequiredDetailed 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 from 60 seconds in multiples of 60, up to a maximum of 604,800 seconds
- 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 Select 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, within the evaluation period (seconds), the number of violations meets the condition among the evaluation counts, the alert state changes to Alert
- Evaluation Count: Number of evaluations that trigger an alarm
- 1 ~ 8,640 enterable
- Violation Count: Allowed number of violations until an alarm is triggered
- 1 ~ Evaluation Count enterable
- 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 missing data is handled during alert evaluation.
- Treat missing data as Missing (Missing)
- Treat missing data as Ignore to maintain the current alert state (Ignore)
- Treat missing data as Breaching (Breaching)
- Treat missing data as Not breaching (Not breaching)
Condition Settings required - Condition Operator: After calculating metric data over the evaluation period, select the condition operator to compare the resulting value with the threshold
- Threshold: After calculating metric data over the evaluation period, set the threshold value to compare with the result using the condition operator
- Input allowed from 0 to 2,147,483,647
- Condition: Explanation of the alert state change criteria 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 Alert Settings area, select and add the notification user or group that will receive alerts when an alarm occurs.
- When you click the Notification User button to select and add a user
- You can select and add users from the user list who will receive notifications.
- 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.
- When you click the Notification User button to select and add a user
- 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, refer to Create User.
- You can change the notification reception method (email or SMS) on the Notification Settings page after selecting the notification target as Service > Alarm. For detailed information about notification settings, refer to 알림 설정 확인하기.
- To add an external user as a notification recipient, first add an external recipient to the notification group, then select that notification group to add them. * External recipients can receive notifications via email.
* When you click the **Notification Group** button to select and add a notification group
* You can select and add groups from the notification group list to receive notifications.
* You can add up to 10 notification groups.
Add tag information in the Enter additional information area.
Category RequiredDetailed description tag Selection Add Tag - Up to 50 per resource can be added
- Add Tag button click after entering or selecting Key, Value values
Table. Additional information input itemsAfter reviewing the summary information, click the Create button. 9. A popup window notifying the creation of an alert policy opens.
Click the Confirm button. 10. The alert policy creation is complete.
View 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.
- Click the All Services > Management > ServiceWatch menu. 1. Navigate to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. 2. Navigate to the Alert Policy List page.
- In the Alert Policy menu, you can click the Alert Level button to filter and view only the list of alert policies that correspond to that alert level.
- On the Alert Policy List page, click the alert policy name to view detailed information. 3. Go to the Alert Policy Details page.
Category Detailed description Alert Policy Status Alarm policy status - Active: The alarm policy is in an active state
- Inactive: The alarm policy is in an inactive state
- You can change it by clicking the Activate or Deactivate button
Delete alarm policy Delete the relevant alert 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, absent, not arrived)
- Alert: when the metric meets the configured condition
- When the alarm status is Alert, display the alert level (>High, Middle, Low) as well
Metric Monitoring Chart Metric monitoring chart for the configured period - For detailed information about the monitoring chart, see Metric Monitoring
Information Classification Tab Information tabs for alarm policies - Details, notifications, alarm history, tags, operation history
- Click each tab to view the corresponding information
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) - Remaining special characters (
[\]^_`) - Other characters
Detailed Information
Alert Policy List page lets you 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/Time | Service creation date and time |
| Modifier | User who edited the service information |
| Modification timestamp | 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 | Metric name |
| Evaluation scope | Time range for alarm evaluation |
| unit | Unit of metric data |
| Evaluation count | Alarm 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) × 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 alarm policy target metric, resource ID, and resource name |
Notification
On the Alert Policy List page, you can view the notification recipients or notification groups of the selected alert policy.
| Category | Detailed description |
|---|---|
| Notification recipient list | If a notification recipient is set, display the user ID, creation date and time, last login, and status information
|
| Notification group list | When an alert group is configured, display the alert group name, user count, external user count, creation date and time, and 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
|
| Notification recipient settings | You can add or remove notification recipients or notification groups
|
- You can add up to 100 notification recipients and up to 10 notification groups.
- Only users with login history (users who have registered an email or mobile phone number) can be added as 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 사용자 생성하기.
- You can change the notification receipt method (E-mail or SMS) on the Notification Settings page after selecting the notification target Service > Alert. For detailed information about notification settings, refer to 알림 설정 확인하기.
- To add an external user as a notification recipient, first add the external recipient to the notification group, then select that notification group to add them. * External recipients can receive notifications via email.
Alert History
You can view the alert status change history of the alert policy selected on the Alert Policy List page.
| Category | Detailed description |
|---|---|
| Alert 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
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 | Key and value information of the tag |
| Tag modification | You can modify, delete, or add new tags to existing tag information
|
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
|
Modify Alert Policy
You can modify the target metrics and policy settings of the alert policy. To modify the alarm policy, follow the steps below.
- 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.
- On the Alert Policy List page, click the alert policy name to view detailed information. 3. Go to the Alert Policy Details page.
- Alarm Policy Details page’s Detailed Information tab, click the Edit button of Metric Information. 4. Edit Indicator Information 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, please refer to 경보 정책 생성하기.
- Click the Confirm button. 6. The alarm policy modification is complete.
Disable Alert Policy
You can disable the alert policy to stop sending notifications when the alert status changes. Even if the alert policy is disabled, alert evaluation continues, and as the alert status changes, alert history is also accumulated. However, the notification is not sent.
If you want to block receiving 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. Navigate to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. 2. Navigate to the Alert Policy List page.
- Alarm Policy Details page, click the Deactivate button. 3. Alert Policy Deactivation Notification A popup window opens.
- Click the Confirm button. 4. Check the status of the alert policy.
Enable alarm policy
You can enable the alert policy to resume sending notifications when the alert status changes. To enable 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.
- On the Alert Policy Details page, click the Activate button. 3. Alert Policy Activation Notification A popup window opens.
- Click the Confirm button. 4. Check the status of the alert policy.
Delete alarm policy
You can delete unused alarm policies. To delete an alarm 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.
- 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 notifying the deletion of the alarm policy opens.
- You can delete multiple alert policies simultaneously.
- You can also delete individually by clicking the Delete button at the right end 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.