TDSQL-C MySQL 版日志服务 CLS

一、前提条件

使用该功能前，请确保你已开通日志服务 CLS。

二、慢日志字段值说明

字段值	类型	说明
TIMESTAMP	–	CLS 的保留字段，代表日志产⽣时间。
instance_id	String	数据库实例 ID，例如 cynosdbmysql-ins-xxxx。
db_name	String	数据库名。
rows_examined	Long	扫描的行数。
rows_sent	Long	返回的行数。
query_time	Double	执行耗时（单位 s）。
lock_time	Double	锁等待耗时（单位 s）。
user_host	String	客户端信息。
user_name	String	客户端连接数据库实例所使用的用户名。
query_sql	String	慢日志 SQL。

三、开启日志服务（CLS）

1. 在控制台根据实际使用的视图模式进入集群的操作日志页面。

页签视图列表视图1. 登录 TDSQL-C MySQL 版控制台，在左侧集群列表，单击目标集群，进入集群管理页。2. 在集群管理页，选择操作日志页。1. 登录 TDSQL-C MySQL 版，在上方选择地域，找到目标集群，单击集群 ID 或操作列的管理，进入集群管理页。2. 在集群管理页，选择操作日志页。

2. 在操作日志页面，选择需要开启日志投递服务的实例，进行对应操作。

·如需开启慢日志投递，请选择慢日志明细，再单击日志服务 CLS （关）。

·如需开启错误日志投递，请选择错误日志明细，再单击日志服务 CLS （关）。

3. 在开通投递服务弹窗下，单击前往开通，为 TDSQL-C 授权服务角色（如已授权，可跳过步骤3 – 步骤5）。

4. 在跳转的角色管理页面，单击同意授权。

5. 返回开通投递服务弹窗，阅读并勾选《日志服务服务等级协议》，单击开始使用。

6. 单击添加投递日志集，进行日志投递配置。

7. 在弹窗中完成如下配置，单击立即开启。

参数	说明
地域	选择日志集投递的地域。
日志集操作	日志集是对日志主题的分类，方便你管理日志主题。支持选择已有日志集或者创建日志集。
日志集	选择已有日志集：可在搜索框筛选已有的日志集，作为日志投递的归类。创建日志集：可新建日志集作为日志投递的归类，创建日志集的命名格式为 cloud_cynos_自定义_logset，其中自定义部分仅支持英文字母、数字、下划线、短横线。
日志主题操作	日志主题是日志数据进行采集、存储、检索和分析的基本单元。支持选择已有日志主题或者创建日志主题。
日志主题	选择已有日志主题：仅当日志集操作选择已有日志集时，此项可设置。可在搜索框筛选所选日志集下的日志主题。创建日志主题：在所选日志集下创建新的日志主题，创建日志主题的命名格式为 cloud_cynos_自定义_topic，其中自定义部分仅支持英文字母、数字、下划线、短横线。说明：你可对日志主题进行管理，详细请参见管理日志主题。

8. 成功开启日志服务后，你可在日志配置弹窗下看到创建的日志集/日志主题，单击前往 CLS，可跳转至日志服务控制台进行后续分析管理。

注意：说明：

注意：目前，在开启日志服务后进行日志投递时，默认是未开启索引的，而索引配置是使用日志服务（CLS）进行检索分析的必要条件，只有开启索引才能对日志进行检索分析。如需开启索引，请参见索引配置（CLS）。

四、关闭日志服务（CLS）

注意：说明：

注意：关闭后将停止向对应主题投递日志，已投递日志将保留，若需要删除日志，请前往日志服务控制台删除。

1. 参考开启日志服务（CLS）> 步骤1 进入操作日志页面。

2. 在操作日志页面，选择需要关闭日志投递服务的实例，如果需要关闭的是慢日志的日志投递，请单击慢日志明细 > 日志服务 CLS （开），如果需要关闭的是错误日志的日志投递，请单击错误日志明细 > 日志服务 CLS （开）。

3. 在日志配置弹窗下，找到目标日志集/日志主题，单击关闭。

4. 在弹窗下单击确定。

五、日志配置页面功能说明

功能项	说明
开启	对已创建的日志投递配置（关闭状态）进行重新启用，启用后将向 CLS 侧重新投递日志，期间将持续收取日志存储费用。
删除	对已创建的日志投递配置（关闭状态）进行删除，删除投递后历史日志仍持续存储在日志主题中，直至过期，期间将持续收取日志存储费用，若不希望持续存储历史日志可前往日志服务控制台删除日志主题。
添加投递日志集	新建投递日志集，操作步骤参考开启日志服务（CLS）> 步骤6 – 步骤8。

六、相关文档

·日志服务计费概述

·日志集

·管理日志主题

·仪表盘

·数据加工

·检索分析

七、相关 API

API	描述
创建日志投递	本接口（CreateCLSDelivery）用于创建日志投递。
删除日志投递	本接口（DeleteCLSDelivery）用于删除日志投递。
开启日志投递	本接口（StartCLSDelivery）用于开启日志投递功能。
停止日志投递	本接口（StopCLSDelivery）用于停止日志投递功能。

TDSQL-C MySQL 版 日志服务 CLS