This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Overview

Service Overview

ServiceWatch is a service that collects metrics, logs, and events of resources created on the Samsung Cloud Platform, monitors them, and provides various tools to offer observability of resource performance, operational status, and more.

Key Advantages

It provides the following key advantages.

  • Resource Monitoring: Collects and visualizes performance metrics (e.g., CPU Usage) of resources. It also creates a dashboard that visualizes multiple metrics in one place for a quick overview.
  • Alert Policy Configuration and Automatic Notifications: Users can define conditions and thresholds to create alert policies, and receive notifications when thresholds are exceeded, enabling rapid detection and response to resource status.
  • Log Analysis and Storage: Collects logs generated by resources for easy retrieval and searching. Collected logs are stored in log groups, with up to 5 GB of storage provided for free. Users can set log retention policies to define retention periods, and logs older than the retention period are automatically managed.
  • Cost Efficiency: ServiceWatch offers a flexible pay-as-you-go pricing model for cost-effective usage. A free tier is also provided, allowing users to try the service for free and scale to paid usage as needed.

Features Provided

The following features are provided.

  • Metric Monitoring
    • Metrics: ServiceWatch receives metric data from Samsung Cloud Platform services, collects and stores this data, and makes it available to users.
    • Dashboard: Visualizes metrics of a single region to provide an integrated view of resources. ServiceWatch distinguishes between automatically generated service dashboards and user-created custom dashboards.
    • Alert: Offers alert functionality that notifies when metrics change beyond user-defined thresholds.
  • Log Monitoring
    • ServiceWatch provides log management capabilities. Logs collected from Samsung Cloud Platform services are stored in log groups for management. Log retention policies can be set to control log retention periods. Users can also view and search log data via the console, and export log groups to Object Storage.
  • ServiceWatch Agent
    • With the ServiceWatch Agent, detailed metrics on processes, CPU, memory, disk usage, and network performance can be collected from Virtual Server, GPU Server, Bare Metal Server, etc. GPU performance metrics can also be collected. Additionally, the Agent can collect logs generated by resources. (Planned for December 2025)
  • Event Monitoring
    • ServiceWatch can create event rules from system events reflecting changes to resources created on Samsung Cloud Platform, allowing users to receive notifications when specific conditions are met.

Components

Metrics

Metrics refer to performance data of a system. By default, resources of services integrated with ServiceWatch provide basic monitoring based on free metrics. Additionally, services such as Virtual Server can enable detailed monitoring to provide paid metrics.

Metric data can be retained for up to 15 months (455 days). For detailed information about metrics, see Metrics.

Logs

Logs from resources such as Virtual Server, Kubernetes Engine, and other services on Samsung Cloud Platform can be collected, stored, and viewed.

For detailed information about logs, see Logs.

Events

Events represent changes in the environment from Samsung Cloud Platform services. The following are examples of events.

  • An event is generated when a Virtual Server’s status changes from Stopped to Running.
  • An event is generated when a new bucket is created in Object Storage.
  • An event is generated when an IAM user is removed from a user group.

For detailed information about events, see Events.

Dashboards

ServiceWatch provides pre-built service dashboards for each service automatically, and users can also create custom dashboards.

Notice
Pre-built dashboards for each service will be available from March 2026.

ServiceWatch Agent

The ServiceWatch Agent is a software component that collects metrics and logs from Virtual Server, GPU Server, and On-Premise servers, enabling more granular monitoring of infrastructure and applications beyond the basic monitoring provided by default.

Note

User-defined metric/log collection via the ServiceWatch Agent is currently available only for Samsung Cloud Platform For Enterprise. It will be available for other offerings in the future.

Limitations

CategoryDescription
Metric Retention PeriodMetrics can be queried for up to 455 days from the current point
  • Applicable to dashboards, widgets, and metric queries
Number of Metrics per QueryUp to 500 metrics can be selected for visualization in a graph
Metric Image File DownloadImages can be downloaded for up to 100 metrics
Metric Export to Object StorageExport up to 10 metrics; the query period can be up to 2 months (63 days) for metric data
Widget/Metric Count per Dashboard
  • Up to 500 widgets per dashboard
  • Up to 500 metrics per widget
  • Up to 2,500 total metrics can be added across all widgets in a single dashboard
Number of Alert PoliciesUp to 5,000 per account/region
Alert HistoryAlert history is available for 30 days
Recipients per Alert PolicyUp to 100
Number of Log GroupsUp to 10,000 per account/region
Log DownloadWhen downloading Excel, up to 1 MB per log event and up to 10,000 log events can be downloaded
  • If a log event exceeds 1 MB or the number of log events exceeds 10,000, it is recommended to use log group export.
Concurrent Log Group Export Tasks
  • One export task can be executed per account at a time.
Log Event SizeUp to 1 MB
Number of Event RulesUp to 300 per account/region
Event Pattern SizeUp to 2 MB
Recipients per Event RuleUp to 100
Table. ServiceWatch Limitations

The following shows the monthly free tier details for ServiceWatch.

CategoryFree Tier
LogsUp to 5 GB of storage per month
Metrics
  • Basic monitoring metrics for each service
  • Up to 10 detailed/custom/log pattern metrics per month
DashboardsUp to 3 dashboards per month referencing 50 or fewer metrics
  • If a dashboard references more than 50 metrics, one dashboard charge per month applies.
Alert PoliciesUp to 10 per month
Table. ServiceWatch Free Tier

Regional Availability

ServiceWatch is available in the following regions.

RegionAvailability
Korea West (kr-west1)Available
Korea East (kr-east1)Available
Korea South 1 (kr-south1)Available
Korea South 2 (kr-south2)Available
Korea South 3 (kr-south3)Available
Table. ServiceWatch Regional Availability

Prerequisite Services

ServiceWatch has no prerequisite services.

1 - Metrics

Metrics

Metrics are data on system performance. By default, many services provide free metrics for resources (e.g., Virtual Server, File Storage) which are offered as basic monitoring through ServiceWatch. Detailed monitoring can be enabled for certain resources such as Virtual Server.

Metric data is retained for 15 months (455 days), allowing access to both recent and historical data.

TermExampleDescription
NamespaceVirtual ServerLogical separation used to categorize and group metrics
MetricCPU usageName of the specific data to be collected
Dimensionresource_idActs as a unique identifier for the metric
Collection Interval5 minutesThe collection interval of metric data from each service providing the metric
StatisticAverageMethod of aggregating metric data over a specified period
Unit%Measurement unit for the statistic
Aggregation Period5 minutesPeriod over which collected metric data is aggregated
AlertCPU usage >= 80% | Occurs over 5 minutesChanges to an Alert state when CPU usage exceeds 80% continuously for 5 minutes
Table. ServiceWatch Metric Terminology

Namespace

Namespace is a logical separation used to distinguish and group metrics in ServiceWatch. Most Samsung Cloud Platform services use a namespace that matches the service name, which can be found in the ServiceWatch Integrated Services List.

For custom metrics, users can define a namespace that distinguishes them from other metrics within ServiceWatch, either via ServiceWatch Agent configuration or via the OpenAPI. For details on custom metrics and logs, see Custom Metrics and Logs.

Metrics

Metrics represent an ordered set of data points collected by ServiceWatch over time. Each data point consists of a timestamp, the collected value, and the unit of measurement.

For example, the CPU usage of a specific Virtual Server is one of the default monitoring metrics provided by Virtual Server. Data points can be generated by any application or activity that collects data.

