Question

本文介绍 TiFlash 集群运维的一些常见操作，包括查看 TiFlash 版本，以及 TiFlash 重要日志及系统表。

查看 TiFlash 版本

查看 TiFlash 版本有以下两种方法：

• 假设 TiFlash 的二进制文件名为 tiflash，则可以通过 ./tiflash version 方式获取 TiFlash 版本。

  但是由于 TiFlash 的运行依赖于动态库 libtiflash_proxy.so，因此需要将包含动态库 libtiflash_proxy.so 的目录路径添加到环境变量 LD_LIBRARY_PATH 后，上述命令才能正常执行。

  例如，当 tiflash 和 libtiflash_proxy.so 在同一个目录下时，切换到该目录后，可以通过如下命令查看 TiFlash 版本：

  LD_LIBRARY_PATH=./ ./tiflash version

• 在 TiFlash 日志（日志路径见配置文件 tiflash.toml [logger] 部分）中查看 TiFlash 版本，例如：

  <information>: TiFlash version: TiFlash 0.2.0 master-375035282451103999f3863c691e2fc2

TiFlash 重要日志介绍

为了更好地兼容 TiDB 的日志格式，TiFlash 在 v4.0.5 中修改了原有的日志格式，因此会有两个不同版本的日志。

如果你的 TiDB 集群版本 < 4.0.5：

日志信息	日志含义
[ 23 ] <Information> KVStore: Start to persist [region 47, applied: term 6 index 10]	在 TiFlash 中看到类似日志代表数据开始同步（该日志开头方括号内的数字代表线程号，下同）
[ 30 ] <Debug> CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute()	Handling DAG request，该日志代表 TiFlash 开始处理一个 Coprocessor 请求
[ 30 ] <Debug> CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute()	Handle DAG request done，该日志代表 TiFlash 完成 Coprocessor 请求的处理

如果你的 TiDB 集群版本 >= 4.0.5：

日志信息	日志含义
[INFO][`<unknown>`] ["KVStore: Start to persist [region 47, applied: term 6 index 10]"][thread_id=23]	在 TiFlash 中看到类似日志代表数据开始同步
[DEBUG][`<unknown>`] ["CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute(): Handling DAG request"][thread_id=30]	该日志代表 TiFlash 开始处理一个 Coprocessor 请求
[DEBUG][`<unknown>`] ["CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute(): Handle DAG request done"][thread_id=30]	该日志代表 TiFlash 完成 Coprocessor 请求的处理

你可以找到一个 Coprocessor 请求的开始或结束，然后通过日志前面打印的线程号找到该 Coprocessor 请求的其他相关日志。

TiFlash 系统表

information_schema.tiflash_replica 系统表的列名及含义如下：

列名	含义
TABLE_SCHEMA	数据库名
TABLE_NAME	表名
TABLE_ID	表 ID
REPLICA_COUNT	TiFlash 副本数
AVAILABLE	是否可用（0/1）
PROGRESS	同步进度 [0.0~1.0]