TDSQL Boundless 慢日志投递

TDSQL Boundless 提供日志投递功能，通过日志投递，可采集来源为 TDSQL Boundless 实例的慢日志，并投递至日志服务（Cloud Log Service，CLS）进行分析，以便快速监控和定位业务问题。本文为您介绍如何通过控制台开启或关闭日志投递功能。
前提条件
使用该功能前，请确保您已开通 日志服务 CLS。
慢日志定义
字段值
类型
描述
TIMESTAMP
-
CLS 的保留字段，代表日志产生时间。
instance_id
String
数据库实例 ID，例如 tdsql3-xxx。
query_sql
String
执行的 SQL 语句，示例：DROP DATABASE IF EXISTS db1。
user_host
String
执行操作的客户端地址，示例：172...10。
user_name
String
执行操作的用户名，示例：root。
db_name
String
数据库名，示例：mysql。
query_time
Double
SQL 的执行时间，单位：秒。
lock_time
Double
指在执行某个操作过程中，从开始等待锁到实际获得锁并完成操作所花费的总时间，单位：秒。
rows_examined
Long
指在执行查询或操作时，成功解析并处理的行数。
rows_sent
Long
指在执行查询或操作后，实际返回给客户端的行数。
rpc_time
Double
指执行SQL 语句的 RPC 调用时长总和，单位：秒。
tdstore_rpc_time
Double
指执行 SQL 语句过程中，计算与存储之间所有 RPC 通信花费的总时间，单位：秒。
tdstore_lock_time
Double
指执行 SQL 语句过程中，存储因为等锁花费的时间，单位：秒
rpc_cntl_retry_delay_time
Double
指执行 SQL 语句过程中 RPC 重试间隔的等待的总时间，单位：秒。
trace_id
String
执行的 SQL 语句全局标识。
txid
String
执行 SQL 语句所在的事务 ID，一个事务的所有 SQL 的事务 ID 都相同。
bytes_received
Long
执行 SQL 语句过程中，从客户端总接收的数据量，单位：字节。
bytes_sent
Long
执行 SQL 语句过程中，发送给客户端的总数据量，单位：字节。
read_first
Long
读取索引中第一个条目的次数，通常在 MIN() 或索引扫描开始时发生。
read_last
Long
读取索引中最后一个条目的次数，通常在 MAX() 时发生。
read_key
Long
根据索引键值读取行的次数。
read_next
Long
在索引扫描中，按顺序读取下一行数据的次数。
read_prev
Long
在索引扫描中，按逆序读取上一行数据的次数。
read_rnd
Long
根据固定位置读取行的次数，通常在排序后回表查询时发生。
read_rnd_next
Long
在数据文件中顺序读取下一行的次数。
sort_merge_passes
Long
排序时，因内存不足而将中间结果写入磁盘后，进行多路归并的次数。
sort_range_count
Long
对范围查询的结果进行排序的次数。
sort_rows
Long
参与排序的总行数。
sort_scan_count
Long
通过扫描全表进行排序的次数。
created_tmp_disk_tables
Long
查询执行中，创建在磁盘上的临时表的数量。
created_tmp_tables
Long
查询执行中，创建在内存中的临时表的数量。
start
String
查询开始执行的时间戳。
end
String
查询执行结束的时间戳。
rpc_trace
String
指执行 SQL 整个过程中所有 RPC 访问耗时明细，示例：
# [[leader]]
# GetRecord count: 11343 avg: 0.194586 max: 2.153000
# GetRecord node-tdsql3-9684e043-006 count: 11343 avg: 0.194586 max : 2.153000
# GetRegionByKey count: 2 avg: 0.424000 max: 0.442000
...
# [[local_worker1]]
# ScanRecordV2 count: 31899 avg: 1.263289 max: 62.212000
# ScanRecordV2 node-tdsql3-9684e043-007 count: 64 avg: 1.385781 max : 3.917000
# ScanRecordV2 node-tdsql3-9684e043-011 count: 71 avg: 1.283648 max: 2.036000
...
开启慢日志投递
1. 登录 TDSQL Boundless 控制台，在实例列表中，单击实例 ID 或操作列的管理，进入实例管理页面。选择性能优化 > 慢日志投递页签。
2. 在慢日志投递页签，单击立即启用。
﻿
3. 在弹出窗中，完成如下配置，单击立即开启。
﻿
参数
说明
目标地域
选择日志投递的地域。
日志主题操作
日志主题是日志数据进行采集、存储、检索和分析的基本单元。支持选择已有日志主题或者创建日志主题。
日志集操作
日志集是对日志主题的分类，方便您管理日志主题。支持选择已有的日志集或者创建日志集。
日志集
选择已有日志集：可在搜索框筛选已有的日志集，作为慢日志投递的归类。
创建日志集：可新建日志集作为慢日志投递的归类，建议创建日志集的命名格式为 tdstore_logset_自定义。
日志主题
选择已有日志主题：仅当日志主题操作选择已有日志集时，此项可设置。可在搜索框筛选所选日志集下的日志主题。
创建日志主题：在所选日志集下创建新的日志主题，创建日志主题的命名格式为 tdstore_topic_自定义。
4. 成功开启慢日志投递后，您可在日志投递下看到慢日志投递状态为开启，单击日志主题名称，可跳转至 日志服务控制台 进行后续分析管理。
﻿
关闭慢日志投递
1. 登录 TDSQL Boundless 控制台，在实例列表中，单击实例 ID 或操作列的管理，进入实例管理页面。选择性能优化 > 慢日志投递页签。
2. 在慢日志投递页签，单击关闭投递。
3. 在弹出框中，勾选确认关闭，单击确认。
﻿