By default, Samsung Cloud Platform services integrated with ServiceWatch provide free metrics for resources. Detailed monitoring for certain resources is available as a paid offering and can be enabled per service.

Metrics can only be queried in the region where they were generated. Users cannot manually delete metrics. However, if no new data is posted to ServiceWatch, metrics automatically expire after 15 months. Data points older than 15 months (455 days) are sequentially expired, and when new data points are added, those older than 15 months are deleted.

Timestamp

The timestamp of a data point indicates the time at which the data point was recorded. Each metric data point is composed of a timestamp and a value.

A timestamp consists of hour, minute, second, and date.

Metric Retention Period

ServiceWatch retains metric data as follows.

  • Data points with a collection interval of 60 seconds (1 minute) are retained for up to 15 days.
  • Data points with a collection interval of 300 seconds (5 minutes) are retained for up to 63 days.
  • Data points with a collection interval of 3600 seconds (1 hour) are retained for up to 455 days (15 months).

Data points initially collected at a short interval are downsampled for long-term storage. For example, if data is collected at a 1‑minute interval, it is retained at 1‑minute granularity for 15 days. After 15 days, the data remains available but can only be queried at 5‑minute intervals. After 63 days, the data is further aggregated and provided at 1‑hour intervals. If metric data points need to be retained longer than the retention period, they can be separately archived using the File Download or Object Storage Export features.

Dimensions

Key-value pairs that serve as unique identifiers for metrics, allowing data points to be categorized and filtered.

For example, using the resource_id dimension of Virtual Server metrics can identify metrics for a specific server.

Collection Interval

Refers to the frequency at which data points for each service’s metrics are collected, as provided by the service-defined collection interval.

Refer to each service’s ServiceWatch metric page for the metric collection intervals.

Note
Refer to the metric pages of ServiceWatch integrated services at Metrics and Log Monitoring.

For example, Virtual Server provides a 5‑minute collection interval for basic monitoring, and a 1‑minute interval when detailed monitoring is enabled.

Statistics

Statistics define how metric data is aggregated over a specified period. ServiceWatch provides aggregated data based on the metric data points supplied by each service to ServiceWatch. Aggregation uses the namespace, metric name, dimensions, and data point units within the defined aggregation period.

The provided statistics are Sum, Average, Minimum, and Maximum.

  • Sum: The sum of all data point values collected during the period.
  • Average: The sum of all data point values divided by the number of data points during the period.
  • Minimum: The lowest observed value during the period.
  • Maximum: The highest observed value during the period.

Units

Each statistic has a measurement unit. Examples of units include Bytes, Seconds, Count, Percent, etc.

Aggregation Period

Each statistic calculates metric data points collected over the chosen aggregation period. The aggregation period can be selected from 1 minute, 5 minutes, 15 minutes, 30 minutes, 1 hour, 3 hours, 6 hours, 12 hours, and 1 day, with a default of 5 minutes. The aggregation period is closely tied to the metric data point collection interval, and for valid aggregation results, the aggregation period must be equal to or longer than the collection interval.

For example, if the statistic is Average, the aggregation period is set to 5 minutes, and a metric with a 1‑minute collection interval is selected, data points are collected every minute and the average is computed over the 5‑minute window. Conversely, if the aggregation period is shorter than the collection interval, valid aggregation results cannot be obtained.

Downsampling is applied for long‑term retention of metric data. For example, if data is collected at a 1‑minute interval, after 15 days it can only be queried at 5‑minute granularity. Setting the aggregation period from 5 minutes to 30 minutes for such metrics may require up to 5 minutes to retrieve the downsampled data. After 63 days, the data is further aggregated and provided at 1‑hour intervals. Selecting an aggregation period from 1 hour to 1 day may require up to 1 hour for data retrieval due to aggregation processing delays.

Note
When retrieving metric data, aggregation delays may cause the most recent data point not to be displayed. In such cases, reducing the aggregation period or querying after a certain time (5 minutes or 1 hour) will allow the data to appear correctly.
Aggregation PeriodAggregation Delay
1 minute-
5 minutesUp to 5 minutes
15 minutesUp to 5 minutes
30 minutesUp to 5 minutes
1 hourUp to 1 hour
3 hoursUp to 1 hour
6 hoursUp to 1 hour
12 hoursUp to 1 hour
1 dayUp to 1 hour
Table. ServiceWatch aggregation delay by aggregation period

Alerts

When creating an alert policy, a metric is evaluated over the specified evaluation window, and if it meets the condition set based on the threshold, users receive an alert notification.

Alert states are Alert, Normal, and Insufficient data.

  • Alert: The metric meets the set condition.
  • Normal: The metric does not meet the set condition.
  • Insufficient data: No metric data exists, the metric data is missing, or data has not yet arrived.

When the alert state is Alert, if the evaluation later falls outside the condition, the alert state reverts to Normal.

For more details on alerts, see the Alert section.

Basic Monitoring and Detailed Monitoring

ServiceWatch offers two types of monitoring: basic monitoring and detailed monitoring.

Samsung Cloud Platform services integrated with ServiceWatch publish a basic set of metrics to ServiceWatch for free, providing basic monitoring. As soon as any of those services are used, basic monitoring is automatically enabled and visible in ServiceWatch.

Note
Services that provide basic monitoring can be found in the ServiceWatch Integrated Services List, and more services will be added over time.

Detailed monitoring is available for select services and incurs charges. To use detailed monitoring, it must be enabled in the service’s detailed settings.

The detailed monitoring options vary depending on the service.

  • For Virtual Server, the default monitoring collection interval is 5 minutes. Enabling detailed monitoring changes the collection interval for those metrics from 5 minutes to 1 minute.
  • Object Storage provides basic metrics for default monitoring, and enabling replication metrics adds additional replication metrics.

The following includes services that provide detailed monitoring and their guides.

Table. ServiceWatch Detailed Monitoring Services

2 - Alert

Alert

You can create alerts that monitor metrics and send notifications. For example, you monitor the CPU usage and disk read/write of a Virtual Server, then send a notification to the user to handle increased load.

Alert Policy

Alert policies can monitor metrics of the same Account and evaluate alerts for a single metric. These alert policies compare the specified threshold and metric conditions, and send notifications when the conditions are met.

If you disable the alert policy, the evaluation of the alert policy continues, but you can restrict sending alerts to designated recipients. If you want to temporarily stop sending alerts for resources with an alert policy set, you can use alert policy deactivation.

When you enable the alert policy, evaluation of the alert policy begins, and according to the set conditions, the alert status changes to Alert, and a notification is sent each time the alert status changes.

The alarm policy status allows you to check whether the alarm policy is enabled/disabled.

Alert Policy StatusDescription
ActiveA state where the alarm policy is active and notifications can be sent according to the set conditions
  • Evaluates the alarm according to the settings and sends notifications to the designated recipients
InactiveThe alarm policy is disabled, and notification sending is restricted
  • Alarm evaluation for the policy is not stopped, only notification sending is restricted.
Table. Alert Policy Status

You can set alert levels for the alert policy. Depending on the alert level, the alert color (red/pink/purple) is expressed differently so that the levels can be visually distinguished by color. You can filter according to the alert policy’s alert level and retrieve the alert policy by each alert level.

