文档中心

日志服务

资源管理

日志主题

日志主题是日志服务进行日志管理的基本单位，日志接入、检索分析、消费等功能都是基于日志主题的粒度进行操作。本文档介绍日志主题的常见管理操作，包括日志主题的创建、修改和删除等。

前提条件

已创建日志项目，详细步骤请参考日志项目。

注意事项

一个日志项目中最多创建 200 个日志主题，如需提高配额，请在配额中心申请提高参数 total_topics_per_project 的配额。

为避免数据因超出分区的读写能力导致写入失败，建议开启分区的自动分裂功能。

创建日志主题

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 日志项目。

在日志项目页面，找到指定的日志项目，并单击项目名称。

在日志主题区域，单击创建日志主题。

在创建日志主题对话框中，完成如下配置。

填写基础配置。

参数	说明
主题名称	日志主题的名称。长度为3-64个字符。只能包含中文、小写字母、数字、下划线_和连字符-。不能以连字符-和下划线_开头/结尾。不能以 tls_、tos_ 以及部分预留字段开头。
记录外网IP	是否开启记录外网 IP 功能。默认为开启状态。开启后日志服务会自动在日志内容中添加以下元数据字段： __tag____client_ip__：日志来源设备的公网 IP 地址。 __tag____receive_time__：日志达到服务端的时间，格式为 10 位的 Unixtime 时间戳。说明通过 WebTracking 方式写入日志时，日志服务通过 clientAddr 记录来源设备的公网 IP 地址。
计费模式	设置该日志主题的计费模式。按功能计费：根据实际使用到的资源（如索引、存储等）及功能（如数据加工、数据投递等）进行计费，按需使用按量付费。按写入数据量计费：对写入数据量（原始大小）进行收费，数据写入后提供30天的免费存储周期，同时可以免费使用数据加工、数据投递等功能。
描述	日志主题的简单描述。
标签	设置日志主题的标签。标签用于云资源的标识与分类，您可以将云资源通过标签进行归类，便于资源的搜索和聚合。详细说明请参考标签概述。继承标签：单击继承日志项目标签，可以继承日志项目标签。添加新标签：单击添加标签，输入标签键和标签值。

配置日志存储时长。

日志服务支持标准存储、低频存储和归档存储。详细说明，请参考存储类型。

注意

超过指定日志存储时长的日志会被自动清除。

参数	说明
标准存储	日志在日志服务标准存储层的存储时长，单位为天，取值范围为 1～3650，指定为 3650 天表示永久存储。开启低频存储时，标准存储时长取值范围为 7～3650。开启低频存储和归档存储时，标准存储时长取值范围为 7～3650。开启归档存储但未开启低频存储时，标准存储时长取值范围为 30～3650。
低频存储	日志在日志服务中低频存储层的存储时长，单位为天，取值范围为 1～3650，指定为 3650 天表示永久存储。开启低频存储后，日志在标准存储层中保存一段时间之后自动转化为低频存储。
归档存储	日志在日志服务中归档存储层的存储时长，单位为天，取值范围为 60～3650，指定为 3650 天表示永久存储。开启归档存储后，日志在标准存储层或低频存储层保存一段时间之后自动转化为归档存储。

填写分区配置。

参数	说明
日志分区数量	日志分区的数量。每个分区提供的写入能力为 5MiB/s、500次/s，读取能力为 20MiB/s、100次/s。创建后暂不支持修改分区数量，但支持通过自动分裂功能提高日志主题的整体读写能力。
自动分裂日志分区	是否开启分区的自动分裂功能。（默认）开启：当写入的数据量连续 5 分钟超过已有分区服务能力时，日志服务会根据数据量自动分裂分区以满足业务需求，但分裂后的分区数量不可超出最大分裂数。最近 15 分钟内分裂出来的新分区不会自动分裂。关闭：不开启分区的自动分裂。
最大分裂数	分区的最大分裂数，即分区分裂后，所有读写状态分区的最大数量。说明仅在开启自动分裂日志分区时需要设置最大分裂数。最大分裂数小于等于日志分区数，无法自动分裂 shard。

填写高级配置。

参数	说明
WebTracking	是否开启 WebTracking 功能，开启后，可以通过 WebTracking 快速采集前端埋点数据。说明为日志主题开启 WebTracking 后，通过 API 接口 WebTracks 写入数据时无需经过鉴权，相当于面向公网开放了匿名写入权限，可能产生脏数据。详细说明请参考使用 WebTracking 采集日志。

单击创建。

修改日志主题配置

您可以通过编辑日志主题的方式，修改主题名称、日志存储时长等配置，也可以在日志主题列表中直接修改日志主题名称和描述等基础配置。日志服务自动为每个日志主题指定 ID，此 ID 不可修改。

说明

暂不支持修改日志分区数量。

开启自动分裂功能时，最大分裂数小于等于日志分区数，无法自动分裂 shard。

进入日志项目的详情页面。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 日志项目。

找到指定的日志项目，单击项目名称。

在日志主题区域，找到指定日志主题，在其操作列选择... > 编辑。

您还可以在日志主题列表中直接修改日志主题名称和描述等。

重新设置日志主题的相关配置。

具体的参数说明，请参考创建日志主题。

单击确定。

修改日志存储时间

进入日志项目的详情页面。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 日志项目。

找到指定的日志项目，单击项目名称。

在日志主题区域，找到指定的日志主题，在其操作列选择... > 编辑。

您可以根据日志主题的名称、ID 或描述快速查找指定的日志主题。

在日志存储时长配置中重新设置日志存储时长。

单击确定。

导入日志主题

日志服务支持跨地域、跨日志项目批量导入指定的日志主题及其索引配置。

进入日志项目的详情页面。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 日志项目。

找到指定的日志项目，单击项目名称。

在日志主题区域，单击导入日志主题。

在日志主题导入任务面板中，完成如下配置，然后单击下一步：执行任务。

参数	说明
源region	选择待导入的日志主题所在地域。
源日志项目	选择待导入的日志主题所在的日志项目。
源日志主题	选择待导入的日志主题，一次最多支持导入 100 个日志主题。选中同时导入索引后，将同时导入源日志主题的索引。

确认日志主题导入任务完成。

确认导入完成后，您可以单击完成，也可以单击继续导入采集规则。导入采集配置的操作请参考导入采集配置。

删除日志主题

注意

删除日志主题之前，请确认已删除所有相关的 LogCollector 采集配置。删除采集配置的具体操作请参考删除采集配置。

部分专属的日志主题（例如服务日志相关的日志主题），不支持删除。

删除日志主题后，其中的所有日志数据及配置信息都会被永久删除，不可恢复，请谨慎操作。

进入日志项目的详情页面。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 日志项目。

找到指定的日志项目，单击项目名称。

在日志主题区域，找到指定日志主题，并在对应的操作列选择... > 删除。

在弹出对话框中确认待删除的日志主题信息，输入要删除的日志主题名称，并单击删除。

对话框中将展示该日志主题所关联的资源。当存在关联的资源时，您可以单击去删除，先删除对应的资源。

查看日志主题使用量

您可以通过日志服务计费项仪表盘查看指定时间范围内指定日志主题的使用量。

进入日志项目的详情页面。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择资源管理 > 日志项目。

找到指定的日志项目，单击项目名称。

在左侧导航栏的日志主题页签下，单击指定日志主题前面的展开按钮，然后单击云监控。

查看当前日志主题相关资源的使用量及变化情况。

最近更新时间：2026.04.23 11:04:46

这个页面对您有帮助吗？

有用

无用