@@ -35,8 +35,8 @@ Some requests classified as "long-running"—such as remote
35
35
command execution or log tailing&mdash ; are not subject to the API
36
36
Priority and Fairness filter. This is also true for the
37
37
` --max-requests-inflight ` flag without the API Priority and Fairness
38
- feature enabled. API Priority and Fairness _ does_ apply to WATCH
39
- requests. When API Priority and Fairness is disabled, WATCH requests
38
+ feature enabled. API Priority and Fairness _ does_ apply to ** watch **
39
+ requests. When API Priority and Fairness is disabled, ** watch ** requests
40
40
are not subject to the ` --max-requests-inflight ` limit.
41
41
{{< /caution >}}
42
42
@@ -102,27 +102,27 @@ The above description of concurrency management is the baseline story.
102
102
In it, all requests have equal "width": each takes up one "seat", one
103
103
unit of concurrency.
104
104
105
- But some requests take up more than one seat. Some of these are LIST
105
+ But some requests take up more than one seat. Some of these are ** list **
106
106
requests that the server estimates will return a large number of
107
107
objects. These have been found to put an exceptionally heavy burden
108
108
on the server, among requests that take a similar amount of time to
109
109
run. For this reason, the server estimates the number of objects that
110
110
will be returned and considers the request to take a number of seats
111
111
that is proportional to that estimated number.
112
112
113
- ### Execution Time Tweaks for WATCH
113
+ ### Execution time tweaks for watch requests
114
114
115
- API Priority and Fairness manages WATCH requests, but this involves a
115
+ API Priority and Fairness manages ** watch ** requests, but this involves a
116
116
couple more excursions from the baseline behavior. The first concerns
117
- how long a WATCH request is considered to occupy its seat. Depending
118
- on request parameters, the response to a WATCH request may or may not
119
- begin with CREATE notifications for all the relevant pre-existing
120
- objects. API Priority and Fairness considers a WATCH request to be
117
+ how long a ** watch ** request is considered to occupy its seat. Depending
118
+ on request parameters, the response to a ** watch ** request may or may not
119
+ begin with ** create ** notifications for all the relevant pre-existing
120
+ objects. API Priority and Fairness considers a ** watch ** request to be
121
121
done with its seat once that initial burst of notifications, if any,
122
122
is over.
123
123
124
124
The normal notifications are sent in a concurrent burst to all
125
- relevant WATCH response streams whenever the server is notified of an
125
+ relevant ** watch ** response streams whenever the server is notified of an
126
126
object create/update/delete. To account for this work, API Priority
127
127
and Fairness considers every write request to spend some additional
128
128
time occupying seats after the actual writing is done. The server
0 commit comments