The page has been translated by Gen AI.

Logs

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

Creating a Log Group

You can create a log group for metrics. Follow these steps to create a log group.

  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 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.

    Division
    Required
    Detailed Description
    Log Group NameRequiredEnter the name of the log group to monitor in ServiceWatch
    • Enter within 3 to 512 characters using English letters, numbers, and special characters (-_./#)
    Log Retention PolicyRequiredSelect the period to retain monitored log data
    TagOptionalAdd tag information
    • You can add up to 50 tags per resource
    • When adding a tag, after entering Key and Value values, you can select from the list of existing tag Keys and Values
    Table. Create Log Group Items

  5. After checking the summary information, click the Create button. A popup window will open announcing the log group creation.

  6. Click the Confirm button. The log group creation is complete.

Viewing Log Group Detailed Information

You can view and manage detailed information about log groups.

Follow these steps to view detailed information about log groups.

  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 view detailed information. You will be taken to the Log Group Detail page.
    DivisionDetailed Description
    Log Group StatusStatus of the log group
    • Active: Log group is activated
    • Inactive: Log group is deactivated
    Export Log GroupSave log data of the log group to Object Storage
    Delete Log GroupDelete the corresponding log group
    Information Division TabInformation division tabs for the log group
    • Detailed information, Log Streams, Tags, Operation History
    • Click each tab to view the corresponding information
    Table. Log Group Detail Items
    Reference
    On the Log Group List page, you can export data by clicking the More > Export Log Group button of the log group to save to Object Storage.
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

You can view basic information and log group information for the log group selected on the Log Group List page.

DivisionDetailed Description
ServiceService name
Resource TypeResource type
SRNUnique resource ID in Samsung Cloud Platform
  • In ServiceWatch, it means the SRN of the resource type
Resource NameResource name
  • In ServiceWatch, it means the log group name
Resource IDUnique resource ID in the service
CreatorUser who created the service
Created DateDate and time when the service was created
ModifierUser who modified the service information
Modified DateDate and time when the service information was modified
Log Group NameLog group name
Log Retention PolicyRetention period of log data
  • Click the Edit button to change the retention period
Log DataTotal stored log data capacity (bytes)
Table. Log Group Detail - Detailed Information 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 Streams

You can view log streams for the log group selected on the Log Group List page.

DivisionDetailed Description
View All StreamsCan view detailed information for all log streams in the log stream list
Create Log StreamCreate a new log stream
Log Stream ListLog stream name and log change date
  • Click the Delete button to delete that log stream
  • After checking the log stream to delete, click the More > Delete button at the top of the list to delete simultaneously
Table. Log Group Detail - Log Stream Tab Items

Log Patterns

You can view log patterns for the log group selected on the Log Group List page.

DivisionDetailed Description
Log Pattern ListLog pattern name, pattern, log pattern namespace, metric name, alert policy name information
  • Click the log pattern name or alert policy name to go to the detailed page of that item
  • Click the metric name to go to the metrics page containing that metric name in the search term
  • Click the alert policy name to go to the detailed page of that alert policy
  • Click the More button to perform additional tasks
    • Edit, Delete: Edit or delete that log pattern
    • Create Alert Policy: Go to the alert policy creation page
DeleteDelete all selected log patterns from the log pattern list
  • Activated when you check the log pattern in the log pattern list
Create Log PatternCreate a new log pattern
Table. Log Group Detail - Log Pattern Tab Items

Tags

You can view tag information for the log group selected on the Log Group List page, and add, modify, or delete them.

DivisionDetailed Description
Tag ListKey, Value information of tags
Edit TagModify or delete existing tag information or add new tags
  • You can add up to 50 tags per resource
  • When adding a tag, after entering Key and Value values, you can select from the list of existing tag Keys and Values
Table. Log Group Detail - Tags Tab Items

Operation History

You can view the operation history of the log group selected on the Log Group List page.

DivisionDetailed Description
Operation History ListResource change history
  • Can view operation details, operation date, resource type, resource name, operation result, operator information
    • Click the Settings button to change information items
  • Can filter using Period Selection, User Time Zone, operator information input, Detailed Search
  • When you click the operation details in the Operation History List, you will be taken to the Activity History Detail page for that operation
Table. Log Group Detail - Operation History Tab Items

Managing Log Streams

You can create and manage log streams.

Creating a Log Stream

You can create a new log stream in a log group. Follow these steps to create a log stream.

  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 Detail page.
  4. On the Log Group Detail page, click the Log Stream tab. The log stream list is displayed.
  5. Click the Create Log Stream button. The Create Log Stream popup window will open.
  6. After entering the Log Stream Name, click the Create button. The log stream creation is complete.
    • Enter the name within 3 to 512 characters using English letters and numbers.

Viewing Log Stream Detailed Information

You can view and manage detailed information about log streams. Follow these steps to view detailed information about log streams.

  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 view detailed information. You will be taken to the Log Group Detail page.
  4. On the Log Group Detail page, click the Log Stream tab. The Log Stream list is displayed.
  5. On the Log Stream list, click the log stream name for which you want to view detailed information. You will be taken to the Log Stream Detail page.
    DivisionDetailed Description
    Excel DownloadDownload log stream history as an Excel file
    Timestamp ListMessage list by timestamp
    • Can filter using Period Selection, User Time Zone, and message input
    Table. Log Group Detail - 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 Streams Detail page.

Deleting a Log Stream

You can delete unused log streams. Follow these steps to delete a log stream.

  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 delete a log stream. You will be taken to the Log Group Detail page.
  4. On the Log Group Detail page, click the Log Stream tab. The log stream list is displayed.
  5. On the log stream list, select the checkbox of the log stream to delete and click the More > Delete button. A popup window will open announcing the log stream deletion.
    • You can delete multiple log streams at the same time.
    • You can also delete individually by clicking the Delete button at the right end of each log stream.
  6. Click the Confirm button. The log stream is deleted.

Managing Log Patterns

Creating a Log Pattern

Follow these steps to create a log pattern.

  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 Detail page.

  4. On the Log Group Detail page, click the Log Pattern tab. The log pattern list is 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.

    • Enter and select basic information for the log pattern in the Basic Information area.
      Division
      Required
      Detailed Description
      Log Pattern NameRequiredEnter the name of the log pattern
      • Enter within 3 to 512 characters using English letters, numbers, and special characters (-_./#)
      Pattern FormatRequiredSelect or directly enter the pattern format
      • Pattern Format: Select one of string pattern, space-separated pattern, JSON format pattern provided as pattern format
      • Direct Input: After selecting one of string pattern, space-separated pattern, JSON format pattern, enter within 1 to 1,024
      Pattern TestOptionalDirectly enter or select log data to verify using the pattern
      • Direct Input: Directly enter the log data to use in Log Event Message
        • Separate log events using line breaks
        • Can enter up to 50 log events
        • Can enter within 1 to 1,024 bytes for one log event
      • Select log data: Select the log data to use
        • When selecting log data, the corresponding log data is displayed in Log Event Message
      • Test Pattern: Perform test on log event message
        • When test succeeds, test result is displayed at the bottom
      Table. Create Log Pattern - Basic Information Items
    • Enter and select metric information in the Metric Information area.
      Division
      Required
      Detailed Description
      NamespaceRequiredSelect the namespace for the log pattern
      • If there is no namespace for the log pattern, select Create New to create a new one
      • Namespace Name: When creating a new namespace, enter within 3 to 128 characters using English letters, numbers, spaces, and special characters (-_\/#)
      Metric NameRequiredEnter the name of the metric
      • Enter within 3 to 128 characters using English letters, numbers, and special characters (_)
      Metric ValueRequiredEnter the metric value
      • Enter a number of 0 or higher or $indetifier
      Default ValueOptionalEnter if using the default value
      • Enter as a float value of 0 or higher
      • Cannot use Dimension when using default value
      UnitRequiredSelect the metric unit
      DimensionOptionalSet the dimension of the metric created by the log pattern
      • Can be used only when Log Pattern Format is space-separated pattern or JSON format pattern
      • Cannot be used when entering Default Value
      • When you check Use, you can add custom dimension fields
        • After clicking the Add button, enter Field Name and Field Value to add
        • Can add up to 3
      Table. Create Log Pattern - Metric Information Items
  7. After checking the summary information, click the Create button. A popup window will open announcing the log pattern creation.

  8. Click the Confirm button. The log pattern creation is complete.

Viewing Log Pattern Detailed Information

Follow these steps to view detailed information about a log pattern.

  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 view detailed information. You will be taken to the Log Group Detail page.
  4. On the Log Group Detail page, click the Log Pattern tab. The log pattern list is displayed.
  5. On the Log Pattern list, click the log pattern name for which you want to view detailed information. You will be taken to the Log Pattern Detail page.
    DivisionDetailed Description
    Create Alert PolicyCan create alert policy
    • Click the button to go to the alert policy creation page
    Delete Log PatternDelete the log pattern currently being viewed
    Log Pattern NameLog pattern name
    CreatorUser who created the log pattern
    Created DateDate and time when the log pattern was created
    ModifierUser who modified the log pattern information
    Modified DateDate and time when the log pattern information was modified
    PatternPattern format
    Metric InformationMetric information of the pattern group
    • Namespace name, metric name, metric value, default value, unit, alert policy name, dimension name
    • Click the Edit button to modify Metric Value, Default Value, Unit information
    Table. Log Pattern Detail Items

Deleting a Log Pattern

Follow these steps to delete a log pattern.

  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 delete a log pattern. You will be taken to the Log Group Detail page.
  4. On the Log Group Detail page, click the Log Pattern tab. The log pattern list is displayed.
  5. On the log pattern list, select the checkbox of the log pattern to delete and click the Delete button. A popup window will open announcing the log pattern deletion.
    • You can delete multiple log patterns at the same time.
    • You can also delete individually by clicking the More > Delete button at the right end of each log pattern or by clicking the Delete Log Pattern button on the log pattern detail page.
  6. Click the Confirm button. The log pattern is deleted.

Exporting Log Group

You can save log group data to Object Storage. Follow these steps to save log group data to Object Storage.

  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 > Export Log Group menu. You will be taken to the Export Log Group List page.

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

    Division
    Required
    Detailed Description
    Select Log GroupRequiredSelect the log group to save to Object Storage
    • If there are log streams included in the log group, click the Select button to select the log streams to save
    • If you do not select a log group, all data of the log group is saved
    Select PeriodOptionalSelect the user time zone and data storage interval
    • For the data storage interval, you can select the desired interval in the Time Setting area or click the Direct Input button to set the start and end date and time
    Storage BucketRequiredSelect the bucket to save data
    • You can add up to 50 tags per resource
    • When adding a tag, after entering Key and Value values, you can select from the list of existing tag Keys and Values
    Table. Export Log Group Items

  4. After selecting the bucket to save the data, click the Done button. A popup window will open announcing the data save.

  5. Click the Confirm button in the popup window. The data export will start.

    • You can check the progress on the Export Log Group List page.
Reference
  • If there is no Object Storage to save log group data, create Object Storage and proceed.
  • Log group data export may take more than tens of minutes depending on the scale.
  • If there is a log group export task in progress within the Account, you must complete the task in progress first before proceeding with the export.
  • On the Export Log Group List page, you can cancel the task by clicking the More > Cancel Log Group Export button of the log group for which the export task is in progress.

Deleting a Log Group

You can delete unused log groups.

Warning
  • Files saved to Object Storage through Export Log Group are not deleted. However, the log group export history is deleted together.
  • If you delete a log group for which Export Log Group is in progress, the export task will not proceed normally.
Follow these steps to delete a log group.

  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 to delete and click the Delete button. A popup window will open announcing the log group deletion.
    • You can delete multiple log groups at the same time.
    • You can also delete individually by clicking the Delete button at the right end of each log group or by clicking the Delete Log Group button on the corresponding Log Group Detail page.
  4. Click the Confirm button. The log group is deleted.
Metric
Events