Alert LevelDescription
HighIf you set the step for the alarm policy condition to High, the alarm level is displayed in red
MidleIf you set the step to Middel in the alarm policy condition, the alarm step is displayed in pink
LowIf you set the step to Middel in the alarm policy condition, the alarm step is displayed in purple
Table. Alert Policy Levels

Alarm Status

Alert status changes according to the alert evaluation of the alert policy. Alert status is divided into three states: Normal (Normal), Insufficient data (Insufficient data), Alert (Alert).

Alarm StatusDescription
NormalMeans a normal state that does not meet the conditions set in the alarm policy
  • Normal state is displayed in green
Insufficient dataThe alarm policy has just been created, or the metric is unavailable, or there is insufficient data to determine the alarm state from the metric
  • The Insufficient data state is displayed in gray
AlertState that meets the conditions set in the alert policy
  • Alert state is displayed in red
  • When changed to Alert state, a notification is sent to the user
Table. Alarm Status
Reference
When an alarm policy is first created, the alarm state is initialized to Insufficient data. When metric data is later collected, the alarm state changes to Normal or Alert.

Alert Evaluation

TermDescription
Metric Data PointStatistical data calculated from metric data. A data point consists of a timestamp, collected statistical data, and the unit of the data.
  • The statistics of a data point are calculated separately as sum, average, minimum, and maximum
Metric collection intervalTime interval for collecting metric data per service
  • Specified per metric of the namespace
  • Example: 1 minute or 5 minutes
Alert Evaluation IntervalTime interval for evaluating whether the alert meets the conditions
  • If the metric collection interval is 1 minute or more, fix the alert evaluation interval to 1-minute units
  • If the alert evaluation range × metric collection interval exceeds 24 hours, fix the alert evaluation interval to 1-hour units
Alarm Evaluation ScopeEvaluation time range for alarm evaluation
  • It is recommended to set it to the metric collection interval or a multiple of the collection interval
Alert Evaluation Count/Alert Violation CountDuring the alert evaluation interval, if the condition is satisfied for violation count out of evaluation count, the alert status is switched to Alert
  • Violation count can be set less than or equal to evaluation count
  • Default is set to 1
Alarm evaluation intervalAlarm evaluation range(seconds) X Alarm evaluation count
Table. Alert Evaluation Terms

For example, for a metric with a 1-minute collection interval, if you set a 1-minute evaluation window with 4 violations out of 5 evaluation counts, the evaluation interval is 5 minutes. For a metric with a 5-minute collection interval, if you set a 10-minute evaluation window with 3 violations out of 3 evaluation counts, the evaluation interval is 30 minutes.

CategoryExample 1Example 2
Metric collection interval1 minute5 minutes
Alarm evaluation cycle (fixed)1 minute1 minute
Alert Evaluation Scope1 minute10 minutes
Number of alarm evaluations5 times3 times
Number of alarm violations4 times3 times
Alarm evaluation interval (seconds)5 minutes (300 seconds)30 minutes (1,800 seconds)
ConditionIf evaluated 5 times within 5 minutes and satisfies 4 conditions, change the alarm state to AlertIf evaluated 3 times within 30 minutes and satisfies 3 conditions, change the alarm state to Alert
Table. Alarm Evaluation Example

Evaluation Scope

The evaluation scope of the alarm policy is the evaluation time range for alarm evaluation.

  • It is recommended to set it to the indicator’s collection interval or a multiple of the collection interval.
  • You can input up to 604,800 (7 days) seconds.
Caution
If the evaluation range is set smaller than the collection interval or not matching a multiple of the collection interval, the alarm evaluation may not work properly.
Evaluation ScopeConfigurable number of evaluations
7 days (604,800 seconds)1
1 day (86,400 seconds)7 or less
6 hours (21,600 seconds)28 or less
1 hour (3,600 seconds)168 or less
15 minutes (900 seconds)96 or less
5 minutes (300 seconds)288 or less
1 minute (60 seconds)1,440 or less
Table. Number of evaluable evaluations that can be set according to evaluation range
Notice

There are the following restrictions on the evaluation scope and the number of evaluations:

  • When the evaluation range is 1 hour (3,600 seconds) or more, the evaluation interval (evaluation count × evaluation range) can be up to 7 days (604,800 seconds)
  • When the evaluation range is less than 1 hour (3,600 seconds), the evaluation interval (evaluation count × evaluation range) can be up to 1 day (86,400 seconds).

Condition

The conditions for performing alarm evaluation require a conditional operator and threshold setting.

TermDescription
StatisticsMethod of calculating metric data during the evaluation period for alarm assessment
Conditional OperatorAfter calculating metric data over the evaluation period for alarm evaluation, select the conditional operator that compares the value with the threshold.
ThresholdDefine a threshold to compare with the calculated metric data during the evaluation period for alarm assessment using a conditional operator
Table. Condition Terms

If the namespace is Virtual Server and the metric is CPU Usage (unit: %), the alarm evaluation condition is completed as below.

CategoryExample 1Example 2
Metric collection interval1 minute5 minutes
Alarm evaluation interval (fixed)1 minute1 minute
Alert Evaluation Scope1 minute10 minutes
Number of alarm evaluations5 times3 times
Alarm violation count4 times3 times
Alarm evaluation interval (seconds)5 minutes (300 seconds)30 minutes (1,800 seconds)
StatisticsAverageTotal
conditional operator>=<
threshold8020
ConditionIf the average CPU Usage >= 80% for 4 times over 5 minutes, change the alert status to AlertIf the average CPU Usage < 20% for 3 times over 30 minutes, change the alert status to Alert
Table. Alarm Evaluation Example - Conditional Operator, Threshold, Statistics Added

Alarm Notification

If the alarm evaluation conditions are met, change the alarm status to Alert and send a notification to the recipients set in the alarm policy.

Reference
  • Only users with login history (users who have registered email or mobile phone number) can be added as alert recipients.
  • Notification reception method (E-mail or SMS) can be set by selecting the notification target as Service > Alert on the Notification Settings page.
  • Notification recipients can be added up to a maximum of 100.
Guide
  • Users without login history cannot be designated as notification recipients.
  • Notification Settings page, if you select the notification target Service > Alert and do not set the notification reception method, you cannot receive notifications.

Method for handling missing data during alarm evaluation

Some resources may not be able to send metric data to ServiceWatch under certain conditions. For example, if a specific resource is inactive or does not exist, it will not be sent to ServiceWatch. If metrics are not collected for a certain period, the alarm state will be changed to Insufficient data by the alarm evaluation.

ServiceWatch provides a way to handle missing data during alarm evaluation. The missing data handling methods are as follows:

  • Ignore: Maintain the current alarm state. (default)
  • Missing: Treat missing data points as missing. If all data points within the evaluation range are missing, the alarm state switches to Insufficient data state.
  • Breaching: Treat as satisfying the threshold condition for missing data points.
  • Not breaching: Process as normal for missing data points that do not satisfy the threshold condition.
Reference
  • For alert policies created before the December 2025 release, missing data is handled with the default Ignore, and from the December 2025 release onward, you can directly choose how to handle missing data.
  • The method for handling missing data in the alarm policy can be modified, and from the point of modification, missing data will be processed using the changed method.

Alert History

The change history for alarm status is recorded in the alarm history. The alarm history can be viewed for 30 days.

3 - Log

Log

By using ServiceWatch logs, you can monitor, store, and access log files collected from the resources of the service that provides the logs.

