metrics-server 常见问题解决

2020-05-17 20:54:28 +08:00
parent fe190e6abc
commit a216dcbebe
1 changed files with 93 additions and 0 deletions
--- a/install/faq/metrics-server.md
+++ b/install/faq/metrics-server.md
@ -0,0 +1,93 @@
+---
+description: metrics-server 常见问题
+---
+
+# Metrics server 常见问题
+
+<AdSenseTitle/>
+
+## 问题现象描述
+
+[Metrics server](https://github.com/kubernetes-sigs/metrics-server) 是 Kubernetes 中的一个重要组件，但是却不是内置组件。Kubernetes 许多特性都依赖于 metrics server，
+
+* `kubectl top nodes` / `kubectl top pods` 指令，查看节点/容器组的资源利用率；
+* Kuboard 集群概览页显示节点资源利用率；
+* HPA 水平自动伸缩，依据节点/容器组资源利用率情况自动执行水平伸缩；
+
+
+
+当 metrcis-server 出现异常时，相关依赖组件都会受到影响，例如：
+
+* 执行 kubectl top nodes 指令失败
+
+  ```sh
+  # kubectl top nodes
+  Error from server (ServiceUnavailable): the server is currently unable to handle the request (get nodes.metrics.k8s.io)
+  ```
+
+* Kuboard 不能显示计算资源利用率情况
+
+  ![Kuboard - metrics server](./metrics-server.assets/image-20200517102404143.png)
+
+
+
+## 诊断
+
+### 确认 metrics-server 是否正常运行
+
+在上图截图中，点击 **检查 metrics-server** 按钮，查看 metrics-server 的运行状态，如果 metrics-server 运行不正常，请先解决此问题；
+
+### 确认 ApiService 是否正常
+
+在上图截图中，点击 **检查 ApiService** 按钮，查看 metrics-server 对应的 ApiService 状态，常见的错误如下所示：
+
+```yaml {25-30}
+apiVersion: apiregistration.k8s.io/v1
+kind: APIService
+metadata:
+  annotations:
+  ...
+  creationTimestamp: '2020-04-03T07:18:41Z'
+  name: v1beta1.metrics.k8s.io
+  resourceVersion: '9256'
+  selfLink: /apis/apiregistration.k8s.io/v1/apiservices/v1beta1.metrics.k8s.io
+  uid: edcb1d41-d625-4b0c-bfd9-9049d3e3421e
+spec:
+  group: metrics.k8s.io
+  groupPriorityMinimum: 100
+  insecureSkipTLSVerify: true
+  service:
+    name: metrics-server
+    namespace: kube-system
+    port: 443
+  version: v1beta1
+  versionPriority: 100
+status:
+  conditions:
+    - lastTransitionTime: '2020-04-03T07:18:41Z'
+      message: >-
+        failing or missing response from
+        https://10.96.106.114:443/apis/metrics.k8s.io/v1beta1: Get
+        https://10.96.106.114:443/apis/metrics.k8s.io/v1beta1: net/http: request
+        canceled while waiting for connection (Client.Timeout exceeded while
+        awaiting headers)
+      reason: FailedDiscoveryCheck
+      status: 'False'
+      type: Available
+```
+
+出现这个错误，是因为您的 Kubernetes ApiServer 不能访问到 metrics-server，通常可能是因为如下几类原因：
+* 使用二进制安装方式安装 Kubernetes 集群，但是未在 Master 节点上启用 kube-proxy 组件；
+* master 节点与 metrics-server 所在的 worker 节点之间有防火墙，或者不在同一个安全组；
+
+请根据您集群的实际情况做出对应调整后，在 master 节点上执行如下指令，验证网络连通性：
+``` sh
+# 具体 URL 请从您自己实际得到的消息提示中获得
+curl -ik https://10.96.106.114:443/apis/metrics.k8s.io/v1beta1
+```
+
+在网络连通性问题解决后，通常等待 1 分钟左右，就可以正常执行 `kubectl top nodes` 指令，刷新 Kuboard 主页后，也将能够正常显示节点资源利用率情况。
+
+### 其他问题
+
+如果按照上述步骤未能解决您所碰到的 metrics-server 的问题，请扫本页面后面的二维码，入群后找群主答疑。