[zh] sync reference/instrumentation/

2022-11-30 09:42:41 +08:00 · 2022-11-30 09:42:41 +08:00 · 8d038bacd2
parent 4af53e7cd0
commit 8d038bacd2
2 changed files with 108 additions and 0 deletions
--- a/content/zh-cn/docs/reference/instrumentation/_index.md
+++ b/content/zh-cn/docs/reference/instrumentation/_index.md
@ -0,0 +1,8 @@
+---
+title: 插桩
+weight: 60
+---
+<!--
+title: Instrumentation
+weight: 60
+-->
--- a/content/zh-cn/docs/reference/instrumentation/node-metrics.md
+++ b/content/zh-cn/docs/reference/instrumentation/node-metrics.md
@ -0,0 +1,100 @@
+---
+title: 节点指标数据
+content_type: reference
+weight: 50
+description: >-
+  访问 kubelet 所观测到的节点、卷、Pod 和容器级别指标的机制。
+---
+<!--
+title: Node metrics data
+content_type: reference
+weight: 50
+description: >-
+  Mechanisms for accessing metrics at node, volume, pod and container level,
+  as seen by the kubelet.
+-->
+
+<!--
+The [kubelet](/docs/reference/command-line-tools-reference/kubelet/)
+gathers metric statistics at the node, volume, pod and container level,
+and emits this information in the
+[Summary API](https://github.com/kubernetes/kubernetes/blob/7d309e0104fedb57280b261e5677d919cb2a0e2d/staging/src/k8s.io/kubelet/pkg/apis/stats/v1alpha1/types.go).
+-->
+[kubelet](/zh-cn/docs/reference/command-line-tools-reference/kubelet/)
+在节点、卷、Pod 和容器级别收集统计信息，并在
+[概要 API](https://github.com/kubernetes/kubernetes/blob/7d309e0104fedb57280b261e5677d919cb2a0e2d/staging/src/k8s.io/kubelet/pkg/apis/stats/v1alpha1/types.go)
+中输出这些信息。
+
+<!--
+You can send a proxied request to the stats summary API via the
+Kubernetes API server.
+
+Here is an example of a Summary API request for a node named `minikube`:
+-->
+你可以通过 Kubernetes API 服务器将代理的请求发送到 stats 概要 API。
+
+下面是一个名为 `minikube` 的节点的概要 API 请求示例：
+
+```shell
+kubectl get --raw "/api/v1/nodes/minikube/proxy/stats/summary"
+```
+
+<!--
+Here is the same API call using `curl`:
+
+# You need to run "kubectl proxy" first
+# Change 8080 to the port that "kubectl proxy" assigns
+-->
+下面是使用 `curl` 所执行的相同 API 调用：
+
+```shell
+# 你需要先运行 "kubectl proxy"
+# 更改 8080 为 "kubectl proxy" 指派的端口
+curl http://localhost:8080/api/v1/nodes/minikube/proxy/stats/summary
+```
+
+{{< note >}}
+<!--
+Beginning with `metrics-server` 0.6.x, `metrics-server` queries the `/metrics/resource`
+kubelet endpoint, and not `/stats/summary`.
+-->
+从 `metrics-server` 0.6.x 开始，`metrics-server` 查询 `/metrics/resource` kubelet 端点，
+不查询 `/stats/summary`。
+{{< /note >}}
+
+<!--
+## Summary metrics API source {#summary-api-source}
+
+By default, Kubernetes fetches node summary metrics data using an embedded
+[cAdvisor](https://github.com/google/cadvisor) that runs within the kubelet.
+
+## Summary API data via CRI {#pod-and-container-stats-from-cri}
+-->
+## 概要指标 API 源  {#summary-api-source}
+
+默认情况下，Kubernetes 使用 kubelet 内运行的嵌入式 [cAdvisor](https://github.com/google/cadvisor)
+获取节点概要指标数据。
+
+## 通过 CRI 获得概要 API 数据  {#pod-and-container-stats-from-cri}
+
+{{< feature-state for_k8s_version="v1.23" state="alpha" >}}
+
+<!--
+If you enable the `PodAndContainerStatsFromCRI`
+[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) in your
+cluster, and you use a container runtime that supports statistics access via
+{{< glossary_tooltip term_id="cri" text="Container Runtime Interface">}} (CRI), then
+the kubelet fetches Pod- and container-level metric data using CRI, and not via cAdvisor.
+-->
+如果你在自己的集群中启用 `PodAndContainerStatsFromCRI`
+[特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)，
+且你通过{{< glossary_tooltip term_id="cri" text="容器运行时接口">}} (CRI) 使用支持统计访问的容器运行时，
+则 kubelet 将使用 CRI 而不是 cAdvisor 来获取 Pod 和容器级别的指标数据。
+
+## {{% heading "whatsnext" %}}
+
+<!--
+The task pages for [Troubleshooting Clusters](/docs/tasks/debug/debug-cluster/) discuss
+how to use a metrics pipeline that rely on these data.
+-->
+[集群故障排查](/zh-cn/docs/tasks/debug/debug-cluster/)任务页面讨论了如何使用依赖这些数据的指标管道。