Log Group1Log Group1Log Group1Log Group2Log Group2Log Group2
Log Stream1Log Stream2Log Stream3Log StreamALog StreamBLog StreamC
Log EventLog EventLog EventLog EventLog EventLog Event
Log EventLog EventLog EventLog EventLog Event
Table. Log Configuration - Log Group, Log Stream, Log Event
Reference

Below is an example of log configuration.

  • 📂 Log Group: “WebApp-Logs”
    • 📄 Log Stream 1: “Server-1”
      • 📝 Log Event 1: “[2025-03-20 10:00:01] User logged in”
      • 📝 Log Event 2: “[2025-03-20 10:05:34] Database connection error”

Log Group

A log group is a container for log streams that share the same retention policy settings. Each log stream must belong to a single log group. For example, if there are separate log streams for the logs of each Kubernetes Engine cluster, you can group the log streams into a single log group called /scp/ske/{cluster name}.

Log Retention Policy

Log retention policy can set the period for storing log events in ServiceWatch. Log events whose period has expired are automatically deleted. Log The retention period assigned to the group applies to the log streams and log events belonging to the log group.

The retention period can be selected from the following and is set in days.

Retention period
  • No expiration
  • 1 day
  • 3 days
  • 5 days
  • 1 week (7 days)
  • 2 weeks (14 days)
  • 1 month (30 days)
  • 2 months (60 days)
  • 3 months (90 days)
  • 4 months (120 days)
  • 5 months (150 days)
  • 6 months (180 days)
  • 1 year (365 days)
  • 13 months (400 days)
  • 18 months (545 days)
  • 2 years (731 days)
  • 3 years (1096 days)
  • 5 years (1827 days)
  • 6 years (2192 days)
  • 7 years (2557 days)
  • 8 years (2922 days)
  • 9 years (3288 days)
  • 10 years (3653 days)
Table. Log Group Retention Policy Period

Log Stream

A log stream is a collection of log events sorted in the order they occurred from the same source. For example, all log events generated in a particular Kubernetes Engine cluster can constitute a single log stream.

Log Event

Log events are individual records that record logs generated from resources. A log event record includes a timestamp of when the event occurred, a log message, and two attributes. Each message must be encoded in UTF-8.

Log Pattern

You can create a log pattern to filter log data that matches the pattern. A log pattern defines the words or patterns to search for in the log data collected by ServiceWatch, allows you to view the status of log occurrences in a graph, and creates metrics that can be used to generate alert policies.

Log patterns are not applied retroactively to data. They are applied to log events collected after the log pattern is created.

Log Pattern Namespace

A namespace is a logical separation for distinguishing and grouping metrics. In ServiceWatch, it is divided into namespaces associated with services, namespaces for custom metrics, and namespaces for log patterns.

  • Namespace associated with services such as Virtual Server
  • Namespace composed of custom metrics, the namespace of metrics collected via the custom metrics API or ServiceWatch Agent
  • Namespace of the metric created by the log pattern

When creating metrics for a log pattern, you can either create a new namespace for the log pattern or choose from existing log pattern namespaces.

Indicator Name

The monitored log information is the name of the metric generated by ServiceWatch. You must set it so that the metric name does not duplicate within the namespace where the metric will exist.

Indicator value

It is the numeric value posted to the metric each time a log matching the pattern is found. For example, when counting occurrences of a specific word (e.g., Error), this value becomes 1 for each occurrence. When calculating transmitted bytes, it can be incremented by the actual number of bytes found in the log event.

Default

It is the value recorded in the log pattern during periods when no matching logs can be found while collecting logs. Setting the default to 0 can prevent the metric from becoming irregular due to periods with no matching data in all such intervals.

If you set a dimension for a metric generated by a log pattern, you cannot set a default value for that metric.

Dimension

A dimension is a key-value pair that defines a metric additionally. You can add dimensions to metrics generated from log patterns. Since a dimension is part of a unique identifier for a metric, each time a unique name/value pair is extracted from the log, a new variant of that metric is created.

When selecting the log pattern format as either a space-separated pattern or a JSON format pattern, you can set the dimension, and it can be configured as one of the parameters set in the pattern. You can assign up to three dimensions to an indicator. If a default value is set, you cannot set dimensions. To set dimensions, you must configure it not to use the default value.

Pattern Format

This explains how ServiceWatch interprets data in each log event. The pattern format can be selected from three options as shown below.

  • String pattern: Log containing a specific string
  • Space-separated pattern: logs separated by spaces such as timestamps, IP addresses, strings, etc.
  • JSON format pattern: logs containing specific JSON fields

Available regular expression syntax

When using regular expressions to search and filter log data, you must enclose the expression with %.

Only the following can be included in patterns that contain regular expressions.

  • Alphanumeric - Alphanumeric refers to characters that are letters (A~Z or a~z) or numbers (0~9).
    • A-Z, a-z, 0-9 can be used as.
  • The supported symbol characters are as follows.
    • :, _, #, =, @, /, ;, ,, -
    • For example, %servicewatch!% cannot be used because ! is not supported.
  • The supported operators are as follows.
    • This includes ^, $, ?, [, ], {, }, |, \, *, +, ..
    • (, ) The operator is not supported.

OperatorUsage Method
^Fixes the start position of the string as the matching item. For example, %^[ab]cd% matches acd and bcd, and does not match bcd.
$Fixes the end position of the string to match items. For example, %abc$% matches xyzabc and xyabc, but does not match abcd.
??Matches when the preceding character appears 0 or 1 times. For example, %abc?d% matches both abcd and abd, while abc and abccd do not match.
[]Matches a list of characters or character ranges enclosed in brackets. For example, %[abc]% matches a, b, c, %[a-z]% matches all lowercase letters from a to z, and %[abcx-z]% matches a, b, c, x, y, z.
{m, n}If the preceding character repeats m~n times, it matches. For example, %a{3,5}% matches only aaa, aaaa and aaaaa, and does not match a or aa.
|matches one of the characters on either side of |.
  • %abc|de% can match abce or abde.
</code>As an escape character, using this character allows you to use it literally instead of its special operator meaning.
*Matches zero or more of the preceding character. For example, %12*3% matches 13, 123, 122223.
+Matches one or more of the preceding character. For example, %12+3% can match 123, 1223, 12223, but does not match 13.
.Matches any character. For example, %.ab% matches cab, dab, bab, 8ab, #ab, ab (including space), and matches a 3-character string ending with ab.
\d, \DMatches digits and non-digit characters. For example, %\d% is equivalent to %[0-9]%, and %\D% matches all characters except digits, like %[^0-9]%.
\s, \SMatches whitespace characters and non-whitespace characters. Whitespace characters include tab (\t), space ( ), and newline (\n) characters.
\w, \WMatches alphanumeric characters and non-alphanumeric characters. For example, %\w% is equivalent to %[a-zA-Z_0-9]%, and %\W% is equivalent to %[^a-zA-Z_0-9]%.
\xhhMatches the ASCII mapping of a 2-digit hexadecimal character. \x is an escape character indicating that the following character is the hexadecimal value in ASCII. hh specifies a 2-digit hexadecimal (0~9 and A~F) that refers to a character in the ASCII table.
Table. Regular expression syntax operators available for log pattern

Reference
123.123.123.1와 같은 IP 주소를 정규식으로 표현하기 위해서는 %123.123.123.1%와 같이 표현합니다.

String Pattern

String pattern using regular expressions

