Help Center/ Log Tank Service/ User Guide/ Log Management/ Managing Log Groups
Updated on 2024-11-14 GMT+08:00
View PDF
Share

Managing Log Groups

A log group is the basic unit for LTS to manage logs. It classifies and consists of log streams, but does not store any log data. Up to 100 log groups can be created for an account.

A log group usually corresponds to a project or business in a company. You are advised to sort log streams of various applications or services within a project or business to the same log group. In this way, project staff only need to monitor log streams in the log group corresponding to their project, without being distracted by log streams of other projects.

LTS allows you to add tags to log groups to help O&M personnel manage services.

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.

    Log Retention Duration

    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. 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 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.
Parent topic: Log Management