Skip to content

Commit e3109f5

Browse files
authored
Merge pull request #24963 from sftim/20201109_fix_flow_control_metrics_merge_wrong_branch
Revert pull request 24905
2 parents a9a7249 + 595850c commit e3109f5

File tree

1 file changed

+15
-22
lines changed

1 file changed

+15
-22
lines changed

content/en/docs/concepts/cluster-administration/flow-control.md

Lines changed: 15 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -331,22 +331,15 @@ PriorityLevelConfigurations.
331331

332332
### Metrics
333333

334-
{{< note >}}
335-
In versions of Kubernetes before v1.20, the labels `flow_schema` and
336-
`priority_level` were inconsistently named `flowSchema` and `priorityLevel`,
337-
respectively. If you're running Kubernetes versions v1.19 and earlier, you
338-
should refer to the documentation for your version.
339-
{{< /note >}}
340-
341334
When you enable the API Priority and Fairness feature, the kube-apiserver
342335
exports additional metrics. Monitoring these can help you determine whether your
343336
configuration is inappropriately throttling important traffic, or find
344337
poorly-behaved workloads that may be harming system health.
345338

346339
* `apiserver_flowcontrol_rejected_requests_total` is a counter vector
347340
(cumulative since server start) of requests that were rejected,
348-
broken down by the labels `flow_schema` (indicating the one that
349-
matched the request), `priority_level` (indicating the one to which
341+
broken down by the labels `flowSchema` (indicating the one that
342+
matched the request), `priorityLevel` (indicating the one to which
350343
the request was assigned), and `reason`. The `reason` label will be
351344
have one of the following values:
352345
* `queue-full`, indicating that too many requests were already
@@ -359,8 +352,8 @@ poorly-behaved workloads that may be harming system health.
359352

360353
* `apiserver_flowcontrol_dispatched_requests_total` is a counter
361354
vector (cumulative since server start) of requests that began
362-
executing, broken down by the labels `flow_schema` (indicating the
363-
one that matched the request) and `priority_level` (indicating the
355+
executing, broken down by the labels `flowSchema` (indicating the
356+
one that matched the request) and `priorityLevel` (indicating the
364357
one to which the request was assigned).
365358

366359
* `apiserver_current_inqueue_requests` is a gauge vector of recent
@@ -391,25 +384,25 @@ poorly-behaved workloads that may be harming system health.
391384

392385
* `apiserver_flowcontrol_current_inqueue_requests` is a gauge vector
393386
holding the instantaneous number of queued (not executing) requests,
394-
broken down by the labels `priority_level` and `flow_schema`.
387+
broken down by the labels `priorityLevel` and `flowSchema`.
395388

396389
* `apiserver_flowcontrol_current_executing_requests` is a gauge vector
397390
holding the instantaneous number of executing (not waiting in a
398-
queue) requests, broken down by the labels `priority_level` and
399-
`flow_schema`.
391+
queue) requests, broken down by the labels `priorityLevel` and
392+
`flowSchema`.
400393

401394
* `apiserver_flowcontrol_priority_level_request_count_samples` is a
402395
histogram vector of observations of the then-current number of
403396
requests broken down by the labels `phase` (which takes on the
404-
values `waiting` and `executing`) and `priority_level`. Each
397+
values `waiting` and `executing`) and `priorityLevel`. Each
405398
histogram gets observations taken periodically, up through the last
406399
activity of the relevant sort. The observations are made at a high
407400
rate.
408401

409402
* `apiserver_flowcontrol_priority_level_request_count_watermarks` is a
410403
histogram vector of high or low water marks of the number of
411404
requests broken down by the labels `phase` (which takes on the
412-
values `waiting` and `executing`) and `priority_level`; the label
405+
values `waiting` and `executing`) and `priorityLevel`; the label
413406
`mark` takes on values `high` and `low`. The water marks are
414407
accumulated over windows bounded by the times when an observation
415408
was added to
@@ -418,7 +411,7 @@ poorly-behaved workloads that may be harming system health.
418411

419412
* `apiserver_flowcontrol_request_queue_length_after_enqueue` is a
420413
histogram vector of queue lengths for the queues, broken down by
421-
the labels `priority_level` and `flow_schema`, as sampled by the
414+
the labels `priorityLevel` and `flowSchema`, as sampled by the
422415
enqueued requests. Each request that gets queued contributes one
423416
sample to its histogram, reporting the length of the queue just
424417
after the request was added. Note that this produces different
@@ -435,12 +428,12 @@ poorly-behaved workloads that may be harming system health.
435428
* `apiserver_flowcontrol_request_concurrency_limit` is a gauge vector
436429
hoding the computed concurrency limit (based on the API server's
437430
total concurrency limit and PriorityLevelConfigurations' concurrency
438-
shares), broken down by the label `priority_level`.
431+
shares), broken down by the label `priorityLevel`.
439432

440433
* `apiserver_flowcontrol_request_wait_duration_seconds` is a histogram
441434
vector of how long requests spent queued, broken down by the labels
442-
`flow_schema` (indicating which one matched the request),
443-
`priority_level` (indicating the one to which the request was
435+
`flowSchema` (indicating which one matched the request),
436+
`priorityLevel` (indicating the one to which the request was
444437
assigned), and `execute` (indicating whether the request started
445438
executing).
446439
{{< note >}}
@@ -452,8 +445,8 @@ poorly-behaved workloads that may be harming system health.
452445

453446
* `apiserver_flowcontrol_request_execution_seconds` is a histogram
454447
vector of how long requests took to actually execute, broken down by
455-
the labels `flow_schema` (indicating which one matched the request)
456-
and `priority_level` (indicating the one to which the request was
448+
the labels `flowSchema` (indicating which one matched the request)
449+
and `priorityLevel` (indicating the one to which the request was
457450
assigned).
458451

459452
### Debug endpoints

0 commit comments

Comments
 (0)