You can search for matching patterns in log events using a regex string pattern wrapped with %(percentage) at the beginning and end of the regex. Below is an example of a pattern that searches all log events composed of the ERROR keyword. Please refer to the Available Regex Syntax.

%ERROR%
  The above pattern matches log event messages like the following.
* <code>[2026-02-13 14:22:01] ERROR 500 POST /api/v1/checkout (192.168.1.10) - NullPointerException at com.app.controller.CheckoutController.java:55</code>
* <code>[ERROR] Configuration file not found: /etc/app/config.yaml</code>

##### String pattern in log events without format
String pattern for searching strings in log events that are not in formats like JSON.
Below is an example of a log event message, and you can see the log events that match according to various string pattern classifications.

ERROR CODE 400 BAD REQUEST ERROR CODE 401 UNAUTHORIZED REQUEST ERROR CODE 419 MISSING ARGUMENTS ERROR CODE 420 INVALID ARGUMENTS






Category Pattern Matching log event message
single string ERROR CODE log event containing ERROR
  • ERROR CODE 400 BAD REQUEST
  • ERROR CODE 401 UNAUTHORIZED REQUEST
  • ERROR CODE 419 MISSING ARGUMENTS
  • ERROR CODE 420 INVALID ARGUMENTS
Multiple strings (And condition) ERROR REQUEST log events containing the strings ERROR and REQUEST
  • ERROR CODE 400 BAD REQUEST
  • ERROR CODE 401 UNAUTHORIZED REQUEST
Multiple strings (Or condition) ?ERROR ?400 log events containing the ERROR or 400 string
  • ERROR CODE 400 BAD REQUEST
  • ERROR CODE 401 UNAUTHORIZED REQUEST
  • ERROR CODE 419 MISSING ARGUMENTS
  • ERROR CODE 420 INVALID ARGUMENTS
Exact matching string “BAD REQUEST” log event containing the exact phrase “BAD REQUEST”
  • ERROR CODE 400 BAD REQUEST
Exclude specific string ERROR -400 A pattern where some terms are included and other terms are excluded. Enter - before the string you want to exclude. The following are log events that include the string ERROR and exclude the string 400
  • ERROR CODE 401 UNAUTHORIZED REQUEST
  • ERROR CODE 419 MISSING ARGUMENTS
  • ERROR CODE 420 INVALID ARGUMENTS
Table. String pattern in log events without format
#### Space-separated pattern Create a pattern to search for matching strings in log events separated by spaces. ##### Space-separated pattern example(1) The following is an example of log events separated by spaces.

2023-10-27T10:00:01Z [INFO] 1234 login success 192.168.1.1

The log event above is a space-separated log event that includes <code>timestamp</code>, <code>logLevel</code>, <code>user_id</code>, <code>action</code>, <code>status</code>, <code>ip</code>. Text between brackets (<code>[]</code>) and double quotes (<code>""</code>) is considered a single field.

To create a pattern that searches for matching strings in space-separated log events, enclose the pattern in brackets (<code>[]</code>) and specify fields with names separated by commas (<code>,</code>). The following pattern parses six fields.

<code>[timestamp, logLevel, user_id, action, status = success, ip]</code> can find log events where the 5th field, <code>status</code>, is <code>success</code>.

##### Space-separated pattern example (2)

abc xxx.log james 2023-10-27T10:00:01Z POST 400 1024 abc xxx.log name 2023-10-27T10:00:02Z POST 410 512

The above log event is a space-separated log event that includes host, logName, user, timestamp, request, statusCode, and size.

A pattern like [host, logName, user, timestamp, request, statusCode=4*, size] can find log events where the 6th field, statusCode, starts with 4.

If you do not know the exact number of fields in a space-separated log event, you can use an ellipsis (). A pattern like […, statusCode=4*, size] is a pattern that represents the first five fields with an ellipsis.

You can also create composite expressions using the AND (&&) operator and the OR (||) operator. A pattern such as […, statusCode=400 || statusCode=410, size] can find log events where the 6th field, statusCode, is 400 or 410.

You can use regular expressions to provide conditions for a pattern. A pattern such as [host, logName, user, timestamp, request, statusCode=%4[0-9]{2}%, size] can find log events where the sixth field, statusCode, is a number starting with 4.

JSON format pattern

You can create a pattern to search for matching strings or numeric values in JSON log events. Patterns are enclosed in curly braces ({}).

String-based JSON format pattern
  • Use $. to represent JSON fields.
  • The operator can use = or !=.
  • The string to compare with the field can be enclosed in double quotes (""). Strings containing non-alphanumeric characters and underscore symbols must be enclosed in double quotes. Use an asterisk (*) as a wildcard to match text.
{ $.resourceType = "trail" }
{ $.resourceType = "%trail%" }
{ $.arrayKey[0] = "value" }
JSON format pattern that searches for numeric values
  • Represent JSON fields using $..
  • You can use numeric operators.
    • greater than(>), less than(<), equal(=), not equal(!=), greater than or equal to(>=), less than or equal to(<=)
  • You can include the addition (+) or subtraction (-) symbols. You can use the asterisk (*) as a wildcard.

{ $.errorCode = 400} { $.errorCode >= 400} { $.errorCode != 500 } { $.sourceIPAddress != 123.123.* }

Export Log Group

From the log group, you can export log data to Object Storage for log retention and log analysis. You can export log groups for log data in the same Account.

To start exporting a log group, you need to create an Object Storage bucket to store the log data.

The log group export operation can take a long time depending on the amount of logs. When exporting a log group, you can reduce the export operation time by specifying a particular stream within the log group or by specifying a time range.

Log group export can only be executed one at a time on the same Account. To run another log group export, the current export task must be completed.

You can delete the log group export history after the export succeeds or after the export cancellation is completed. Canceling log group export does not delete the saved file of the exported log group. To delete the exported log group file, delete the stored file directly in Object Storage.

Log group export statusDescription
SuccessThe log group export task has been completed successfully.
PendingLog group export task is pending.
In progressLog group export task is in progress.
FailedLog group export task failed.
CancelingCancelling the log group export task. If the cancel request fails, it will change to Failed state.
CanceledLog group export task has been cancelled.
Table. Log Group Export Status

4 - event

The event represents a change in the environment in the Samsung Cloud Platform service.

Most events generated in Samsung Cloud Platform services are received by ServiceWatch. Events of each service can be viewed and processed in the ServiceWatch of the same Account.

Refer to the list of services that send events via ServiceWatch and the events those services send in the ServiceWatch Event Reference.

Each service sends events to ServiceWatch based on Best Effort delivery. Best Effort delivery means that the service attempts to send all events to ServiceWatch, but occasionally some events may not be delivered.

When a valid event is delivered to ServiceWatch, ServiceWatch compares the event with the rules and then sends a notification to the alert recipients set in the event rule.

Event Rules

You can specify the actions that ServiceWatch performs on events delivered from each service to ServiceWatch. To do this, create an event rule. An event rule specifies which events are delivered to which targets.

Event rules evaluate the event when it arrives. Each event rule checks whether the event matches the rule’s pattern. If the event matches, ServiceWatch processes the event.

You can generate matching rules for incoming events based on the event data criteria (called an event pattern). If an event matches the criteria defined in the event pattern, the event is delivered to the target specified in the rule.

  • Event rules basically allow you to specify a notification recipient to receive alerts when an event occurs.
  • The event rules are planned to be expanded to include multiple services of the Samsung Cloud Platform as targets for receiving events when events occur. (Planned for 2026)

