一、操作场景
这篇说说如何通过控制台管理日志主题,在实际操作前,建议你阅读 日志主题与日志集,进一步了解相关概念及针对实际场景的使用建议。
二、前提条件
已登录 日志服务控制台。
三、创建日志主题
1. 在左侧导航栏中,选择日志主题。
2. 在日志主题管理页面,选择日志主题的地域,单击创建日志主题。
3. 在弹出的窗口中,填写如下相关信息:
·日志主题名称:例如 nginx,支持1 – 255个字符。
·日志主题 ID:默认自动生成随机 ID,也可自定义 ID。仅支持小写字母、数字和-,且不能以-开头和结尾,长度3至40字符。
·日志保存策略:
·日志接入:默认为标准存储,关于存储类型请参见 存储类型概述。
·存储选项:支持启用永久存储、日志沉降 功能。
·存储时间:默认为30天,可自定义设置日志存储时间,日志过期后将自动清除。使用 LogListener 时,如果日志时间未使用采集时间,而将日志内容中的某个时间字段作为日志时间,将以该时间为准决定日志是否过期。
·日志集操作:
·选择现有日志集:在日志集下拉框中选择目标日志集。
·创建日志集:输入新建的日志集名称,可同时为该日志集设定标签,便于从不同维度对资源分类管理。
·日志主题标签:为当前创建的日志主题设定标签,便于从不同维度对资源分类管理。
·高级设置:
·匿名上传:开启后将支持指定操作匿名上传该日志主题。
·匿名操作:开启匿名上传后,目前支持配置以下操作匿名上传该日志主题:
·JS/HTTP 上传日志:免密通过 JS、HTTP 将日志上传至该日志主题。 详情请参见 匿名日志上传。
·Kafka 协议上传日志:免密通过 Kafka 协议将日志上传至该日志主题。详情请参见 匿名日志上传。
·筛选条件:当开启匿名上传时, 支持仅允许满足特定条件的请求匿名上传该日志主题。当前支持配置以下筛选条件:
VPC_ID:请求的来源 VPC。仅支持腾讯云 VPC,且 VPC 所在地域需与当前日志主题一致。
注意:当前仅 Kafka 协议匿名上传日志支持配置筛选条件。
·记录外网 IP 和日志到达时间:开启后自动添加外网 IP 和日志到达服务端时间作为元数据字段。
·外网 IP:记录日志来源设备的外网 IP 地址,开启开关后,CLS 会自动为采集到的日志数据添加此字段,字段名为__TAG__.client_ip。
·日志到达时间:记录日志到达 CLS 服务端的时间,采用10位 Unix 时间戳格式(秒级精度)。开启开关后,CLS 会自动为采集到的日志数据添加此字段,字段名为__TAG__.receive_time。
·日志主题描述:描述信息,方便后续了解该日志主题用途。
·主题分区:
·初始分区数量:创建主题时自动创建的分区数量,支持1 – 10,默认为1。主题分区说明详见 主题分区。
·自动分裂:是否根据主题写流量大小自动添加分区,默认开启。
·最大分区数量:开启自动分裂时,最大的分区数量,默认50。
4. 单击确定,即可创建日志主题。
日志主题新增成功后,可在日志管理页面单击日志主题 ID/名称,查看日志主题的详情信息。
四、编辑日志主题
1. 在左侧导航栏中,选择日志主题。
2. 在日志主题管理页面,找到你需要编辑的日志主题 ID/名称,在列表右侧单击编辑。
3. 在弹出的窗口中,修改日志主题基本信息。
4. 单击确定,日志主题信息即可完成更新。
五、删除日志主题
1. 在左侧导航栏中,选择日志主题。
2. 在日志主题管理页面,找到你需要删除的日志主题 ID/名称,在列表右侧单击更多,打开操作菜单,选择删除日志主题。
注意:说明:
注意:页面左上角可切换至不同地域分别删除其内的日志主题。如需删除所有的日志主题,建议使用具备全部资源权限的账号进行操作,否则部分日志主题可能由于无权限查看而无法全部删除。
3. 在弹出的窗口中,检查日志主题关联的资源,如果存在数据加工任务、定时 SQL 任务等,请先删除对应资源后单击下一步,再单击删除即可删除当前日志主题。
注意:日志主题一旦删除,主题配置和日志数据不可恢复,请谨慎操作!