How-to guides

• 1: Trail Management

1 - Trail Management

The user can check the activity history through the Samsung Cloud Platform Console, and store the corresponding activity history using the Trail service without time constraints. The activity history is kept for 90 days, so to keep it for a long time, you need to create a Trail service and store it in Object Storage.

Trail creation

You can store activity records without any time constraints using the Trail service of Logging&Audit in the Samsung Cloud Platform Console.

To create a Trail, follow the following procedure.

1. All services > Management > Logging&Audit menu is clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list 페이지에서 Create Trail 버튼을 클릭하세요. Create Trail 페이지로 이동합니다.

• Service Information Input area, please enter or select the required information.

  Division	Necessity	Detailed Description
  Trail name	Required	Trail name Use English, numbers, and special characters (-) to enter 5-26 characters
  Target Region	Required	The region where the activity history occurred Services created without specifying a region select the target region as All If a specific region selection is required, select from the region list The target region can be changed after creation
  Target resource type	Required	Resource type of activity history to be stored in Trail Default: All To change to specify only a specific resource type, click the Select button to select the resource type to be stored Refer to the Service-specific resource type list for selectable resource types The target resource type can be changed after creation
  Target User	Required	User of activity history to be saved in Trail Default: All If you want to change to specify only specific users, click the Select button to select the user to save Target user can be changed after creation
  Storage bucket region	Required	Location (region) of the Object Storage bucket to store activity history Storage bucket cannot be changed after creation
  Storage Bucket	Required	Name of the Object Storage bucket to store activity history Storage bucket cannot be changed after creation
  Storage format	Required	File type to be saved (JSON, CSV) Storage format can be changed after creation
  Log file verification	Select	Whether to use log file verification Use is selected, a Digest file is stored in the same bucket to verify the change and deletion of the Trail log file Whether to use log file verification can be changed after creation

  Table. Trail Service Information Input Items
• Additional Information Input area, please enter or select the required information.

  Classification	Necessity	Detailed Description
  Description	Selection	Enter additional information or description about the Trail
  Tag	Selection	Add Tag Up to 50 can be added per resource Click the Add Tag button and enter or select Key, Value

  Table. Additional Information Input Items for Trail

4. Summary panel where you created detailed information and estimated billing amount, and click the Complete button.

• Once creation is complete, check the created resource on the Trail list page.

Trail detailed information check

Trail 서비스는 전체 목록과 상세 정보 확인하고 수정할 수 있습니다. Trail 상세 페이지에서는 상세 정보, 태그, 작업 이력 탭으로 구성되어 있습니다. -> Trail service allows you to view and modify the entire list and detailed information. The Trail detail page consists of detailed information, tags, and work history tabs.

Trail detailed information to confirm, please follow the next procedure.

1. All services > Management > Logging&Audit menu should be clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click on the resource to check the detailed information. It moves to the Trail details page.

• Trail details page displays status information and additional feature information, and consists of details, tags, work history tabs.

  Classification	Detailed Description
  Trail status	status of the Trail created by the user Active: Trail in operation Stopped: Trail operation stopped
  Trail Control	Trail status can be changed with a button Start: Starts a stopped Trail. Activity records will be saved again from the day the Trail was started. Stop: Stops a running Trail. Activity record logging will be stopped, and existing saved activity records will be maintained.
  Trail delete	Button to delete the Trail

  Table. Trail status information and additional features

Detailed Information

Trail list page where you can check the detailed information of the selected resource and modify the information if necessary.

Tag

Trail list page where you can check the tag information of the selected resource, and add, change or delete it.

Work History

Trail list page where you can check the work history of the selected resource.

Trail Resource Control

You can start or stop according to the state of Trail. To control the resources of Trail, follow the following procedure.

Trail Getting Started

You can start the Trail that has been stopped(Stopped). The activity history from the day the Trail was started will be saved again.

1. All services > Management > Logging&Audit menu is clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to restart the suspended Trail. It moves to the Trail details page.
4. Trail details page, click the Start button at the top to start the server. Check the status of the changed Trail in the Status Display item.

• Trail 시작이 완료되면 상태가 Stopped에서 Active로 변경됩니다 becomes: * When the trail starts, the status changes from Stopped to Active.
• For more information about the Trail status, please refer to Check Trail detailed information.