To create an event rule, please refer to How-to Guides > Creating Event Rules.

Event Source

ServiceWatch can select the event source as the Samsung Cloud Platform service name. You can select the service name of the event you want to receive as the event source.

Service CategoryService
ComputeVirtual Server
ComputeGPU Server
ComputeBare Metal Server
ComputeMulti-node GPU Cluster
ComputeCloud Functions
StorageBlock Storage(BM)
StorageFile Storage
StorageObject Storage
StorageArchive Storage
StorageBackup
ContainerKubernetes Engine
ContainerContainer Registry
NetworkingVPC
NetworkingSecurity Group
NetworkingLoad Balancer
NetworkingDNS
NetworkingVPN
NetworkingFirewall
NetworkingDirect Connect
NetworkingCloud LAN-Campus
NetworkingCloud LAN-Datacenter
NetworkingCloud WAN
NetworkingGlobal CDN
NetworkingGSLB
DatabaseEPAS(DBaaS)
DatabasePostreSQL(DBaaS)
DatabaseMariaDB(DBaaS)
DatabaseMySQL(DBaaS)
DatabaseMicrosoft SQL Server(DBaaS)
DatabaseCacheStore(DBaaS)
Data AnalyticsEvent Streams
Data AnalyticsSearch Engine
Data AnalyticsVertica(DBaaS)
Data AnalyticsData Flow
Data AnalyticsData Ops
Data AnalyticsQuick Query
Application ServiceAPI Gateway
SecurityKey Management Service
SecurityConfig Inspection
SecurityCertificate Manager
SecuritySecret Vault
ManagementCloud Control
ManagementIdentity and Access Management(IAM)
ManagementID Center
ManagementLogging&Audit
ManagementOrganization
ManagementResource Groups
ManagementServiceWatch
ManagementSupport Center
AI-MLCloudML
AI-MLAI&MLOps Platform
Table. ServiceWatch event source

Event Type

The Samsung Cloud Platform service has its own resource type. Event types are classified the same as resource types, and you select the type of events from the event source to use in event rules.

The following are the event types of Virtual Server.

Service CategoryServiceSub ServiceEvent Type
ComputeVirtual ServerVirtual ServerServer
ComputeVirtual ServerImageImage
ComputeVirtual ServerKeypairKeypair
ComputeVitual ServerServer GroupServer Group
ComputeVirtual ServerLaunch ConfigurationLaunch Configuration
ComputeVirtual ServerAuto-Scaling GroupAuto-Scaling Group
ComputeVirtual ServerBlock StorageVolume
ComputeVirtual ServerBlock StorageSnapshot
Table. ServiceWatch - Virtual Server Event Types

For other event types available in ServiceWatch, please refer to ServiceWatch Event.

Event

The event can select all events that occur from the event type of the event source, and can select specific events.

The following are some events of the Server event type of Virtual Server.

Service CategoryServiceSub ServiceEvent TypeEvent
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Create Start
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Create End
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Create Error
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Delete Start
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Delete End
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Delete Error
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Lock End
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Unlock End
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Stop Start
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Stop Success
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Start Start
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Start Success
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Reboot Start
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Reboot End
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Reboot Error
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Power On Start
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Power On End
ComputeVirtual ServerVirtual ServerServerCompute Virtual Server Power On Error
Table. Some events of ServiceWatch - Virtual Server Server

For other events available in ServiceWatch, see ServiceWatch Event.

Applied Resources

Set the event pattern for selected events on all resources or specific resources.

Event Pattern

If you select all event sources, event types, events, and applied resources, the event pattern setting for the event rule will be completed.

The following is an example of an event pattern set in ServiceWatch’s event rule.

Color mode
{
	"source": [ // namespace
		"Virtual Server"
	],
	"detail-type": [ // event type
		"Server"
	],
	"detail": {
		"event": [ // individual event
			"Compute Virtual Server Create End"
		]
	},
	"resources": [ // individual resources
		"srn:{offerring}::{account_id}:{region}::virtualserver:server/{resource_id}"
	]
}
{
	"source": [ // namespace
		"Virtual Server"
	],
	"detail-type": [ // event type
		"Server"
	],
	"detail": {
		"event": [ // individual event
			"Compute Virtual Server Create End"
		]
	},
	"resources": [ // individual resources
		"srn:{offerring}::{account_id}:{region}::virtualserver:server/{resource_id}"
	]
}
Code block. ServiceWatch - Virtual Server event pattern example

To create an event rule, please refer to How-to Guides > Creating Event Rules.

Event Notification

If the event pattern is satisfied, an alert is sent to the notification recipient set in the event rule.

Reference
  • Notifications can be sent to users with login history (users who have registered email or mobile phone number).
  • The notification recipients can be added up to a maximum of 100 people.
  • The notification reception method (E-mail or SMS) can be changed after selecting the notification target as Service > ServiceWatch on the Notification Settings page.
Notice
  • Users without login history cannot be designated as notification recipients.
  • Notification Settings page, by selecting the notification target Service > ServiceWatch, if you do not set the notification receiving method, you cannot receive notifications.

5 - ServiceWatch Integration Service

You can check services linked with ServiceWatch.

Metrics and Log Monitoring

Below you can see the service that integrates ServiceWatch with metric and log monitoring.

Reference
For information related to basic monitoring and detailed monitoring, please refer to ServiceWatch Basic Monitoring and Detailed Monitoring.
Service CategoryServiceNamespaceMetrics
Basic Monitoring
Metrics
Detailed Monitoring
Log MonitoringGuide
ComputeVirtual ServerVirtual Server-
ComputeGPU ServerVirtual Server-
ComputeBare Metal Server----
ComputeMulti-node GPU Cluster----
ComputeCloud FuctionsCloud Functions-
StorageFile StorageFile Storage-
StorageObject StorageObject Storage--
StorageArchive StorageArchive Storage--
ContainerKubernetes EngineKubernetes Engine-
ContainerContainer RegistryContainer Registry--
NetworkingVPC - Internet GatewayInternet Gateway--
NetworkingVPNVPN--
NetworkingGlobal CDNGlobal CDN--
NetworkingDirect ConnectDirect Connect--
DatabaseMariaDB(DBaaS)MariaDB-
DatabaseMySQL(DBaaS)MySQL-
DatabaseScalable DB(DBaaS)Scalable DB-
Data AnalyticsEvent StreamsEvent Streams-
Application ServiceQueue ServiceQueue Service--
ManagementLoggiing&AuditLogging&Audit--
AI/MLAIOSAIOS--
Table. ServiceWatch metrics and log integration services and guide

Event

Below you can check the service that links ServiceWatch with events.

