diff --git a/TOC.md b/TOC.md
index 85716c7f31f3..cd312fcad012 100644
--- a/TOC.md
+++ b/TOC.md
@@ -1069,6 +1069,7 @@
   - [错误码](/error-codes.md)
   - [通过拓扑 label 进行副本调度](/schedule-replicas-by-topology-labels.md)
   - [外部存储服务的 URI 格式](/external-storage-uri.md)
+  - [TiDB Workload Repository](/workload-repository.md)
 - 常见问题解答 (FAQ)
   - [FAQ 汇总](/faq/faq-overview.md)
   - [产品 FAQ](/faq/tidb-faq.md)
diff --git a/sql-statements/sql-statement-admin.md b/sql-statements/sql-statement-admin.md
index baf75922a58b..804aeeb9f908 100644
--- a/sql-statements/sql-statement-admin.md
+++ b/sql-statements/sql-statement-admin.md
@@ -14,6 +14,7 @@ summary: TiDB的 `ADMIN` 语句是用于查看TiDB状态和对表数据进行校
 - [`ADMIN REPAIR TABLE`](#admin-repair-table-语句)
 - [`ADMIN SHOW NEXT_ROW_ID`](#admin-show-next_row_id-语句)
 - [`ADMIN SHOW SLOW`](#admin-show-slow-语句)
+- [`ADMIN CREATE WORKLOAD SNAPSHOT`](#admin-create-workload-snapshot-语句)
 
 ## ADMIN 与 DDL 相关的扩展语句
 
@@ -106,7 +107,17 @@ ADMIN SHOW SLOW RECENT N;
 ADMIN SHOW SLOW TOP [INTERNAL | ALL] N;
 ```
 
-这两种语句的具体操作详情可参考：[admin show slow 语句](/identify-slow-queries.md#admin-show-slow-命令)。
+这两种语句的具体操作详情可参考：[ADMIN SHOW SLOW 语句](/identify-slow-queries.md#admin-show-slow-命令)。
+
+## `ADMIN CREATE WORKLOAD SNAPSHOT` 语句
+
+以下 SQL 语句将在 [Workload Repository](/workload-repository.md) 中触发手动快照：
+
+```sql
+ADMIN CREATE WORKLOAD SNAPSHOT;
+```
+
+注意，必须启用 Workload Repository，此语句才能生效，否则会报错。
 
 ## 语句概览
 
@@ -145,6 +156,7 @@ AdminStmt ::=
         | 'FLUSH' ('SESSION' | 'INSTANCE') 'PLAN_CACHE'
         | 'SET' 'BDR' 'ROLE' ( 'PRIMARY' | 'SECONDARY' )
         | 'UNSET' 'BDR' 'ROLE'
+        | 'CREATE' 'WORKLOAD' 'SNAPSHOT'
     )
 
 NumList ::=
diff --git a/system-variable-reference.md b/system-variable-reference.md
index c9c586dbb612..dee9fcb5d3c6 100644
--- a/system-variable-reference.md
+++ b/system-variable-reference.md
@@ -3898,6 +3898,26 @@ summary: 查看 TiDB 所有的系统变量，以及引用这些变量的文档
 - [SHOW [GLOBAL|SESSION] VARIABLES](/sql-statements/sql-statement-show-variables.md)
 - [系统变量](/system-variables.md#tidb_window_concurrency-从-v40-版本开始引入)
 
+### tidb_workload_repository_dest
+
+- [TiDB Workload Repository](/workload-repository.md#启用-workload-repository)
+- [系统变量](/system-variables.md#tidb_workload_repository_dest-从-v900-版本开始引入)
+
+### tidb_workload_repository_active_sampling_interval
+
+- [TiDB Workload Repository](/workload-repository.md#基于时间的采样过程默认每-5-秒)
+- [系统变量](/system-variables.md#tidb_workload_repository_active_sampling_interval-从-v900-版本开始引入)
+
+### tidb_workload_repository_retention_days
+
+- [TiDB Workload Repository](/workload-repository.md#数据保留)
+- [系统变量](/system-variables.md#tidb_workload_repository_retention_days-从-v900-版本开始引入)
+
+### tidb_workload_repository_snapshot_interval
+
+- [TiDB Workload Repository](/workload-repository.md#快照采样过程默认每小时)
+- [系统变量](/system-variables.md#tidb_workload_repository_snapshot_interval-从-v900-版本开始引入)
+
 ### tiflash_fastscan
 
 引用该变量的文档：
diff --git a/system-variables.md b/system-variables.md
index 23c99388b914..4a796c91c734 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -5339,6 +5339,51 @@ Query OK, 0 rows affected, 1 warning (0.00 sec)
 - 这个变量用于设置 window 算子的并行度。
 - 默认值 `-1` 表示使用 `tidb_executor_concurrency` 的值。
 
+### `tidb_workload_repository_dest` <span class="version-mark">从 v9.0.0 版本开始引入</span>
+
+- 作用域：GLOBAL
+- 是否持久化到集群：是
+- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
+- 类型：字符串
+- 默认值：`''`
+- 该变量用于设置 [Workload Repository](/workload-repository.md) 的目标位置。
+- 可选值为 `'table'`（启用 Workload Repository）或 `''`（禁用 Workload Repository）。
+
+### `tidb_workload_repository_active_sampling_interval` <span class="version-mark">从 v9.0.0 版本开始引入</span>
+
+- 作用域：GLOBAL
+- 是否持久化到集群：是
+- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
+- 类型：整数型
+- 默认值：`5`
+- 范围：`[0, 600]`
+- 单位：秒
+- 用于设置 [Workload Repository](/workload-repository.md) 的基于时间的采样过程的采样间隔。
+- 将该值设置为 `0` 会禁用基于时间的采样过程。
+
+### `tidb_workload_repository_retention_days` <span class="version-mark">从 v9.0.0 版本开始引入</span>
+
+- 作用域：GLOBAL
+- 是否持久化到集群：是
+- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
+- 类型：整数型
+- 默认值：`7`
+- 范围：`[0, 365]`
+- 单位：天
+- 用于设置 [Workload Repository](/workload-repository.md) 数据的保留天数。
+- 将该值设置为 `0` 会禁用旧数据的自动清理。
+
+### `tidb_workload_repository_snapshot_interval` <span class="version-mark">从 v9.0.0 版本开始引入</span>
+
+- 作用域：GLOBAL
+- 是否持久化到集群：是
+- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
+- 类型：整数型
+- 默认值：`3600`
+- 范围：`[900, 7200]`
+- 单位：秒
+- 用于设置 [TiDB Workload Repository](/workload-repository.md) 的快照采样过程的采样间隔。
+
 ### `tiflash_fastscan` <span class="version-mark">从 v6.3.0 版本开始引入</span>
 
 - 作用域：SESSION | GLOBAL
diff --git a/workload-repository.md b/workload-repository.md
new file mode 100644
index 000000000000..1a9147e0cbc8
--- /dev/null
+++ b/workload-repository.md
@@ -0,0 +1,117 @@
+---
+title: TiDB Workload Repository
+summary: 介绍用于收集和存储 TiDB 集群历史工作负载数据的 Workload Repository 系统。
+---
+
+# TiDB Workload Repository
+
+Workload Repository 是一个用于收集和存储 TiDB 集群历史工作负载数据的系统。它会定期采样各种系统表，以跟踪集群的性能和使用模式。
+
+## 启用 Workload Repository 
+
+要启用 Workload Repository，可以设置 [`tidb_workload_repository_dest`](/system-variables.md#tidb_workload_repository_dest-从-v900-版本开始引入) 系统变量：
+
+```sql
+SET GLOBAL tidb_workload_repository_dest = 'table';
+```
+
+要禁用它，执行以下语句：
+
+```sql
+SET GLOBAL tidb_workload_repository_dest = '';
+```
+
+## 数据收集
+
+Workload Repository 将数据存储在 `WORKLOAD_SCHEMA` 数据库下的表中。它通过两种不同的方法收集数据：
+
+- 快照采样过程，按可配置的时间间隔运行，默认为每小时一次，也可以手动触发。
+- 基于时间的采样过程，按较短的时间间隔运行，通常为每 5 秒一次。
+
+## 快照采样过程（默认每小时）
+
+快照采样过程每 15 分钟到 2 小时运行一次（默认每小时），从存储累计指标的内存表中采样数据。快照由指定时间间隔内的某个 TiDB 节点发起，过程如下：
+
+1. 从发起节点向 `WORKLOAD_SCHEMA.HIST_SNAPSHOTS` 表插入一行，记录快照 ID、开始和结束时间戳以及服务器版本信息。
+2. 在每个 TiDB 节点上，将源表中的所有行复制到带有 `HIST_` 前缀的对应目标表中。复制的数据包括源表中的原始列以及用于记录时间戳、实例 ID 和快照 ID 的附加列。
+
+注意，采样表返回的数据内容与查询这些数据的 TiDB 节点相关。
+
+从以下表中采样数据：
+
+| 源表 | 目标表 | 描述 |
+| --- | --- | --- |
+| [`TIDB_INDEX_USAGE`](/information-schema/information-schema-tidb-index-usage.md) | `HIST_TIDB_INDEX_USAGE` | 索引使用统计信息 |
+| [`TIDB_STATEMENTS_STATS`](/statement-summary-tables.md) | `HIST_TIDB_STATEMENTS_STATS` | 语句统计信息 |
+| [`CLIENT_ERRORS_SUMMARY_BY_HOST`](/information-schema/client-errors-summary-by-host.md) | `HIST_CLIENT_ERRORS_SUMMARY_BY_HOST` | 基于主机客户端的错误摘要 |
+| [`CLIENT_ERRORS_SUMMARY_BY_USER`](/information-schema/client-errors-summary-by-user.md) | `HIST_CLIENT_ERRORS_SUMMARY_BY_USER` | 基于用户客户端的错误摘要 |
+| [`CLIENT_ERRORS_SUMMARY_GLOBAL`](/information-schema/client-errors-summary-global.md) | `HIST_CLIENT_ERRORS_SUMMARY_GLOBAL` | 基于全局客户端的错误摘要 |
+
+可以通过 [`tidb_workload_repository_snapshot_interval`](/system-variables.md#tidb_workload_repository_snapshot_interval-从-v900-版本开始引入) 控制快照采样间隔：
+
+```sql
+SET GLOBAL tidb_workload_repository_snapshot_interval = 900; -- 将间隔设置为 15 分钟
+```
+
+## 手动快照
+
+请注意，虽然快照采样过程会根据配置的时间间隔自动运行，但你也可以使用以下 SQL 语句触发手动快照：
+
+```sql
+ADMIN CREATE WORKLOAD SNAPSHOT;
+```
+
+手动快照并不会改变下一次自动快照的发生时间。
+
+## 基于时间的采样过程（默认每 5 秒）
+
+基于时间的采样间隔可设置为 1 秒到 600 秒之间的任意时间，从各个记录瞬时状态的系统表中采样数据。
+
+当基于时间的采样过程运行时，源表中的所有行都会被复制到带有 `HIST_` 前缀的对应目标表中。复制的数据包括源表中的原始列以及用于记录时间戳和实例 ID 的附加列。
+
+与快照采样过程不同，不会向 `HIST_SNAPSHOTS` 表添加行。
+
+注意，采样表返回的数据内容与查询这些数据的 TiDB 节点相关。
+
+从以下表中采样数据：
+
+| 源表 | 目标表 | 描述 |
+| --- | --- | --- |
+| [`PROCESSLIST`](/information-schema/information-schema-processlist.md) | `HIST_PROCESSLIST` | 活跃会话 |
+| [`DATA_LOCK_WAITS`](/information-schema/information-schema-data-lock-waits.md) | `HIST_DATA_LOCK_WAITS` | 数据锁等待 |
+| [`TIDB_TRX`](/information-schema/information-schema-tidb-trx.md) | `HIST_TIDB_TRX` | 活跃事务 |
+| [`MEMORY_USAGE`](/information-schema/information-schema-memory-usage.md) | `HIST_MEMORY_USAGE` | 内存使用情况 |
+| [`DEADLOCKS`](/information-schema/information-schema-deadlocks.md) | `HIST_DEADLOCKS` | 死锁信息 |
+
+可以通过 [`tidb_workload_repository_active_sampling_interval`](/system-variables.md#tidb_workload_repository_active_sampling_interval-从-v900-版本开始引入) 控制基于时间的采样间隔：
+
+```sql
+SET GLOBAL tidb_workload_repository_active_sampling_interval = 20; -- 将间隔设置为 20 秒
+```
+
+把间隔设置为 `0` 将会禁用基于时间的采样。
+
+## 数据保留
+
+系统会根据保留期设置自动清除数据，并使用分区进行高效的数据管理。
+
+默认情况下，Workload Repository 会保留 7 天的历史数据，但你可以通过 [`tidb_workload_repository_retention_days`](/system-variables.md#tidb_workload_repository_retention_days-从-v900-版本开始引入) 变量来控制保留期的长度。例如，要保留 30 天的数据，可以运行以下语句：
+
+```sql
+SET GLOBAL tidb_workload_repository_retention_days = 30;
+```
+
+此变量的值越高，数据保留时间越长，这可能有助于工作负载分析，但会增加存储需求。
+
+## 注意事项
+
+- 启用 Workload Repository 可能会对系统性能产生轻微影响。
+- 采样间隔设置得过短可能会增加系统开销。
+- 将保留天数设置为 `0` 会禁用旧数据的自动清除。
+
+## 最佳实践
+
+- 从默认设置开始，根据你的监控需求进行调整。
+- 根据存储容量设置合理的保留期。
+- 监控 `WORKLOAD_SCHEMA` 数据库的大小。
+- 在生产环境中使用较长的采样间隔以最小化开销。