字段值	类型	描述
TIMESTAMP	-	CLS 的保留字段，代表日志产生时间。
instance_id	String	数据库实例 ID，例如 tdsql3-xxx。
query_sql	String	执行的 SQL 语句，示例：DROP DATABASE IF EXISTS db1。
user_host	String	执行操作的客户端地址，示例：172...10。
user_name	String	执行操作的用户名，示例：root。
db_name	String	数据库名，示例：mysql。
query_time	Double	SQL 的执行时间，单位：秒。
lock_time	Double	指在执行某个操作过程中，从开始等待锁到实际获得锁并完成操作所花费的总时间，单位：秒。
rows_examined	Long	指在执行查询或操作时，成功解析并处理的行数。
rows_sent	Long	指在执行查询或操作后，实际返回给客户端的行数。
rpc_time	Double	指执行SQL 语句的 RPC 调用时长总和，单位：秒。
tdstore_rpc_time	Double	指执行 SQL 语句过程中，计算与存储之间所有 RPC 通信花费的总时间，单位：秒。
tdstore_lock_time	Double	指执行 SQL 语句过程中，存储因为等锁花费的时间，单位：秒
rpc_cntl_retry_delay_time	Double	指执行 SQL 语句过程中 RPC 重试间隔的等待的总时间，单位：秒。
trace_id	String	执行的 SQL 语句全局标识。
txid	String	执行 SQL 语句所在的事务 ID，一个事务的所有 SQL 的事务 ID 都相同。
bytes_received	Long	执行 SQL 语句过程中，从客户端总接收的数据量，单位：字节。
bytes_sent	Long	执行 SQL 语句过程中，发送给客户端的总数据量，单位：字节。
read_first	Long	读取索引中第一个条目的次数，通常在 MIN() 或索引扫描开始时发生。
read_last	Long	读取索引中最后一个条目的次数，通常在 MAX() 时发生。
read_key	Long	根据索引键值读取行的次数。
read_next	Long	在索引扫描中，按顺序读取下一行数据的次数。
read_prev	Long	在索引扫描中，按逆序读取上一行数据的次数。
read_rnd	Long	根据固定位置读取行的次数，通常在排序后回表查询时发生。
read_rnd_next	Long	在数据文件中顺序读取下一行的次数。
sort_merge_passes	Long	排序时，因内存不足而将中间结果写入磁盘后，进行多路归并的次数。
sort_range_count	Long	对范围查询的结果进行排序的次数。
sort_rows	Long	参与排序的总行数。
sort_scan_count	Long	通过扫描全表进行排序的次数。
created_tmp_disk_tables	Long	查询执行中，创建在磁盘上的临时表的数量。
created_tmp_tables	Long	查询执行中，创建在内存中的临时表的数量。
start	String	查询开始执行的时间戳。
end	String	查询执行结束的时间戳。
rpc_trace	String	指执行 SQL 整个过程中所有 RPC 访问耗时明细，示例： # [[leader]] # GetRecord count: 11343 avg: 0.194586 max: 2.153000 # GetRecord node-tdsql3-9684e043-006 count: 11343 avg: 0.194586 max : 2.153000 # GetRegionByKey count: 2 avg: 0.424000 max: 0.442000 ... # [[local_worker1]] # ScanRecordV2 count: 31899 avg: 1.263289 max: 62.212000 # ScanRecordV2 node-tdsql3-9684e043-007 count: 64 avg: 1.385781 max : 3.917000 # ScanRecordV2 node-tdsql3-9684e043-011 count: 71 avg: 1.283648 max: 2.036000 ...

参数	说明
目标地域	选择日志投递的地域。
日志主题操作	日志主题是日志数据进行采集、存储、检索和分析的基本单元。支持选择已有日志主题或者创建日志主题。
日志集操作	日志集是对日志主题的分类，方便您管理日志主题。支持选择已有的日志集或者创建日志集。
日志集	选择已有日志集：可在搜索框筛选已有的日志集，作为慢日志投递的归类。创建日志集：可新建日志集作为慢日志投递的归类，建议创建日志集的命名格式为 tdstore_logset_自定义。
日志主题	选择已有日志主题：仅当日志主题操作选择已有日志集时，此项可设置。可在搜索框筛选所选日志集下的日志主题。创建日志主题：在所选日志集下创建新的日志主题，创建日志主题的命名格式为 `tdstore_topic_自定义`。

慢日志投递

本页目录：

前提条件

慢日志定义

开启慢日志投递

关闭慢日志投递