Reference
For information related to event rules, refer to Event. Refer to the list of Samsung Cloud Platform services that generate events and the events at ServiceWatch Event.
Service CategoryServiceSub ServiceEvent SourceResource Type (Event Type)
ComputeVirtual ServerVirtual ServerVirtual ServerServer
ComputeVirtual ServerImageVirtual ServerImage
ComputeVirtual ServerKeypairVirtual ServerKeypair
ComputeVitual ServerServer GroupVirtual ServerServer Group
ComputeVirtual ServerLaunch ConfigurationVirtual ServerLaunch Configuration
ComputeVirtual ServerAuto-Scaling GroupVirtual ServerAuto-Scaling Group
ComputeVirtual ServerBlock StorageVirtual ServerVolume
ComputeVirtual ServerBlock StorageVirtual ServerSnapshot
ComputeGPU ServerGPU ServerGPU ServerServer
ComputeGPU ServerGPU ServerGPU ServerImage
ComputeBare Metal ServerBare Metal ServerBare Metal ServerBare Metal Server
ComputeMulti-node GPU ClusterGPU NodeMulti-node GPU ClusterGPU Node
ComputeMulti-node GPU ClusterCluster FabricMulti-node GPU ClusterCluster Fabric
ComputeCloud FunctionsFunctionCloud FunctionsCloud Functions
StorageBlock Storage(BM)Block Storage(BM)Block Storage(BM)Volume
StorageBlock Storage(BM)Volume Group(BM)Block Storage(BM)Volume Group
StorageFile StorageFile StorageFile StorageVolume
StorageObject StorageObject StorageObject StorageBucket
StorageArchive StorageArchive StorageArchive StorageBucket
StorageBackupBackupBackupBackup
ContainerKubernetes EngineClusterKubernetes EngineCluster
ContainerKubernetes EngineNodeKubernetes EngineNodepool
ContainerContainer RegistryRegistryContainer RegistryContainer Registry
ContainerContainer RegistryRepositoryContainer RegistryRepository
NetworkingVPCVPCVPCVPC
NetworkingVPCSubnetVPCSubnet
NetworkingVPCPortVPCPort
NetworkingVPCInternet GatewayVPCInternet Gateway
NetworkingVPCNAT GatewayVPCNAT Gateway
NetworkingVPCPublic IPVPCPublic IP
NetworkingVPCPrivate NATVPCPrivate NAT
NetworkingVPCVPC EndpointVPCVPC Endpoint
NetworkingVPCVPC PeeringVPCVPC Peering
NetworkingVPCPrivate Link ServiceVPCPrivate Link Service
NetworkingVPCPrivate Link EndpointVPCPrivate Link Endpoint
NetworkingVPCTransit GatewayVPCTransit Gateway
NetworkingSecurity GroupSecurity GroupSecurity GroupSecurity Group
NetworkingLoad BalancerLoad BalancerLoad BalancerLoad Balancer
NetworkingLoad BalancerLoad BalancerLoad BalancerLB Listener
NetworkingLoad BalancerLB Server GroupLoad BalancerLB Server Group
NetworkingLoad BalancerLB Health CheckLoad BalancerLB Health Check
NetworkingDNSPrivate DNSPrivate DNSPrivate DNS
NetworkingDNSHosted ZoneHosted ZoneHosted Zone
NetworkingDNSPublic Domain NamePublic Domain NamePublic Domain Name
NetworkingVPNVPNVPNVPN Gateway
NetworkingVPNVPN TunnelVPNVPN Tunnel
NetworkingFirewallFirewallFirewallFirewall
NetworkingDirect ConnectDirect ConnectDirect ConnectDirect Connect
NetworkingCloud LAN-CampusCampus NetworkCloud LAN - Campus (Network)Cloud LAN - Campus (Network)
NetworkingCloud LAN-DatacenterCloud LAN NetworkCloud LAN NetworkCloud LAN Network
NetworkingCloud LAN-DatacentervDeviceCloud LAN NetworkvDevice
NetworkingCloud LAN-DatacenterInterfaceCloud LAN NetworkInterface
NetworkingCloud LAN-DatacentervCableCloud LAN NetworkvCable
NetworkingCloud WANCloud WAN NetworkCloud WANNetwork(WAN)
NetworkingCloud WANSegmentCloud WANSegment
NetworkingCloud WANSegmentCloud WANSegment Location
NetworkingCloud WANSegmentCloud WANSegment Sharing
NetworkingCloud WANAttachmentCloud WANAttachment
NetworkingGlobal CDNGlobal CDNGlobal CDNGlobal CDN
NetworkingGSLBGSLBGSLBGSLB
DatabaseEPAS(DBaaS)EPAS(DBaaS)EPASEPAS
DatabasePostreSQL(DBaaS)PostreSQL(DBaaS)PostreSQLPostreSQL
DatabaseMariaDB(DBaaS)MariaDB(DBaaS)MariaDBMariaDB
DatabaseMySQL(DBaaS)MySQL(DBaaS)MySQLMySQL
DatabaseMicrosoft SQL Server(DBaaS)Microsoft SQL Server(DBaaS)Microsoft SQL ServerMicrosoft SQL Server
DatabaseCacheStore(DBaaS)CacheStore(DBaaS)CacheStoreCacheStore
DatabaseScalable DB(DBaaS)Scalable DB(DBaaS)Scalable DBScalable DB
Data AnalyticsEvent StreamsEvent StreamsEvent StreamsEvent Streams
Data AnalyticsSearch EngineSearch EngineSearch EngineSearch Engine
Data AnalyticsVertica(DBaaS)Vertica(DBaaS)VerticaVertica
Data AnalyticsData FlowData FlowData FlowData Flow
Data AnalyticsData FlowData Flow ServicesData FlowData Flow Service
Data AnalyticsData OpsData OpsData OpsData Ops
Data AnalyticsData OpsData Ops ServicesData OpsData Ops Service
Data AnalyticsQuick QueryQuick QueryQuick QueryQuick Query
Application ServiceAPI GatewayAPI GatewayAPI GatewayAPI Gateway
Application ServiceQueue ServiceQueueQueueQueue
SecurityKey Management ServiceKey Management ServiceKey Management ServiceKey
SecurityConfig InspectionConfig InspectionConfig InspectionConfig Inspection
SecurityCertificate ManagerCertificate ManagerCertificate ManagerCertificate
SecuritySecrets ManagerSecrets ManagerSecrets ManagerSecret
SecuritySecret VaultSecret VaultSecret VaultSecret
ManagementCloud ControlCloud ControlCloud ControlLanding Zone
ManagementIdentity and Access Management(IAM)User GroupIdentity and Access ManagementGroup
ManagementIdentity and Access Management(IAM)UserIdentity and Access ManagementUser
ManagementIdentity and Access Management(IAM)policyIdentity and Access Managementpolicy
ManagementIdentity and Access Management(IAM)roleIdentity and Access Managementrole
ManagementIdentity and Access Management(IAM)credential providerIdentity and Access Managementcredential provider
ManagementIdentity and Access Management(IAM)My Info.Identity and Access ManagementAccess Key
ManagementID CenterID CenterIdentity CenterID Center
ManagementID CenterPermission SetIdentity CenterPermission Set
ManagementLogging&AuditTrailLogging&AuditTrail
ManagementOrganizationOrganizational StructureOrganizationOrganization
ManagementOrganizationOrganization StructureOrganizationOrganization Account
ManagementOrganizationOrganizational StructureOrganizationOrganization Invitation
ManagementOrganizationOrganizational structureOrganizationOrganizational unit
ManagementOrganizationControl PolicyOrganizationControl Policy
ManagementOrganizationOrganization SettingsOrganizationDelegation Policy
ManagementResource GroupsResource GroupsResource GroupsResource Group
ManagementServiceWatchDashboardServiceWatchDashboard
ManagementServiceWatchAlertServiceWatchAlert
ManagementServiceWatchlogServiceWatchlog group
ManagementServiceWatchEvent RulesServiceWatchEvent Rules
ManagementSupport CenterService RequestSupportService Request
ManagementSupport CenterContactSupportContact
AI-MLCloudMLCloudMLCloud MLCloud ML
AI-MLAI&MLOps PlatformAI&MLOps PlatformAI&MLOps PlatformAI&MLOps Platform
Table. ServiceWatch Event Service

