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.
Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
On the Log Group List page, click the Create Log Group button. You will be taken to the Create Log Group page.
Enter the basic information and tag information required to create a log group.
Division RequiredDetailed Description Log Group Name Required Enter 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 Policy Required Select the period to retain monitored log data Tag Optional Add 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- Enter within 3 to 512 characters using English letters, numbers, and special characters (
After checking the summary information, click the Create button. A popup window will open announcing the log group creation.
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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
Division Detailed Description Log Group Status Status of the log group - Active: Log group is activated
- Inactive: Log group is deactivated
Export Log Group Save log data of the log group to Object Storage - For details on log group export, refer to Exporting Log Group
Delete Log Group Delete the corresponding log group Information Division Tab Information 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 ItemsReferenceOn 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.
When sorting log group names in the log group list, follow the sorting rules below.
- Whitespace and control characters
- Some special characters (
!"#$%&’()*+,-./) - Numbers (
0–9) - Some special characters (
;<=>?@) - English (
A–Z,a–z, case-insensitive) - Remaining special characters (
[\]^_`) - Other characters
Detailed Information
You can view basic information and log group information for the log group selected on the Log Group List page.
| Division | Detailed Description |
|---|---|
| Service | Service name |
| Resource Type | Resource type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource Name | Resource name
|
| Resource ID | Unique resource ID in the service |
| Creator | User who created the service |
| Created Date | Date and time when the service was created |
| Modifier | User who modified the service information |
| Modified Date | Date and time when the service information was modified |
| Log Group Name | Log group name |
| Log Retention Policy | Retention period of log data
|
| Log Data | Total stored log data capacity (bytes) |
Log Streams
You can view log streams for the log group selected on the Log Group List page.
| Division | Detailed Description |
|---|---|
| View All Streams | Can view detailed information for all log streams in the log stream list |
| Create Log Stream | Create a new log stream
|
| Log Stream List | Log stream name and log change date
|
Log Patterns
You can view log patterns for the log group selected on the Log Group List page.
| Division | Detailed Description |
|---|---|
| Log Pattern List | Log pattern name, pattern, log pattern namespace, metric name, alert policy name information
|
| Delete | Delete all selected log patterns from the log pattern list
|
| Create Log Pattern | Create a new log pattern
|
Tags
You can view tag information for the log group selected on the Log Group List page, and add, modify, or delete them.
| Division | Detailed Description |
|---|---|
| Tag List | Key, Value information of tags |
| Edit Tag | Modify or delete existing tag information or add new tags
|
Operation History
You can view the operation history of the log group selected on the Log Group List page.
| Division | Detailed Description |
|---|---|
| Operation History List | Resource change history
|
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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
- On the Log Group Detail page, click the Log Stream tab. The log stream list is displayed.
- Click the Create Log Stream button. The Create Log Stream popup window will open.
- 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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
- On the Log Group Detail page, click the Log Stream tab. The Log Stream list is displayed.
- 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.
Division Detailed Description Excel Download Download log stream history as an Excel file Timestamp List Message list by timestamp - Can filter using Period Selection, User Time Zone, and message input
Table. Log Group Detail - Log Stream Detail ItemsReferenceWhen 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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
- On the Log Group Detail page, click the Log Stream tab. The log stream list is displayed.
- 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.
- Click the Confirm button. The log stream is deleted.
Managing Log Patterns
Creating a Log Pattern
Follow these steps to create a log pattern.
Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
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.
On the Log Group Detail page, click the Log Pattern tab. The log pattern list is displayed.
Click the Create Log Pattern button. You will be taken to the Create Log Pattern page.
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 RequiredDetailed Description Log Pattern Name Required Enter the name of the log pattern - Enter within 3 to 512 characters using English letters, numbers, and special characters (
-_./#)
Pattern Format Required Select 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 Test Optional Directly 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 within 3 to 512 characters using English letters, numbers, and special characters (
- Enter and select metric information in the Metric Information area.
Division RequiredDetailed Description Namespace Required Select 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 Name Required Enter the name of the metric - Enter within 3 to 128 characters using English letters, numbers, and special characters (
_)
Metric Value Required Enter the metric value - Enter a number of 0 or higher or
$indetifier
Default Value Optional Enter if using the default value - Enter as a float value of 0 or higher
- Cannot use Dimension when using default value
Unit Required Select the metric unit Dimension Optional Set 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
- Enter and select basic information for the log pattern in the Basic Information area.
After checking the summary information, click the Create button. A popup window will open announcing the log pattern creation.
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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
- On the Log Group Detail page, click the Log Pattern tab. The log pattern list is displayed.
- 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.
Division Detailed Description Create Alert Policy Can create alert policy - Click the button to go to the alert policy creation page
Delete Log Pattern Delete the log pattern currently being viewed Log Pattern Name Log pattern name Creator User who created the log pattern Created Date Date and time when the log pattern was created Modifier User who modified the log pattern information Modified Date Date and time when the log pattern information was modified Pattern Pattern format Metric Information Metric 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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
- On the Log Group Detail page, click the Log Pattern tab. The log pattern list is displayed.
- 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.
- 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.
Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
On the Service Home page, click the Log > Export Log Group menu. You will be taken to the Export Log Group List page.
On the Export Log Group List page, click the Export Log Group button. You will be taken to the Export Log Group page.
Division RequiredDetailed Description Select Log Group Required Select 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 Period Optional Select 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 Bucket Required Select 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 ItemsAfter selecting the bucket to save the data, click the Done button. A popup window will open announcing the data save.
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.
- 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.
- 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.
- Click the All Services > Management > ServiceWatch menu. You will be taken to the Service Home page.
- On the Service Home page, click the Log > Log Group menu. You will be taken to the Log Group List page.
- 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.
- Click the Confirm button. The log group is deleted.