TiDB Audit Plugin User Guide August 4, 2022 TiDB Audit Plugin User Guide Introduction The TiDB audit plugin records the TiDB server’s activities that are expected to follow auditing regulations of describes how to compile, package, and use the audit plugin. Download the plugin You can download the plugin on TiDB Enterprise Edition Downloads. Deploy the audit plugin After downloading the plugin, you TiUP to deploy the audit plugin. Use TiDB Operator to deploy the plugin Configure TidbCluster CR. tidb: additionalContainers: - command: - sh - -c - touch /var/log/tidb/tidb-audit.log; tail -n0 -F

database auditing and the audit plugin 1 Obtain the database auditing feature 2 The range of database auditing 2 The events of database auditing 3 Recorded information in audit logs 5 General information 6 Audit operation information 7 Audit log filters and rules 7 Filters 8 Filter rules 9 File formats of audit log 10 Rotation of audit log 11 The number and duration for reserving audit logs 11 Audit log redaction 11 System tables 11 mysql.audit_log_filters 11 mysql.audit_log_filter_rules 12 System variables 13 tidb_audit_enabled 13 tidb_audit_log 14 tidb_audit_log_format 14 tidb_au

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 380 6.6.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 380 6.6.3 protection mechanism to avoid panic caused by disk space drainage #10537 – Support archiving and rotating logs #11651 – Reduce the system call by the Raft client and increase CPU efficiency #11309 – Coprocessor BR performs encrypted backup #29794 – TiCDC * Reduce the count of “EventFeed retry rate limited” logs #4006 * Reduce the replication latency when replicating many tables #3900 * Reduce the time for the

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 804 8.6.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 804 8.6.3 default log storage engine Since v6.1.0, TiDB uses Raft Engine as the default storage engine for logs. Compared with RocksDB, Raft Engine can reduce TiKV I/O write traffic by up to 40% and CPU usage by 3.1 or v5.4.0 to v6.0.0 or later versions #12269 • Fix the issue of OOM caused by appending Raft logs when the memory resource is insufficient #11379 • Fix the issue of TiKV panic caused by the race

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 986 8.8.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 986 8.8.3 .pingcap.com/files/2023/09/18204824/TiDB-Database �→ -Auditing-User-Guide1.pdf" target="_blank">Audit log enhancement �→ ( �→ Enterprise user-friendly filter �→ settings, a new file output format in JSON, and lifecycle management �→ of audit logs. 2.2.1 Feature details 2.2.1.1 Performance • Enhance the Partitioned Raft KV storage engine

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1002 8.8.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1002 8.8 issue that TiDB server might consume a significant amount of resources when the enterprise plugin for audit logging is used #49273 @lcwangchao • Fix the issue that the optimizer incorrectly converts TiFlash read #8505 @gengliqi • Fix the issue that short queries executed successfully print excessive info logs #8592 @windtalker • Fix the issue that TiFlash might crash when it is stopped #8550 @guo-shaoge

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 988 8.8.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 989 8.8.3 data to MySQL: TiCDC is a tool for replicating the incremental data of TiDB by pulling TiKV change logs. TiCDC uses the MySQL sink to replicate the incremental data of TiDB to MySQL. Note: This page describes Issues or submit your questions on AskTUG. 3.4.8 What’s next • To check the TiFlash version, critical logs, system tables, see Maintain a TiFlash cluster. • To remove a specific TiFlash node, see Scale out

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1430 8.9.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1430 8.9 supporting multi- disk storage for Raft logs; when the disk where the home directory (dir) is located runs out of space, the Raft Engine automatically writes new logs to spill-dir, ensuring continuous operation stuck if TiKV becomes unresponsive during the backup process #53480 @Leavrth • Fix the issue that BR logs might print sensitive credential information when log backup is enabled #55273 @RidRisR • Fix the

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 961 8.7.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 961 8.7.3 row-level Time to live (TTL) to manage data lifecycle (experimental). • TiCDC supports replicating changed logs to object storage such as Amazon S3, Azure Blob Storage, and NFS (experimental). 2.2.1 New features share subscription • TiCDC supports replicating changed logs to storage sinks (experimental) #6797 @zhaoxinyu TiCDC supports replicating changed logs to Amazon S3, Azure Blob Storage, NFS, and other S3-compatible

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1049 8.9.2 TiFlash critical logs · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1050 8.9 and supports marking user data in TiDB logs with ‹ ›. Based on the marked logs, you can decide whether to redact the marked information when displaying the logs, thus increasing the flexibility of log and supports marking user data in TiDB logs with ‹ ›. Based on the marked logs, you can decide whether to redact the marked information when displaying the logs, thus increasing the flexibility of log