31483: clarify monitoring language

- Original wording seemed to be tacitly encouraging Prometheus as the
   preferred monitoring solution, and was confusing to non-native
   speakers as written.
 - Remove direct references to Prometheus.
 - Emphasize that the Kubernetes docs are not in the business of telling
   you how to monitor Kubernetes.
 - Note that any monitoring should understand OpenMetrics.
 - Link to the CNCF landscape site, picking out the options for anyone
   who isn't sure what options they have
 - Note that the specific choice is part of the overall design of the
   infrastructure platform.
pull/37462/head
Joe McMahon 2022-10-24 00:57:07 -07:00
parent 1efa1e6a1f
commit 1518132f9c
1 changed files with 10 additions and 3 deletions

View File

@ -57,10 +57,17 @@ respond to these metrics by automatically scaling or adapting the cluster
based on its current state, using mechanisms such as the Horizontal Pod
Autoscaler. The monitoring pipeline fetches metrics from the kubelet and
then exposes them to Kubernetes via an adapter by implementing either the
`custom.metrics.k8s.io` or `external.metrics.k8s.io` API.
`custom.metrics.k8s.io` or `external.metrics.k8s.io` API.
[Prometheus](https://prometheus.io), a CNCF project, can natively monitor Kubernetes, nodes, and Prometheus itself.
Full metrics pipeline projects that are not part of the CNCF are outside the scope of Kubernetes documentation.
Integration of a full metrics pipeline into your Kubernetes implementation is outside
the scope of Kubernetes documentation because of the very wide scope of possible
solutions.
The choice of monitoring platform depends heavily on your needs, budget, and technical resources.
Kubernetes does not recommend any specific metrics pipeline; [many options](https://landscape.cncf.io/card-mode?category=monitoring&project=graduated,incubating,member,no&grouping=category&sort=stars) are available.
Your monitoring system should be capable of handling the [OpenMetrics](https://openmetrics.io/) metrics
transmission standard, and needs to chosen to best fit in to your overall design and deployment of
your infrastructure platform.
## {{% heading "whatsnext" %}}