X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/b002129afda08bbb4fdbed6e629858a5c298c068..aeaef97c33e37f73dd133dcc098ca6f42a9adde1:/services/keep-balance/usage.go

diff --git a/services/keep-balance/usage.go b/services/keep-balance/usage.go
index eb9990c973..b521c652cc 100644
--- a/services/keep-balance/usage.go
+++ b/services/keep-balance/usage.go
@@ -16,7 +16,9 @@ var exampleConfigFile = []byte(`
 	"KeepServiceTypes": [
 	    "disk"
 	],
-	"RunPeriod": "600s"
+	"RunPeriod": "600s",
+	"CollectionBatchSize": 100000,
+	"CollectionBuffers": 1000
     }`)
 
 func usage() {
@@ -71,6 +73,19 @@ Committing:
     Use the -commit-pull and -commit-trash flags to implement the
     computed changes.
 
+Tuning resource usage:
+
+    CollectionBatchSize limits the number of collections retrieved per
+    API transaction. If this is zero or omitted, page size is
+    determined by the API server's own page size limits (see
+    max_items_per_response and max_index_database_read configs).
+
+    CollectionBuffers sets the size of an internal queue of
+    collections. Higher values use more memory, and improve throughput
+    by allowing keep-balance to fetch the next page of collections
+    while the current page is still being processed. If this is zero
+    or omitted, pages are processed serially.
+
 Limitations:
 
     keep-balance does not attempt to discover whether committed pull