Log Groups

Prerequisites

If the IAM users under your account want to use LTS, you need to grant them the permissions required. For details, see Permissions Management.

Creating a Log Group

1. Log in to the LTS console. On the Log Management page, click Create Log Group.
2. In the dialog box displayed, enter a log group name.
   

   • Collected logs are sent to the log group. If there are too many logs to collect, separate logs into different log groups based on log types, and name log groups in an easily identifiable way.
   • The log name can contain 1 to 64 characters, including only letters, digits, hyphens (-), underscores (_), and periods (.). It cannot start with a period or underscore or end with a period.
3. Set Log Retention Duration. You can set it to 1 to 365 days. If this parameter is not specified, logs are retained for 30 days by default.
   

   Currently, logs of whitelisted users can be retained for 1,095 days. If necessary, submit a service ticket. For details, see Submitting a Service Ticket.

   Figure 1 Creating a log group
   

   LTS offers a free quota of 500 MB per month for log read/write, log retention, and log indexing. When the free quota is used up, you will be billed for excess usage on a pay-per-use basis.

4. Set the tag value in the Key=Value format, for example, a=b.
5. Enter remarks. The value contains 0 to 1024 characters.
6. Click OK.
   • In the log group list, you can view information such as the log group name, tags, and log streams.
   • Click the log group name, the details page of one of its log streams is displayed.
   • When multiple log groups are created concurrently, there may be a limit exceeding error.

Modifying a Log Group

You can modify the log name, log retention duration, or remarks of a log group by performing the following steps:

1. In the log group list, locate the target log group and click Modify in the Operation column.
2. Modify the log name and log retention duration on the displayed page.
   Figure 2 Modifying a log group
   
3. Click OK.
4. After the modification is successful, move the cursor over the log group name. The new and original log group names are displayed.
   Figure 3 Log group name
   

Deleting a Log Group

You can delete a log group that is no longer needed. Deleting a log group will also delete the log streams and log data in the log group. Deleted log groups cannot be recovered. Exercise caution when performing the deletion.

If you want to delete a log group that is associated with a log transfer task, delete the task first.

1. In the log group list on the Log Management page, locate the target log group and click Delete in the Operation column.
2. Enter DELETE and click OK.
   Figure 4 Deleting a log group
   

Searching Log Groups/Streams

In the log group list, click the search box and set the following filter criteria:

• Log group/stream
• Original log group/stream name
• Log group name/ID
• Log stream name/ID
• Log group tag
• Remarks

Figure 5 Searching log groups/streams

Other Operations

To view the details of a log group, go to the log group list and click Details in the Operation column of the desired log group, including the log group name, ID, and creation time.

Click next to the search box to download all displayed information about the log group to the local PC.