diff --git a/dashboard/dashboard-faq.md b/dashboard/dashboard-faq.md index 75d982957ab2e..eea8a3143cf19 100644 --- a/dashboard/dashboard-faq.md +++ b/dashboard/dashboard-faq.md @@ -58,3 +58,17 @@ If your deployment tool is TiUP, take the following steps to solve this problem. ### An `invalid connection` error is shown in **Top SQL Statements** and **Recent Slow Queries** on the Overview page The possible reason is that you have enabled the `prepared-plan-cache` feature of TiDB. As an experimental feature, when enabled, `prepared-plan-cache` might not function properly in specific TiDB versions, which could cause this problem in TiDB Dashboard (and other applications). You can disable `prepared-plan-cache` by updating [TiDB Configuration file](/tidb-configuration-file.md#prepared-plan-cache) to solve this problem. + +### An `unknown field` error is shown in **Slow Queries** page + +If the `unknown field` error appears on the Slow Queries page after the cluster upgrade, that is a compatibility issue caused by the difference between TiDB Dashboard server fields (which may be updated) and user preferences fields (which are in the browser cache). This issue has been fixed in v4.0.14/v5.0.3 and later, older versions can be resolved by clearing the browser Local Storage. + +1. Open TiDB Dashboard page + +2. Click **Customize and control Google Chrome** and then select **More Tools > Developer Tools**. + +![Opening DevTools from Chrome's main menu](/media/dashboard/dashboard-faq-devtools.png) + +3. Select the **Application** panel, expand the **Local Storage** menu and select the **TiDB Dashboard page domain**, click the **Clear All** button. + +![Clear the 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 0000000000000..812e672bafd3a 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 0000000000000..db2413d913f5d Binary files /dev/null and b/media/dashboard/dashboard-faq-devtools.png differ