Managing 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 Granting LTS Permissions to IAM Users.

Creating a Log Group

1. Log in to the LTS console.
2. On the Log Management page, click Create Log Group.
3. On the displayed page, set log group parameters by referring to Table 1.

   Table 1 Log group parameters

   Parameter	Description
   Log Group Name	Enter 1 to 64 characters, including only letters, digits, hyphens (-), underscores (_), and periods (.). Do not start with a period or underscore or end with a period. Collected logs are sent to log streams of the corresponding log groups. 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.
   Enterprise Project Name	Select an enterprise project. You can click View Enterprise Projects to view all enterprise projects. Enterprise projects allow you to manage cloud resources and users by project. NOTE: An enterprise project can be used only after it is enabled. For details, see Enabling the Enterprise Project Function. Then, resources of this enterprise project can be removed. For details, see Removing Resources from an Enterprise Project.
   Log Retention (Days)	Specify the log retention duration for the log group, that is, how many days the logs will be stored in LTS after being reported to LTS. By default, logs are retained for 30 days (customizable for 1 to 365 days). LTS periodically deletes logs based on the configured log retention duration. For example, if you set the duration to 30 days, LTS retains the reported logs for 30 days and then deletes them. NOTE: Currently, logs of whitelisted users can be retained for 1,095 days. If necessary, submit a service ticket. Creating log groups is free of charge. You are charged based on the log volume. For details, see Price Calculator.
   Tag	You can tag log groups as required. Click Add Tags, enter a tag key and value, and enable Apply to Log Stream. To add more tags, repeat this step. A maximum of 20 tags can be added. To delete a tag, click Delete in the Operation column of the tag. A tag key can contain up to 128 characters, and a tag value can contain up to 255 characters. A tag key must be unique. If a tag is used by a transfer task, you need to modify the task configuration after deleting the tag. NOTE: If your organization has configured tag policies for LTS, add tags to log groups, log streams, log ingestion rules, and host groups based on the tag policies. If a tag does not comply with the tag policies, the log group, log stream, ingestion rule, and host group creation may fail. Contact your administrator to learn more about tag policies. For details about tag policies, see Overview of a Tag Policy. For details about tag management, see Managing Tags.
   Remark	Enter remarks. The value contains up to 1,024 characters.

4. Click OK. The created log group will be displayed in the log group list.
   • In the log group list, you can view information such as the log group name, tags, and log streams.
   • Click the log group name to access the log stream details page.
   • When multiple log groups are created concurrently, there may be a limit exceeding error.

Modifying a Log Group

You can modify log group settings, such as the group name, log retention duration, or tags as follows:

1. In the log group list on the Log Management page, locate the target log group and click Modify in the Operation column.
2. On the page displayed, modify the group name, log retention duration, and tags on the displayed page.
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.

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. This may lead to exceptions in related tasks. In addition, deleted log groups cannot be restored. Exercise caution when performing this operation.

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 1 Deleting a log group
   

Searching Log Groups/Streams

In the log group list, you can 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

Other Operations

• To check the details of a log group, including the log group name, ID, and creation time, go to the log group list and click More > Details in the Operation column of the desired log group.
• If you have enabled ICAgent diagnosis by referring to Setting ICAgent Collection, you can click More > ICAgent Collect Diagnosis in the Operation column of the target log group to check its ICAgent's exceptions, overall status, and collection monitoring.
• To download all displayed information about a log group to the local PC, click next to the search box.