The page has been translated by Gen AI.

Log

In ServiceWatch, you can set threshold criteria for the metrics you monitor, and when the specified conditions are met, you can create and manage log groups to generate alarm notifications.

Create Log Group

You can create a log group for the metric. To create a log group, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.

  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.

  3. Log Group List page, click the Create Log Group button. You will be taken to the Create Log Group page.

  4. Enter the basic information and tag information required to create a log group.

    Category
    Whether required
    Detailed description
    Log group nameRequiredEnter the name of the log group to monitor in ServiceWatch
    • using English letters, numbers, and special characters (-_./#) within 3 ~ 512 characters
    Log retention policyRequiredSelect the retention period for monitored log data
    TagSelectAdd tag information
    • Up to 50 tags can be added per resource
    • When adding a tag, entering the Key and Value allows selection from the list of previously created tag Keys and Values
    Table. Log group creation items

  5. After reviewing the summary information, click the Create button. A popup notifying the creation of the log group will appear.

  6. Click the Confirm button. Log group creation is complete.

Check log group details

You can view and manage detailed information about log groups.

To view detailed information about the log group, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. On the Log Group List page, click the log group name to view detailed information. You will be taken to the Log Group Details page.
    CategoryDetailed description
    Log group statusLog group status
    • Active: The log group is in an active state
    • Inactive: The log group is in an inactive state
    Export Log GroupStore log group log data in Object Storage
    Delete log groupDelete the corresponding log group
    Information Classification TabInformation tabs for log groups
    • Details, Log Streams, Tags, Activity History
    • Click each tab to view the corresponding information
    Table. Log Group Details
    Reference
    On the Log Group List page, click the More > Export Log Group button for the log group you want to store in Object Storage to export the data.
Reference

When sorting log group names in the log group list, follow the sorting rules below.

  1. Whitespace and control characters
  2. Some special characters ( !"#$%&()*+,-./ )
  3. Numbers (0–9)
  4. Some special characters ( ; < = > ? @ )
  5. English (A–Z, a–z, case-insensitive)
  6. Remaining special characters ([\]^_`)
  7. Other characters

Detailed Information

Log Group List page allows you to view the basic information and details of the selected log group.

CategoryDetailed description
ServiceService name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
  • In ServiceWatch, it refers to the SRN of the resource type
Resource NameResource name
  • In ServiceWatch, it refers to the name of the log group
Resource IDUnique resource ID in the service
ConstructorUser who created the service
Creation date and timeService creation date and time
EditorUser who edited the service information
Modification date and timeDate and time the service information was modified
Log group nameName of the log group
Log retention policyRetention period of log data
  • Edit Click the button to change the retention period
Log dataTotal stored log data size (bytes)
Table. Log Group Details – Details Tab Items
Reference
Log data is the total stored log data (bytes). It may take time for the log aggregation capacity to be reflected.

Log Stream

Log Group List page allows you to view the log streams of the selected log group.

CategoryDetailed description
View all streamsDetailed information for all log streams in the log stream list can be viewed
Create log streamCreate a new log stream
Log stream listLog stream name and log modification timestamp
  • Delete button can be clicked to delete the log stream
  • After checking the log streams to delete, click the More > Delete button at the top of the list to delete them simultaneously
Table. Log Group Details - Log Stream Tab Items

log pattern

Log Group List page allows you to view the log pattern of the selected log group.

CategoryDetailed description
Log pattern listLog pattern name, pattern, log pattern namespace, metric name, alert policy name information
  • Clicking the log pattern name or alert policy name navigates to the detail page of that item
  • Clicking the metric name navigates to the metric page that includes that metric name in the search query
  • Clicking the alert policy name navigates to the detail page of that alert policy
  • More button can be clicked to perform additional actions
    • Edit, Delete: modify or delete the log pattern
    • Create Alert Policy: navigate to the alert policy creation page
DeleteDelete all selected log patterns from the log pattern list
  • Activates when a log pattern is checked in the log pattern list
Generate log patternCreate a new log pattern
Table. Log Group Details - Log Pattern Tab Items

tag

On the Log Group List page, you can view the tag information of the selected log group and add, modify, or delete it.

CategoryDetailed description
Tag listTag’s Key and Value information
Edit tagYou can modify, delete, or add new tags to existing tag information
  • Up to 50 tags can be added per resource
  • When adding a tag, entering the Key and Value allows you to select from the list of previously created tag Keys and Values
Table. Log Group Details - Tag Tab Items

Job History

Log Group List page lets you view the operation history of the selected log group.

CategoryDetailed description
Task History ListResource Change History
  • You can view task details, task date/time, resource type, resource name, task result, and operator information
    • Settings button can be clicked to modify information fields
  • Filtering is possible using Period Selection, User Time Zone, entering operator information, and Detailed Search
  • Click a task entry in the Task History List to navigate to the Task Activity Details page for that task
Table. Log Group Details - Work History Tab Items

Managing Log Streams

You can create and manage log streams.

Create Log Stream

You can create a new log stream in a log group. To create a Hog stream, follow the steps below.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. On the Log Group List page, click the log group name for which you want to create a log stream. You will be taken to the Log Group Details page.
  4. Log Group Details page, click the Log Stream tab. The Log Stream list is displayed.
  5. Click the Create Log Stream button. The Create Log Stream popup opens.
  6. Enter the Log stream name, then click the Create button. Log stream creation is completed.
    • Enter the name using English letters and numbers, within 3~512 characters.

Check detailed log stream information

You can view and manage detailed information about log streams. To view detailed information about the log stream, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. Click the log group name on the Log Group List page to view detailed information. You will be taken to the Log Group Details page.
  4. On the Log Group Details page, click the Log Stream tab. The Log Stream list is displayed.
  5. Click the log stream name in the Log Stream list to view its details. You will be taken to the Log Stream Details page.
    CategoryDetailed description
    Excel downloadLog stream history can be downloaded as an Excel file
    Timestamp listMessage list by timestamp
    • Period selection, User time zone, can filter using message input
    Table. Log group details - Log stream detail items
    Reference
    When you click the View All Log Streams button at the top of the log stream list, you will be taken to the All Log Stream Details page.

Delete Log Stream

You can delete unused log streams. To delete a log stream, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. On the Log Group List page, click the log group name whose log stream you want to delete. You will be taken to the Log Group Details page.
  4. Log Group Details page, click the Log Stream tab. The log stream list will be displayed.
  5. Select the checkbox of the log stream to delete in the log stream list, then click the More > Delete button. A popup notifying the log stream deletion will open.
    • You can delete multiple log streams simultaneously.
    • You can also delete each individually by clicking the Delete button at the right end of each log stream.
  6. Click the Confirm button. The log stream will be deleted.

Managing Log Patterns

Create Log Pattern

To create a log pattern, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.

  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.

  3. On the Log Group List page, click the log group name for which you want to create a log pattern. You will be taken to the Log Group Details page.

  4. Log Group Details page, click the Log Pattern tab. The log pattern list will be displayed.

  5. Click the Create Log Pattern button. You will be taken to the Create Log Pattern page.

  6. Set the basic information and metric information required to create a log group.

    • In the Basic Information area, enter and select the basic information for the log pattern.
      Category
      Required
      Detailed description
      Log pattern nameRequiredEnter the name of the log pattern
      • using English letters, numbers, and special characters (-_./#) within 3 ~ 512 characters
      Pattern formatRequiredSelect a pattern format or enter manually
      • Pattern format: Choose one of the string pattern, space-delimited pattern, or JSON format pattern provided as pattern formats
      • Direct input: After selecting one of the string pattern, space-delimited pattern, or JSON format pattern, enter a value between 1 ~ 1,024
      Pattern testSelectEnter or select log data to verify using a pattern
      • Direct Input: Enter the log data to be used directly into the Log Event Message
        • Separate log events using line breaks
        • Up to 50 log events can be entered
        • Each log event can be entered within 1 ~ 1,024 bytes
      • Log Data Selection: Choose the log data to use
        • When selecting log data, the corresponding log data is displayed in the Log Event Message
      • Pattern Test: Conduct a test on the log event message
        • If the test succeeds, the test result is displayed at the bottom
      Table. Log Pattern Creation - Basic Information Items
    • Enter and select metric information in the Metric Information area.
      Category
      Required status
      Detailed description
      namespaceRequiredSelect a namespace for the log pattern
      • If there is no namespace for the log pattern, Create New to create one
      • Namespace Name: When creating a new namespace, use English letters, numbers, spaces, and special characters(-_\/#) to enter between 3 ~ 128 characters
      Indicator NameRequiredEnter the name of the indicator
      • using English letters, numbers, and special characters(_) within 3 ~ 128 characters
      indicator valueRequiredEnter the indicator value
      • a number greater than or equal to 0 or $indetifier
      defaultSelectIf you use the default value, enter
      • 0 or greater float value
      • When using the default, dimension cannot be used
      unitRequiredSelect indicator unit
      dimensionSelectionSet the dimension of metrics generated by log patterns
      • Log pattern format is available only when it is a space-delimited pattern or a JSON format pattern
      • Default value cannot be used when entered
      • If Use is checked, you can add custom dimension fields
        • After clicking the Add button, add by entering Field name and Field value
        • You can add up to a maximum of 3
      Table. Log pattern generation - metric information items
  7. After reviewing the summary information, click the Create button. A popup indicating log pattern creation will appear.

  8. Confirm click the button. Log pattern generation is complete.

Check detailed log pattern information

To view detailed information about the log pattern, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. Click the log group name to view detailed information on the Log Group List page. You will be taken to the Log Group Details page.
  4. Log Group Details page, click the Log Pattern tab. The log pattern list will be displayed.
  5. Log pattern Click the log pattern name in the list to view its details. Log pattern details page will open.
    CategoryDetailed description
    Create alert policyAlert policy creation available
    • When the button is clicked, navigate to the alert policy creation page
    Delete log patternDelete the log pattern currently being examined
    Log pattern nameLog pattern name
    constructorUser who created the log pattern
    Creation date and timeLog pattern creation timestamp
    EditorUser who modified the log pattern information
    Modification dateDate and time the log pattern information was modified
    PatternPattern format
    Indicator InformationMetric information of the pattern group
    • Namespace name, metric name, metric value, default value, unit, alarm policy name, dimension name
    • Edit button allows modification of metric value, default value, unit information
    Table. Log pattern detailed items

Delete log pattern

To delete a log pattern, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. On the Log Group List page, click the log group name whose log pattern you want to delete. You will be taken to the Log Group Details page.
  4. On the Log Group Details page, click the Log Pattern tab. The log pattern list will be displayed.
  5. After selecting the checkbox of the log pattern to delete in the log pattern list, click the Delete button. A popup notifying the log pattern deletion will open.
    • You can delete multiple log patterns simultaneously.
    • You can also delete individually by clicking the More > Delete button at the far right of each log pattern, or by clicking the Delete Log Pattern button on the log pattern’s detail page.
  6. Click the Confirm button. The log pattern will be deleted.

Export Log Group

Log group data can be stored in Object Storage. To store log group data in Object Storage, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.

  2. On the Service Home page, click the Log > Log Group Export menu. You will be taken to the Log Group Export List page.

  3. Log Group Export List page, click the Log Group Export button. You will be taken to the Log Group Export page.

    Category
    Required
    Detailed description
    Select log groupRequiredSelect the log group to store in Object Storage
    • If the log group contains log streams, you can click the Select button to choose the log stream to store
    • If no log group is selected, the entire data of the log group will be stored
    Select periodSelectSelect the user time zone and data storage interval
    • In the Time Settings area, you can select the desired interval or click the Enter Manually button to set the start and end date and time
    storage bucketRequiredSelect the bucket to store data
    • Up to 50 tags can be added per resource
    • When adding a tag, entering the Key and Value allows you to select from the list of existing tag Keys and Values
    Table. Log group export items

  4. After selecting the bucket to store the data, click the Complete button. A popup notifying that the data has been saved will open.

  5. In the popup window, click the Confirm button. Data export will begin.

    • You can view the progress on the Log Group Export List page.
Reference
  • If there is no Object Storage to store the log group data, create an Object Storage and then proceed.
  • Exporting log group data may take tens of minutes or more, depending on its size.
  • If there is an ongoing log group export task within the Account, you must first complete the ongoing task before proceeding with the export.
  • On the Log Group Export List page, you can cancel an export operation for a log group that is in progress by clicking the More > Cancel Log Group Export button.

Delete Log Group

You can delete unused log groups.

Caution
  • Log Group Export does not delete files stored in Object Storage. However, the Log Group Export history is deleted together.
  • If you delete a log group while log group export is in progress, the export operation will not complete successfully.

To delete a log group, follow these steps.

  1. Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
  2. On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
  3. On the Log Group List page, select the checkbox of the log group you want to delete, then click the Delete button. A popup notifying the log group deletion will appear.
    • You can delete multiple log groups simultaneously.
    • You can delete individually by clicking the Delete button at the far right of each log group, or by clicking the Delete Log Group button on the Log Group Details page.
  4. Click the Confirm button. The log group will be deleted.
indicator
Event