日志主题是日志服务进行日志管理的基本单位，日志接入、检索分析、消费等功能都是基于日志主题的粒度进行操作。本文档介绍日志主题的常见管理操作，包括日志主题的创建、修改和删除等。 ## 前提条件已创建日志项目，详细步骤请参考[日志项目](/docs/6470/72005)。 ## 注意事项 * 一个日志项目中最多创建 200 个日志主题，如需提高配额，请在[配额中心](https://console.volcengine.com/quota/productList/coParameterList?ServiceCode=TLS)申请提高参数 `total_topics_per_project` 的配额。 * 为避免数据因超出分区的读写能力导致写入失败，建议开启分区的自动分裂功能。 ## 创建日志主题 1. 登录[日志服务控制台](https://console.volcengine.com/tls)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择**资源管理** \> **日志项目**。 4. 在**日志项目**页面，找到指定的日志项目，并单击项目名称。 5. 在**日志主题**区域，单击**创建日志主题**。 6. 在**创建日志主题**对话框中，完成如下配置。 1. 填写基础配置。 |参数 |说明 | |---|---| |主题名称 |日志主题的名称。 | |记录外网IP |是否开启记录外网 IP 功能。默认为开启状态。开启后日志服务会自动在日志内容中添加以下元数据字段：|\ | ||\ | |* `__tag____client_ip__`：日志来源设备的公网 IP 地址。|\ | |* `__tag____receive_time__`：日志达到服务端的时间，格式为 10 位的 Unixtime 时间戳。|\ | ||\ | |:::tip|\ | |通过 WebTracking 方式写入日志时，日志服务通过 clientAddr 记录来源设备的公网 IP 地址。|\ | ||\ | |:::| |描述 |日志主题的简单描述。 | |标签 |单击**添加标签**，输入标签键和标签值，为日志主题添加标签。|\ | |标签用于云资源的标识与分类，您可以将云资源通过标签进行归类，便于资源的搜索和聚合。详细说明请参考[标签概述](/docs/6470/412530)。 | 2. 配置日志存储时长。日志服务支持标准存储、低频存储和归档存储。详细说明，请参考[存储类型](/docs/6470/1278068)。 :::warning 超过指定日志存储时长的日志会被自动清除。 ::: |参数 |说明 | |---|---| |标准存储 |日志在日志服务标准存储层的存储时长，单位为天，取值范围为 1～3650，指定为 3650 天表示永久存储。|\ | ||\ | |* 开启低频存储时，标准存储时长取值范围为 7～3650。|\ | |* 开启低频存储和归档存储时，标准存储时长取值范围为 7～3650。|\ | |* 开启归档存储但未开启低频存储时，标准存储时长取值范围为 30～3650。 | |低频存储 |日志在日志服务中低频存储层的存储时长，单位为天，取值范围为 1～3650，指定为 3650 天表示永久存储。|\ | |开启低频存储后，日志在标准存储层中保存一段时间之后自动转化为低频存储。 | |归档存储 |日志在日志服务中归档存储层的存储时长，单位为天，取值范围为 60～3650，指定为 3650 天表示永久存储。|\ | |开启归档存储后，日志在标准存储层或低频存储层保存一段时间之后自动转化为归档存储。 | 3. 填写分区配置。 |参数 |说明 | |---|---| |日志分区数量 |日志分区（分区）的数量，取值范围为1～10。每个分区提供的写入能力为 5MiB/s、500次/s，读取能力为 20MiB/s、100次/s。|\ | |创建后暂不支持修改分区数量，但支持通过自动分裂功能提高日志主题的整体读写能力。 | |自动分裂日志分区 |是否开启分区的自动分裂功能。|\ | ||\ | |* （默认）开启：当写入的数据量连续 5 分钟超过已有分区服务能力时，日志服务会根据数据量自动分裂分区以满足业务需求，但分裂后的分区数量不可超出最大分裂数。最近 15 分钟内分裂出来的新分区不会自动分裂。|\ | |* 关闭：不开启分区的自动分裂。 | |最大分裂数 |分区的最大分裂数，即分区分裂后，所有读写状态分区的最大数量。取值范围为 1~256，默认为 256。|\ | |:::tip|\ | ||\ | |* 仅在开启**自动分裂日志分区**时需要设置最大分裂数。|\ | |* **最大分裂数**小于等于日志分区数，无法自动分裂 shard。|\ | ||\ | |:::| 4. 填写高级配置。 |参数 |说明 | |---|---| |WebTracking |是否开启 WebTracking 功能，开启后，可以通过 WebTracking 快速采集前端埋点数据。|\ | |:::tip|\ | |为日志主题开启 WebTracking 后，通过 API 接口 WebTracks 写入数据时无需经过鉴权，相当于面向公网开放了匿名写入权限，可能产生脏数据。详细说明请参考[使用 WebTracking 采集日志](/docs/6470/128972)。|\ | ||\ | |:::| 5. 单击**创建**。 ## 修改日志主题配置您可以通过编辑日志主题的方式，修改主题名称、日志存储时长等配置，也可以在日志主题列表中直接修改日志主题名称和描述等基础配置。日志服务自动为每个日志主题指定 ID，此 ID 不可修改。 :::tip * 暂不支持修改日志分区数量。 * 开启自动分裂功能时，最大分裂数小于等于日志分区数，无法自动分裂 shard。 ::: 1. 进入日志项目的详情页面。 1. 在顶部导航栏中，选择日志服务所在的地域。 2. 在左侧导航栏中，选择**资源管理** \> **日志项目**。 3. 找到指定的日志项目，单击项目名称。 2. 在**日志主题**区域，找到指定日志主题，在其**操作**列选择... \> **编辑**。您还可以在日志主题列表中直接修改日志主题名称和描述等。 3. 重新设置日志主题的相关配置。具体的参数说明，请参考[创建日志主题](/docs/6470/72004#.5Yib5bu65pel5b-X5Li76aKY)。 4. 单击**确定**。 ## 修改日志存储时间 1. 进入日志项目的详情页面。 1. 在顶部导航栏中，选择日志服务所在的地域。 2. 在左侧导航栏中，选择**资源管理** \> **日志项目**。 3. 找到指定的日志项目，单击项目名称。 2. 在**日志主题**区域，找到指定的日志主题，在其**操作**列选择... \> **编辑**。您可以根据日志主题的名称、ID 或描述快速查找指定的日志主题。 3. 在**日志存储时长配置**中重新设置日志存储时长。 4. 单击**确定**。 ## 导入日志主题日志服务支持跨地域、跨日志项目批量导入指定的日志主题及其索引配置。 1. 进入日志项目的详情页面。 1. 在顶部导航栏中，选择日志服务所在的地域。 2. 在左侧导航栏中，选择**资源管理** \> **日志项目**。 3. 找到指定的日志项目，单击项目名称。 2. 在**日志主题**区域，单击**导入日志主题**。 3. 在**日志主题导入任务**面板中，完成如下配置，然后单击**下一步：执行任务**。 |参数 |说明 | |---|---| |源region |选择待导入的日志主题所在地域。 | |源日志项目 |选择待导入的日志主题所在的日志项目。 | |源日志主题 |选择待导入的日志主题，一次最多支持导入 100 个日志主题。|\ | |选中**同时导入索引**后，将同时导入源日志主题的索引。 | 4. 确认日志主题导入任务完成。确认导入完成后，您可以单击**完成**，也可以单击**继续导入采集规则**。导入采集配置的操作请参考[导入采集配置](/docs/6470/93984#f2e7bdda)。 ## 删除日志主题 :::warning * 删除日志主题之前，请确认已删除所有相关的 LogCollector 采集配置。删除采集配置的具体操作请参考[删除采集配置](/docs/6470/93984#%E5%88%A0%E9%99%A4%E9%87%87%E9%9B%86%E9%85%8D%E7%BD%AE)。 * 部分专属的日志主题（例如服务日志相关的日志主题），不支持删除。 * 删除日志主题后，其中的所有日志数据及配置信息都会被永久删除，不可恢复，请谨慎操作。 ::: 1. 进入日志项目的详情页面。 1. 在顶部导航栏中，选择日志服务所在的地域。 2. 在左侧导航栏中，选择**资源管理** \> **日志项目**。 3. 找到指定的日志项目，单击项目名称。 2. 在**日志主题**区域，找到指定日志主题，并在对应的**操作**列选择... \> **删除**。 3. 在弹出对话框中确认待删除的日志主题信息，输入要删除的日志主题名称，并单击**删除**。对话框中将展示该日志主题所关联的资源。当存在关联的资源时，您可以单击**去删除**，先删除对应的资源。 ## 查看日志主题使用量您可以通过**日志服务计费项**仪表盘查看指定时间范围内指定日志主题的使用量。 1. 进入日志项目的详情页面。 1. 在顶部导航栏中，选择日志服务所在的地域。 2. 在左侧导航栏中，选择**资源管理** \> **日志项目**。 3. 找到指定的日志项目，单击项目名称。 2. 在左侧导航栏的**日志主题**页签下，单击指定日志主题前面的展开按钮，然后单击**云监控**。 3. 查看当前日志主题相关资源的使用量及变化情况。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8c9748c008004f2c9215572e740a5f15~tplv-goo7wpa0wc-image.image =1644x)