Merge pull request #36463 from tmalove/auto-defrag-etcd-data-osdocs-2342

[OSDOCS-2342]: Update etcd defragmentation section to include automatic defrag

Author: jeana-redhat

modules/etcd-defrag.adoc

@@ -6,11 +6,40 @@
 [id="etcd-defrag_{context}"]
 = Defragmenting etcd data
 
-Manual defragmentation must be performed periodically to reclaim disk space after etcd history compaction and other events cause disk fragmentation.
+Defragment etcd data to reclaim disk space after events that cause disk fragmentation, such as etcd history compaction.
 
 History compaction is performed automatically every five minutes and leaves gaps in the back-end database. This fragmented space is available for use by etcd, but is not available to the host file system. You must defragment etcd to make this space available to the host file system.
 
-Because etcd writes data to disk, its performance strongly depends on disk performance. Consider defragmenting etcd every month, twice a month, or as needed for your cluster. You can also monitor the `etcd_db_total_size_in_bytes` metric to determine whether defragmentation is necessary.
+Defragmentation occurs automatically, but you can also trigger it manually.
+
+[NOTE]
+====
+Automatic defragmentation is good for most cases, because the etcd operator uses cluster information to determine the most efficient operation for the user.
+====
+
+== Automatic defragmentation
+
+The etcd Operator automatically defragments disks. No manual intervention is needed.
+
+Verify that the defragmentation process is successful by viewing one of these logs:
+
+* etcd logs
+* cluster-etcd-operator pod
+* operator status error log
+
+.Example log output
+[source,terminal]
+----
+I0907 08:43:12.171919       1
+defragcontroller.go:198] etcd member "ip-
+10-0-191-150.us-west-2.compute.internal"
+backend store fragmented: 39.33 %, dbSize:
+349138944
+----
+
+== Manual defragmentation
+
+You can monitor the `etcd_db_total_size_in_bytes` metric to determine whether manual defragmentation is necessary.
 
 [WARNING]
 ====