Trail stopping

You can stop the Trail that is (Active) running. It stops recording activity history in the Trail, and the existing saved activity history is maintained.

1. All services > Management > Logging&Audit menu is clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to stop working. It moves to the Trail details page.
4. Trail details page, click the Stop button at the top to stop the server. Check the status of the changed Trail in the Status Display item.

• Trail suspension is completed, then the status changes from Active to Stopped.
• For more information about the Trail status, please refer to Check Trail detailed information.

Trail Resource Management

If you need control and management functions for the generated Trail resources, you can perform tasks on the Trail details page.

Modifying target region

You can modify the target region of Trail. To modify the target region of Trail, follow the following procedure.

1. All services > Management > Logging&Audit menu is clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to change the target region. It moves to the Trail details page.
4. Trail details page, click the target region’s edit button. It moves to the target region edit popup window.
5. Select the target region to change from the region list and click the confirm button. It moves to the Trail detail page.
6. Trail details page where you can check the changed target region.

Modifying target resource types

You can modify the target resource type of Trail. To modify the target resource type of Trail, follow the following procedure.

1. All services > Management > Logging&Audit menu should be clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to change the target resource type. It moves to the Trail details page.
4. Trail details page, click the Edit button of the Target resource type. It moves to the Target resource type edit popup window.
5. Add or change the target resource type to select and check if the selected resource type is displayed in the Selected Items below.

• The selectable resource types are referenced in the service-specific resource type list.

6. If you have completed adding or changing the target resource type, click the Confirm button. It will move to the Trail Details page.
7. Trail details page where you can check the changed target resource type.

Modify target user

You can modify the target users of Trail. To modify the target users of Trail, follow the following procedure.

1. All services > Management > Logging&Audit menu is clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to change the target user. It moves to the Trail details page.
4. Trail details page, click the target user’s edit button. Target user edit popup window opens.
5. Add or change the target user to select and check if the selected user is displayed in the Selected Items below.
6. If you have completed adding or changing the target user, click the Confirm button. It will move to the Trail Detail page.
7. Trail details page where you can check the changed target user.

Modify the storage format

You can modify the log file format stored in the Trail’s bucket. To modify the Trail’s storage format, follow the next procedure.

1. All services > Management > Logging&Audit menu should be clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to change the log file storage format. It moves to the Trail details page.
4. Trail details page, click the edit button of storage format. Edit storage format popup window will open.
5. Change the file format and click the confirm button. It will move to the Trail details page.
6. Trail details page where you can check the changed storage format.

Log file validation modification

You can modify whether to use the log file verification of Trail. To modify whether to use the log file verification of Trail, follow these procedures.

1. All services > Management > Logging&Audit menu should be clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to change the log file storage format. It moves to the Trail details page.
4. Trail details page, click the log file verification edit button. Move to the log file verification edit popup window.
5. Use is selected, it stores the Digest file in the same bucket to verify the change and deletion of the Trail log file. Select whether to use it, and click the OK button. It moves to the Trail details page.
6. Trail details page where you can check the changed storage format.

Trail description modification

You can modify the description of the Trail. To modify the description of the Trail, follow the following procedure.

1. All services > Management > Logging&Audit menu should be clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) to modify the description to be changed. It moves to the Trail details page.
4. Trail details page click the description of the edit button. Description edit popup window opens.
5. Complete the description modification, and click the confirm button. It moves to the Trail detail page.
6. Trail details page where you can check the changed description.

Trail delete

You can delete unused Trails to reduce operating costs. However, deleting a Trail can immediately stop a service that is currently in operation, so you should consider the impact of stopping the service sufficiently before proceeding with the cancellation work.

To delete the Trail, follow the next procedure.

1. All services > Management > Logging&Audit menu is clicked. It moves to the Service Home page of Logging&Audit.
2. Service Home page, click the Trail menu. It moves to the Trail list page.
3. Trail list page, click the resource (Trail) you want to delete. It moves to the Trail details page.
4. Trail details page where you click the Trail delete button.
5. Once the deletion is complete, check if the resource has been deleted on the Trail list page.

Service-specific resource type list

This is a list of resource types by service. When creating a Trail and modifying the target resource type, this is a list of target resource types that can be selected.