文档中心

日志服务

快速入门

创建资源

创建资源

基本日志资源管理主要包含日志项目和日志主题，一个日志项目可以包含多个日志主题。本文介绍在日志服务控制台创建基本日志资源的操作步骤。

前提条件

已创建火山引擎账号，并完成实名认证，具体步骤，请参见账号注册和实名认证。

已获取待采集日志的火山引擎云服务器 ECS，并确保其已安装云助手Agent，且运行状态正常。安装云助手可参考安装云助手客户端。

需确保火山引擎云服务器 ECS 与日志服务所在地域相同。本示例以华北2（北京）地域为例。

创建机器组

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的华北2（北京）地域。

在左侧导航栏中，选择资源管理 > 机器组。

在机器组管理页面，单击创建机器组。

在创建机器组对话框中，完成如下配置，然后单击创建。

参数	示例	说明
机器组名称	Host-group-a	机器组的名称。
机器组类型	IP地址	机器组的类型。
火山 ECS	启用	启用并添加待采集日志的火山 ECS 实例到当前机器组。仅支持添加已安装 ECS 云助手且云助手状态和实例状态均为运行中的 ECS 实例。系统会自动为所选择的 ECS 实例安装 LogCollector。已开始安装 LogCollector 的 ECS 实例不支持停止或解除安装，请谨慎操作。
IP 地址	192.168.0.100	服务器 IP 地址。启用火山 ECS 且实例 LogCollector 安装成功后，系统会自动添加 ECS 的 IP 地址。
LogCollector 服务日志	启用	启用后，LogCollector 客户端在运行过程中会实时记录运行状态和采集进度等信息。
LogCollector 自动升级	/	请在机器组创建完成后，在机器组详情页面的 LogCollector管理页签中开启。
所属项目	default（默认项目）	选择机器组所属的 IAM 项目。支持单击新建项目创建一个新的 IAM 项目。

创建日志项目

机器组创建成功后，在左侧导航栏中，选择资源管理 > 日志项目。

在日志项目页面，单击创建日志项目。

在创建日志项目对话框中，完成如下配置，然后单击创建。

参数	示例	说明
日志项目名称	project-a	日志项目的名称。只能包含中文、小写字母、数字、下划线_和连字符-。
描述	test	日志项目的简单描述。
所属项目	default（默认项目）	选择日志项目所属的 IAM 项目。支持单击新建项目创建一个新的 IAM 项目。
标签	/	设置日志项目的标签，本示例不设置。标签用于资源的标识与分类，可以将日志项目、日志主题通过标签进行归类，便于资源的搜索和资源聚合。

创建日志主题

日志项目创建成功后，在弹窗中单击继续：创建日志主题。

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

填写基本配置。

参数	示例	说明
主题名称	topic-a	日志主题的名称。
记录外网IP	启用	是否启用记录外网 IP 功能。默认为启用状态。启用后会自动在日志内容中添加以下元数据字段： __tag____client_ip__：日志来源设备的公网 IP 地址。 __tag____receive_time__：日志到达服务端的时间，10 位 Unixtime 时间戳。
描述	test	日志主题的简单描述。
标签	/	设置日志主题的标签，本示例不设置。

配置日志存储时长。

注意

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

参数	示例	说明
标准存储	30 天	日志在日志服务标准存储层的存储时长。单位为天，取值范围为 1～3650，指定为 3650 天表示永久存储。开启低频存储时，标准存储时长取值范围为 7～3650。开启低频存储和归档存储时，标准存储时长取值范围为 7～3650。开启归档存储但未开启低频存储时，标准存储时长取值范围为 30～3650。
低频存储	不启用	日志在日志服务中低频存储层的存储时长。单位为天，取值范围为 1～3650，指定为 3650 天表示永久存储。
归档存储	不启用	日志在日志服务中归档存储层的存储时长。单位为天，取值范围为 60～3650，指定为 3650 天表示永久存储。

填写分区配置。

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

填写高级配置。

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

单击创建。

后续操作

采集日志数据

最近更新时间：2025.11.26 17:23:56

这个页面对您有帮助吗？

有用

有用

无用

无用