Polish

Signed-off-by: JaySon-Huang <[email protected]>

Author: JaySon-Huang

tiflash/troubleshoot-tiflash.md

@@ -174,7 +174,7 @@ If TiFlash replicas consistently fail to be created since the TiDB cluster is de
 
     > **Note:**
     >
-    > `max-replicas` is defaulted to 3. In production environments, the value is usually fewer than the number of TiKV nodes. In test environments, the value can be 1.
+    > `count` is defaulted to 3. In production environments, the value is usually fewer than the number of TiKV nodes. In test environments, the value can be 1.
 
     {{< copyable "shell-regular" >}}
 
@@ -194,7 +194,18 @@ If TiFlash replicas consistently fail to be created since the TiDB cluster is de
 
 5. Check whether the remaining disk space percentage on the machine where TiFlash nodes reside is higher than the [`low-space-ratio`](/pd-configuration-file.md#low-space-ratio) value. The default value is 0.8, meaning when a node's used space exceeds 80% of its capacity, PD will avoid migrating Regions to that node to prevent disk space exhaustion. If all TiFlash nodes have insufficient remaining space, PD will stop scheduling new Region peers to TiFlash, causing replicas to remain in an unavailable state (progress < 1).
 
-    - If the disk usage reaches or exceeds `low-space-ratio`, it indicates insufficient disk space. In this case, please delete unnecessary files such as the `space_placeholder_file` under the `${data}/flash/` directory. If necessary, after deleting files, you may temporarily set `storage.reserve-space` to `0MB` in the tiflash-learner.toml configuration file to restore TiFlash service.
+    - If the disk usage reaches or exceeds `low-space-ratio`, it indicates insufficient disk space. In this case, one or more of the following actions can be taken:
+
+        - Modify the value of `low-space-ratio` to allow the PD to resume scheduling Regions to the TiFlash node. 
+
+            ```
+            tiup ctl:nightly pd -u http://${pd-ip}:${pd-port} config set low-space-ratio 0.9
+            ```
+
+        - Scale-out new TiFlash nodes, PD will balance Regions across TiFlash nodes and resumes scheduling Regions to TiFlash nodes with enough disk space.
+
+        - Remove unnecessary files from the TiFlash node disk, such as the `space_placeholder_file` file in the `${data}/flash/` directory. If necessary, set `storage.reserve-space` in tiflash-learner.toml to `0MB` at the same time to temporarily bring TiFlash back into service.
+
     - If the disk usage is below `low-space-ratio`, it indicates normal disk space availability. Proceed to the next step.
 
 6. Check whether there is any `down peer`. Any `down peer` might cause the replication to get stuck.