diff --git a/dashboard/dashboard-faq.md b/dashboard/dashboard-faq.md index 64db8b5d2c74..d3c4039dc765 100644 --- a/dashboard/dashboard-faq.md +++ b/dashboard/dashboard-faq.md @@ -53,3 +53,23 @@ QPS 及 Latency 监控依赖于集群中已正常部署 Prometheus 监控实例 ### 概况页面中 Top SQL 语句、最近慢查询显示 `invalid connection` 错误 可能的原因是你开启了 TiDB 的 `prepared-plan-cache` 功能。`prepared-plan-cache` 是实验性功能,在某些版本的 TiDB 中可能无法正常运行,开启后可能会导致 TiDB Dashboard(及其他应用)出现该问题。可以通过修改 [TiDB 配置文件](/tidb-configuration-file.md#prepared-plan-cache)来关闭 `prepared-plan-cache` 功能。 + +### 慢查询页面显示 `unknown field` 错误 + +集群升级后,如果慢查询页面出现 `unknown field` 错误,是由于升级后新版本 TiDB Dashboard 字段与浏览器缓存内的用户偏好设置的字段不兼容导致的。该问题已修复。如果你的集群版本低于 v5.0.3 或 v4.0.14,可以根据以下步骤进行处理: + +1. 打开 TiDB Dashboard 页面。 + +2. 打开浏览器的开发者工具。各浏览器的打开方式不同。 + + - Firefox:菜单 ➤ Web 开发者 ➤ 切换工具箱(译者注:此处修改为最新的 Firefox Quantum),或者工具栏 ➤ 切换工具箱。 + - Chrome:菜单 ➤ 更多工具 ➤ 开发者工具。 + - Safari:Develop ➤ Show Web Inspector。如果你看不到 Develop 菜单,点开 Preferences ➤ Advanced,然后点击 Show Develop menu in menu bar 复选框。 + + 以 Chrome 为例: + + ![打开开发者工具](/media/dashboard/dashboard-faq-devtools.png) + +3. 选中 **Application** 面板,展开 **Local Storage** 菜单并选中 **TiDB Dashboard 页面的域名**,点击 **Clear All**。 + + ![清理 Local Storage](/media/dashboard/dashboard-faq-devtools-application.png) diff --git a/media/dashboard/dashboard-faq-devtools-application.png b/media/dashboard/dashboard-faq-devtools-application.png new file mode 100644 index 000000000000..812e672bafd3 Binary files /dev/null and b/media/dashboard/dashboard-faq-devtools-application.png differ diff --git a/media/dashboard/dashboard-faq-devtools.png b/media/dashboard/dashboard-faq-devtools.png new file mode 100644 index 000000000000..db2413d913f5 Binary files /dev/null and b/media/dashboard/dashboard-faq-devtools.png differ