From 346eea1874ea7c8a5d7ba0ff4df74f06f40676e3 Mon Sep 17 00:00:00 2001
From: Ashley Hardin <ahardin@redhat.com>
Date: Fri, 25 Oct 2019 16:32:17 -0400
Subject: [PATCH] Bug 1748433, added docs for increasing kubelet qps

---
 ...config-crd-to-edit-kubelet-parameters.adoc | 22 +++++++++++++++++++
 .../recommended-host-practices.adoc           |  4 ++--
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc b/modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc
index 8bd7a771cc..041ba9107c 100644
--- a/modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc
+++ b/modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc
@@ -61,6 +61,28 @@ spec:
     maxPods: 500
 ----
 +
+The rate at which the kubelet talks to the API server depends on queries per
+second (QPS) and burst values. The default values, `5` for `kubeAPIQPS` and `10`
+for `kubeAPIBurst`, are good enough if there are limited pods running on each
+node. Updating the kubelet QPS and burst rates is recommended if there are
+enough CPU and memory resources on the node:
++
+[source,yaml]
+----
+apiVersion: machineconfiguration.openshift.io/v1
+kind: KubeletConfig
+metadata:
+  name: set-max-pods
+spec:
+  machineConfigPoolSelector:
+    matchLabels:
+      custom-kubelet: large-pods
+  kubeletConfig:
+    maxPods: <pod_count>
+    kubeAPIBurst: <burst_rate>
+    kubeAPIQPS: <QPS>
+----
++
 .. Run:
 +
 ----
diff --git a/scalability_and_performance/recommended-host-practices.adoc b/scalability_and_performance/recommended-host-practices.adoc
index 580525a0e7..baf9b6df4d 100644
--- a/scalability_and_performance/recommended-host-practices.adoc
+++ b/scalability_and_performance/recommended-host-practices.adoc
@@ -9,10 +9,10 @@ This topic provides recommended host practices for {product-title}.
 
 include::modules/recommended-node-host-practices.adoc[leveloffset=+1]
 
-include::modules/master-node-sizing.adoc[leveloffset=+1]
-
 include::modules/create-a-kubeletconfig-crd-to-edit-kubelet-parameters.adoc[leveloffset=+1]
 
+include::modules/master-node-sizing.adoc[leveloffset=+1]
+
 include::modules/recommended-etcd-practices.adoc[leveloffset=+1]
 
 == Additional resources