6 - Custom Metrics and Logs

ServiceWatch can collect user-defined custom metrics defined by the user and can collect log files from resources created by the user.

There are two ways to collect custom metrics and logs.

First, you can install the ServiceWatch Agent directly on the resource, set the resources to be collected, and collect them.
The second is that you can collect custom metrics and logs through the OpenAPI/CLI provided by ServiceWatch.

Reference
Custom metric/log collection via ServiceWatch Agent is currently only available on Samsung Cloud Platform For Enterprise. It will be offered in other offerings in the future.
Caution

ServiceWatch’s metric API incurs costs for calls. Collecting metrics via the ServiceWatch Agent also operates on an OpenAPI basis, so metric API calls incur costs.
Caution is needed to avoid excessive API calls for metric and log collection. The billable metric APIs are as follows.

APIdescription
ListMetricDataMetric data list retrieval.
  • Since a single API call can request multiple metrics, charges are applied per 1,000 metric requests.
DownloadMetricDataImageMetric data widget image download.
  • Since a single API call can request multiple metrics, a charge is applied per 1,000 requested metrics.
ListMetricInfosRetrieve metric data.
  • Charges apply per 1,000 calls of this API
CreateCustomMetricMetasCreate custom metric meta data
  • This API is charged per 1,000 calls
CreateCustomMetricsCreate custom metric data (transmission)
  • This API is charged per 1,000 calls
ShowDashboardDashboard view
  • This API charges a fee per 1,000 calls
ListDashboardsDashboard list retrieval
  • This API is charged per 1,000 calls
CreateDashboardCreate Dashboard
  • This API is charged per 1,000 calls
SetDashboardEdit Dashboard
  • This API is charged per 1,000 calls
DeleteBulkDashboardsDelete Dashboard
  • This API is charged per 1,000 calls
Table. Indicator API Billing Guide

Logs incur charges based on the amount of data collected, so there is no separate charge for API calls.

※ For detailed pricing information, please refer to the ServiceWatch pricing information on the Samsung Cloud Platform Service Portal.

ServiceWatch Agent

You can install the ServiceWatch Agent on the user’s resources such as Virtual Server/GPU Server/Bare Metal Server to collect custom metrics and logs.

ServiceWatch Agent Constraints

ServiceWatch Agent Network Environment

ServiceWatch Agent is designed to collect data using OpenAPI by default, so to install and use it on server resources, external communication via the Internet must be possible. Please create an Internet Gateway in the VPC where the resources are located and set a NAT IP on the server resources so that they can communicate with the outside.

ServiceWatch Agent Supported OS Image

The OS images available for ServiceWatch Agent are as follows.

OS Image VersionEOS Date
Alma Linux 8.102029-05-31
Alma Linux 9.62025-11-17
Oracle Linux 8.102029-07-31
Oracle Linux 9.62025-11-25
RHEL 8.102029-05-31
RHEL 9.42026-04-30
RHEL 9.62027-05-31
Rocky Linux 8.102029-05-31
Rocky Linux 9.62025-11-30
Ubuntu 22.042027-06-30
Ubuntu 24.042029-06-30
Windows 20192029-01-09
Windows 20222031-10-14
Table. ServiceWatch Agent usable OS Image

Provides the same as the OS Image provided by Virtual Server. Please refer to Virtual Server > OS Image provided version.

Quick Guide for Using ServiceWatch Agent

Below, we introduce a quick guide for collecting OS metrics and logs of Virtual Server in a Linux environment.

Node Exporter Installation and Configuration

  1. Refer to Node Exporter installation and install Node Exporter on the server for collecting custom metrics.
    • If you install Node Exporter, you can collect OS metrics through Node Exporter in addition to the metrics provided by ServiceWatch’s default monitoring.
  2. ServiceWatch Agent Settings refer to and after downloading the ServiceWatch_Agent zip file, configure and run the ServiceWatch Manager.
    • Refer to the examples/os-metric-min-examples folder in the zip file to set at least two metrics and run the ServiceWatch Agent.
Caution

Metric collection via ServiceWatch Agent is classified as custom metrics and, unlike the metrics collected by default from each service, incurs charges, so you must be careful not to set up unnecessary metric collection. Ensure that only the metrics that need to be collected are collected.

  • Free provision is provided up to 10 per Account/region.
Note
For detailed information on using ServiceWatch Agent, please refer to How-to guides > Using ServiceWatch Agent.

ServiceWatch Custom Metrics and Logs API

You can collect custom metrics and logs through the OpenAPI/CLI provided by ServiceWatch.

Custom metric data and custom logs can be delivered to ServiceWatch via ServiceWatch OpenAPI/CLI, allowing you to view visualized information in the Console.

Caution

Collecting metrics via ServiceWatch OpenAPI/CLI is classified as custom metrics, and unlike the metrics that are collected by default from each service, charges apply, so you must be careful not to set up unnecessary metric collection. Make sure to configure it so that only the metrics that need to be collected are collected.

  • Free provision is provided up to 10 per Account/region.

Create Custom Metric Metadata

To collect metric data generated from user resources or applications, rather than metrics provided by Samsung Cloud Platform services (e.g., Virtual Server), into ServiceWatch, you need to create custom metric metadata.

ParameterExplanation
namespaceUsers can define a namespace in ServiceWatch that can be distinguished from other metrics
  • The namespace must be 3 to 128 characters, including letters, numbers, spaces, and special characters (_ - /), and must start with a letter.
  • For detailed information, refer to Namespace.
metricMetas > metricNameSet the name of the metric to be collected. The metric name must be 3 to 128 characters long, including English letters, numbers, and special characters (_), and must start with an English letter.
  • Example: custom_cpu_seconds_total
metricMetas > storageResolutionSet the collection interval for the corresponding metric. The default is 60 (1 minute) and can be set in seconds
metricMetas > unitMetric unit can be set
  • Example: Bytes, Count, etc.
metricMetas > dimensionsYou can set dimensions to identify custom metric data and visualize it in the Console. When visualizing the collected metrics in the Console, they are displayed in combinations according to the dimension (dimensions) settings.
metricMetas > descriptionKoKorean description of the metric being collected
metricMetas > descriptionEnEnglish description of the metric being collected
Table. User-defined metric metadata parameter description

For detailed information on creating custom metric metadata, see CreateCustomMetricMetas.

Create Custom Metrics

After generating custom metric metadata, you can deliver the resulting metric data to ServiceWatch using the CreateCustomMetrics API.

The transmitted metric data can be queried, separated by the configured namespace.

For detailed information on creating custom metric data, refer to CreateCustomMetrics.

Indicator Data Query

Metric data, including custom metrics, can be queried using the Console and the ListMetricInfos, ListMetricInfos API.

For detailed information on metric data retrieval, refer to ListMetricInfos and ListMetricData.

Log Stream Creation

A ServiceWatch log group is required for custom log collection. Log groups can only be created in the Console. After creating a log group in advance, you can use the log stream creation API to create a log stream to be delivered to ServiceWatch.

For detailed information on creating a log stream, refer to CreateCustomLogStream.

Log Event Creation

To collect custom logs, after creating log groups and log streams, we use the log event creation API to deliver individual log messages (log events) to ServiceWatch.

For detailed information on creating log events, refer to CreateCustomLogEvents.