Alert
In ServiceWatch, you can create and manage alert policies by setting threshold criteria for metrics to monitor, and generate alert notifications when the set conditions are met.
Creating an Alert Policy
You can create an alert policy for a metric to set the criteria for alert generation. Follow the steps below to create an alert policy.
Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
On the Service Home page, click the Alert > Alert Policy menu. You will be taken to the Alert Policy List page.
On the Alert Policy List page, click the Create Alert Policy button. You will be taken to the Create Alert Policy page.
In the Enter Basic Information area, enter the name and description of the alert policy, then click the Select Metric button. The Select Metric popup window opens.
In the Select Metric popup window, select the metric for which you want to create an alert policy, then click the Confirm button. The Metric and Condition Settings area is displayed.
Category RequiredDescription Metric Category Required Filter and display the list of metrics available for monitoring in ServiceWatch by All or Key Metrics Metric List Area Required List of metrics available for monitoring in ServiceWatch - Click the + button in front of namespace, dimension to view the lower-level list
- When you select a metric to monitor, it is displayed as a chart in the Selected Metric area
- If the metric is linked to a namespace, Service Dashboard is displayed
- Clicking Service Dashboard takes you to the detail page of that dashboard
Search Filter Area - Set the search item to filter, then click the Apply Filter button to filter the metric list - Namespace-Dimension Name: Search based on the lower-level dimension name 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 upper category and the entered keyword
- Search for each item excluding metric name, resource name, resource ID, tag-Key
- Tag Key: Search with the selected tag Key
Selected Metric Area - Monitoring chart for the metric selected in the metric list area - Data graph of data collected during the period applied to the chart
- Place the mouse cursor on the graph to display the time, data value, and metric data information of that point in a popup
- Drag the mouse to zoom in on a specific area of the graph
- Click the label name displayed in the legend to display detailed information about that legend in a popup
- In the chart display area, you can check and modify the labels, statistics, and aggregation period by legend
- Legend: Color by legend
- Click the legend color to change to another color
- Period: Period applied to the chart
- Metric: Displays the namespace, resource name, and metric name of the selected metric
- Statistics: Select the method for aggregating metric data
- Can select from Average (default), Minimum, Maximum, Sum
- Aggregation Period: Select the aggregation period unit of the metric value
- Can select from 1 minute, 5 minutes (default), 15 minutes, 30 minutes, 1 hour, 3 hours, 6 hours, 12 hours, 1 day
- Delete: Delete that legend
- Legend: Color by legend
Table. Select Metric Popup ItemsIn the Metric and Condition Settings area, set the threshold for alert generation.
Category RequiredDescription Namespace - Namespace of the selected metric Metric Name - Name of the selected metric Unit - Data unit of the selected metric Evaluation Range Required Time (seconds) range for alert evaluation - Can enter up to 604,800 seconds in multiples of 60
- If set smaller than the collection period or not in multiples of the collection period, alert evaluation may be applied abnormally
Statistics Required Select the method for calculating metric data during the evaluation range - Sum: Sum of all data point values collected during that period
- Average: Value of dividing the Sum during the specified period by the number of data points during that period
- Minimum: Lowest value observed during the specified period
- Maximum: Highest value observed during the specified period
Additional Configuration Optional Set the number of evaluations, number of violations, and method for handling missing data - When additional configuration is set to Enable, you can set the number of evaluations and number of violations used when evaluating alerts. If the violation count condition is met out of the number of evaluations during the evaluation range (seconds), the alert status changes to Alert
- Number of Evaluations: Number of evaluations for alert generation
- Can enter 1 ~ 8,640
- Number of Violations: Number of allowed violations until alert generation
- Can enter 1 ~ within Number of Evaluations
- Number of Evaluations: Number of evaluations for alert generation
- If the evaluation range is less than 1 hour (3,600 seconds), Number of Evaluations/Evaluation Range can be set up to maximum 1 day (86,400 seconds)
- If the evaluation range is 1 hour (3,600 seconds) or more, Number of Evaluations/Evaluation Range can be set up to maximum 7 days (604,800 seconds)
- When additional configuration is set to Enable, you can set how to handle missing data when evaluating alerts.
- Treat missing data as missing (Missing)
- Treat missing data as ignore to maintain current alert status (Ignore)
- Treat missing data as satisfying the condition (Breaching)
- Treat missing data as normal that does not satisfy the condition (Not breaching)
Condition Setting Required - Condition Operator: Select the condition operator to compare the calculated metric data value during the evaluation range with the threshold
- Threshold: Set the threshold to compare with the calculated metric data value during the evaluation range using the condition operator
- Can enter 0 ~ 2,147,483,647
- Condition: Description of the condition for alert status (Alert) change according to the set Condition Operator and Threshold
Alert Level Required Select the alert level according to the importance of the alert policy Resource ID - Resource ID of the metric monitoring target Resource Name - Resource name of the metric monitoring target Table. Metric and Condition Settings ItemsIn the Notification Settings area, select the users to receive notifications when an alert occurs.
- Only users with login history (users who have registered email, mobile phone number) can be added as notification recipients.
- You can add up to 100 notification recipients.Note
- If there is no user you want to add, you can create a user on the Create User page of the IAM service. For more information about creating a user, see Creating a User.
- The notification method (E-mail or SMS) can be changed by selecting the notification target as Service > Alert on the Notification Settings page. For more information about notification settings, see Checking Notification Settings.
In the Enter Additional Information area, add tag information.
After checking the summary information, click the Create button. A popup window announcing the creation of the alert policy opens.
Click the Confirm button. The alert policy creation is completed.
Viewing Alert Policy Details
You can view and manage detailed information about an alert policy. To view detailed information about an alert policy, follow the steps below.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. You will be taken to the Alert Policy List page.
- You can also click the Alert Level button displayed in the Alert Policy menu to view only the list of alert policies corresponding to that alert level.
- On the Alert Policy List page, click the alert policy name for which you want to view detailed information. You will be taken to the Alert Policy Details page.
Category Description Alert Policy Status Status of the alert policy - Active: Alert policy is activated
- Inactive: Alert policy is deactivated
- Can be changed by clicking the Activate or Deactivate button
Alert Policy Deletion Delete the corresponding alert policy Alert Status Current alert status - Normal: When the metric does not meet the set condition
- Insufficient data: When metric data cannot be checked (missing, non-existent, not arrived)
- Alert: When the metric meets the set condition
- When alert status is Alert, the alert level (>High, Middle, Low) is also displayed
Metric Monitoring Chart Metric monitoring chart during the set period - For details about the monitoring chart, see Monitoring Metrics
Information Category Tabs Information category tabs for the alert policy - Detailed Information, Notifications, Alert History, Tags, Operation History
- Click each tab to view the corresponding information
Table. Alert Details Items
When sorting alert policy names in the alert 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
You can view the basic information and metric information of the alert policy selected on the Alert Policy List page.
| Category | 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 |
| Creator | User who created the service |
| Creation Date | Date and time when the service was created |
| Modifier | User who modified the service information |
| Modification Date | Date and time when the service information was modified |
| Alert Policy Name | Name of the alert policy |
| Namespace | Namespace of the metric |
| Metric Name | Name of the metric |
| Evaluation Range | Time range for alert evaluation |
| Unit | Unit of metric data |
| Number of Evaluations | Number of alert policy evaluations |
| Number of Violations | Number of alert policy violations |
| Statistics | Method for calculating metric data during the evaluation range |
| Evaluation Interval | Evaluation interval: Evaluation range (unit) x Number of evaluations |
| Condition | Condition for alert status (Alert) change according to the set Condition Operator and Threshold |
| Alert Level | Alert level when alert occurs |
| Target Metric Information Area | Description, resource ID, and resource name of the target metric of the alert policy |
Notifications
You can view the notification recipients of the alert policy selected on the Alert Policy List page.
| Category | Description |
|---|---|
| Notification Recipient List | User ID, creation date, last login, status information
|
| Delete | Delete all selected users from the notification recipient list
|
| More | Change the notification status (activated/deactivated) for the selected user in the notification recipient list
|
| Add Notification Recipient | Can add a new notification recipient
|
- Only users with login history (users who have registered email, mobile phone number) can be added as notification recipients.
- You can add up to 100 notification recipients.
- If there is no user you want to add, you can create a user on the Create User page of the IAM service. For more information about creating a user, see Creating a User.
- The notification method (E-mail or SMS) can be changed by selecting the notification target as Service > Alert on the Notification Settings page. For more information about notification settings, see Checking Notification Settings.
Alert History
You can view the history of alert status changes for the alert policy selected on the Alert Policy List page.
| Category | Description |
|---|---|
| Alert History List | Alert status change date and time, change status category information, alert description
|
| View Details | Can view detailed information of alert history and source code in JSON format
|
Tags
You can view the tag information of the alert policy selected on the Alert Policy List page, and add, change, or delete it.
| Category | Description |
|---|---|
| Tag List | Key, Value information of tags |
| Modify Tags | Can modify or delete existing tag information or add new tags
|
Operation History
You can view the operation history of the alert policy selected on the Alert Policy List page.
| Category | Description |
|---|---|
| Operation History List | Resource change history
|
Modifying an Alert Policy
You can modify the target metric and policy settings of an alert policy. To modify an alert policy, follow the steps below.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. You will be taken to the Alert Policy List page.
- On the Alert Policy List page, click the alert policy name for which you want to view detailed information. You will be taken to the Alert Policy Details page.
- On the Alert Policy Details page, click the Modify button in the Metric Information of the Detailed Information tab. The Modify Metric Information popup window opens.
- After modifying the metric information and policy settings, click the Confirm button. A popup window announcing the metric modification opens.
- For details about metric modification items, see Creating an Alert Policy.
- Click the Confirm button. The alert policy modification is completed.
Deleting an Alert Policy
You can delete unused alert policies. To delete an alert policy, follow the steps below.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Alert > Alert Policy menu. You will be taken 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. A popup window announcing the deletion of the alert policy opens.
- You can delete multiple alert policies at the same time.
- You can also individually delete by clicking the Delete button at the right end of each alert policy or by clicking the Delete Alert Policy button on the corresponding Alert Policy Details page.
- Click the Confirm button. The alert policy is deleted.