Skip to content

Commit 9beb43a

Browse files
committed
updating etcd manual defragmentation docs
1 parent a01385e commit 9beb43a

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

modules/etcd-defrag.adoc

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,11 +51,16 @@ failed defrag on member: __<member_name>__, memberID: __<member_id>__: __<error_
5151
[id="manual-defrag-etcd-data_{context}"]
5252
== Manual defragmentation
5353

54-
You can monitor the `etcd_db_total_size_in_bytes` metric to determine whether manual defragmentation is necessary.
54+
//You can monitor the `etcd_db_total_size_in_bytes` metric to determine whether manual defragmentation is necessary.
55+
56+
A Prometheus alert indicates when you need to use manual defragmentation. The alert is displayed in two cases:
57+
58+
* When etcd uses more than 50% of its available space for more than 10 minutes
59+
* When etcd is actively using less than 50% of its total database size for more than 10 minutes
5560

5661
[WARNING]
5762
====
58-
Defragmenting etcd is a blocking action. The etcd member will not response until defragmentation is complete. For this reason, wait at least one minute between defragmentation actions on each of the pods to allow the cluster to recover.
63+
Defragmenting etcd is a blocking action. The etcd member will not respond until defragmentation is complete. For this reason, wait at least one minute between defragmentation actions on each of the pods to allow the cluster to recover.
5964
====
6065

6166
Follow this procedure to defragment etcd data on each etcd member.
@@ -182,3 +187,7 @@ memberID:12345678912345678912 alarm:NOSPACE
182187
----
183188
sh-4.4# etcdctl alarm disarm
184189
----
190+
191+
.Next steps
192+
193+
After defragmentation, if etcd still uses more than 50% of its available space, consider increasing the disk quota for etcd.

0 commit comments

Comments
 (0)