加载中

快速入门：使用 Elastic Agent 监控您的 Kubernetes 集群

在本快速入门指南中，你将学习如何通过单个命令在 Kubernetes 集群中下载、安装和配置 Elastic Agent，从而创建监控集群基础架构所需的 Kubernetes 资源。

提示

我们建议使用 OpenTelemetry 的 Elastic 发行版 (EDOT) 收集器作为使用 OpenTelemetry 收集 Kubernetes 日志、指标和应用程序追踪的首选方式。

注意

在 Elastic Stack 9.0 和 9.1 版本中，快速入门使用 Kubectl 在 Kubernetes 集群中安装 Elastic Agent。不过，这些版本也支持使用 Helm chart，这现在是在 Kubernetes 上安装 Elastic Agent 的首选方法。如果你的集群版本是 9.0 或 9.1，我们建议你按照 使用 Helm 在 Kubernetes 上安装 Elastic Agent 指南来部署 Elastic Agent。

先决条件

  • 一个 Elastic Observability Serverless 项目。要了解更多信息，请参阅 创建 Observability 项目。
  • 具有 Admin 角色或更高权限的用户（接入系统日志和指标所必需）。要了解更多信息，请参阅 分配用户角色和权限。
  • 具有互联网访问权限的运行中的 Kubernetes 集群
  • Helm 3.9+ 版本至 3.21.0 版本（含 3.21.0）。
  • 具有互联网访问权限的正在运行的 Elastic Stack 部署，可以是自行托管的，也可以是由 Elastic Cloud Hosted、Elastic Cloud Enterprise 或 Elastic Cloud on Kubernetes 等平台编排的。如果你还没有 Elastic 部署，可以开始免费试用。
  • 具有 superuser 内置角色或接入数据所需权限的用户。
展开以查看所需权限
  • Cluster: ['monitor', 'manage_own_api_key']
  • Index: { names: ['logs-*-*', 'metrics-*-*'], privileges: ['auto_configure', 'create_doc'] }
  • Kibana: { spaces: ['*'], feature: { fleet: ['all'], fleetv2: ['all'] } }
  • 具有互联网访问权限的运行中的 Kubernetes 集群
  • Helm 3.9+ 版本至 3.21.0 版本（含 3.21.0）。
  • 具有互联网访问权限的正在运行的 Elastic Stack 部署，可以是自行托管的，也可以是由 Elastic Cloud Hosted、Elastic Cloud Enterprise 或 Elastic Cloud on Kubernetes 等平台编排的。如果你还没有 Elastic 部署，可以开始免费试用。
  • 具有 superuser 内置角色或接入数据所需权限的用户。
展开以查看所需权限
  • Cluster: ['monitor', 'manage_own_api_key']
  • Index: { names: ['logs-*-*', 'metrics-*-*'], privileges: ['auto_configure', 'create_doc'] }
  • Kibana: { spaces: ['*'], feature: { fleet: ['all'], fleetv2: ['all'] } }
  • 具有互联网访问权限的运行中的 Kubernetes 集群
  • Kubectl 或 Helm 3.9+ 版本至 3.21.0 版本（含 3.21.0）

快速入门期间由 UI 提供的安装命令不能直接用于在受限网络环境中安装 Elastic Agent。对于配有自行托管的 Elastic Stack 部署或诸如 Elastic Cloud on Kubernetes 等编排器的受限网络环境，请参考以下资源

收集你的数据

  1. 转到你的 Elastic Observability Serverless 项目，然后转到 Add data。

  2. 在 What do you want to monitor? 部分，选择 Kubernetes，然后选择 Elastic Agent: Logs & Metrics。

  3. 要在你的主机上安装 Elastic Agent，请复制并运行安装命令。

    通过运行此命令，你将使用 Helm 包管理器来安装和配置 Elastic Agent Helm chart 的一个实例，其中包含特定于部署的附加数据，例如由 Kibana 为当前用户生成的 API 密钥。

    该 Helm chart 还包含 kube-state-metrics (KSM) 的默认安装，这是 Kubernetes 集成收集集群级指标所必需的。

    如果在安装过程中遇到错误，请参考 故障排查。

    关于安装命令的详细信息

    UI 提供的安装命令可能类似于

    helm repo add elastic https://helm.elastic.co/ && helm install elastic-agent elastic/elastic-agent --version 9.4.4 -n kube-system --set outputs.default.url=https:<elasticsearch-url>:443 --set kubernetes.onboardingID=<internal-id> --set kubernetes.enabled=true --set outputs.default.type=ESPlainAuthAPI --set outputs.default.api_key=$(echo "<api-key>" | base64 -d)

    其中

    • elastic-agent 是 Helm chart 具体安装的名称，称为 release name。

    • elastic/elastic-agent 定义了要安装的 chart 名称，使用 <repository>/<chart-name> 格式。

    • 9.4.4 是要安装的 Elastic Agent Helm chart 版本。

    • kube-system 是要安装 Elastic Agent 的命名空间。

    • --set 参数添加了特定于 serverless 项目、当前用户以及 Helm chart 部署方法的配置值。

      有关所用配置选项的更详细解释，请参阅 使用 Helm 在 Kubernetes 上安装独立 Elastic Agent。

  4. 返回 Kibana 中的 Kubernetes: Logs & Metrics 页面。

    数据被引入之前可能会有短暂的延迟。准备就绪后，你将看到消息 We are monitoring your cluster。

  5. 点击 Explore Kubernetes cluster 以导航到仪表板并探索你的数据。

  1. 在 Kibana 中，转到 Observability 概览页面，然后点击 Add Data。

  2. 在 What do you want to monitor? 部分，选择 Kubernetes，然后选择 Elastic Agent: Logs & Metrics。

  3. 要在你的主机上安装 Elastic Agent，请复制并运行安装命令。

    通过运行此命令，你将使用 Helm 包管理器来安装和配置 Elastic Agent Helm chart 的一个实例，其中包含特定于部署的附加数据，例如由 Kibana 为当前用户生成的 API 密钥。

    该 Helm chart 还包含 kube-state-metrics (KSM) 的默认安装，这是 Kubernetes 集成收集集群级指标所必需的。

    如果在安装过程中遇到错误，请参考 故障排查。

    关于安装命令的详细信息

    UI 提供的安装命令可能类似于

    helm repo add elastic https://helm.elastic.co/ && helm install elastic-agent elastic/elastic-agent --version 9.4.4 -n kube-system --set outputs.default.url=https:<elasticsearch-url>:443 --set kubernetes.onboardingID=<internal-id> --set kubernetes.enabled=true --set outputs.default.type=ESPlainAuthAPI --set outputs.default.api_key=$(echo "<api-key>" | base64 -d)

    其中

    • elastic-agent 是 Helm chart 具体安装的名称，称为 release name。

    • elastic/elastic-agent 定义了要安装的 chart 名称，使用 <repository>/<chart-name> 格式。

    • 9.4.4 是要安装的 Elastic Agent Helm chart 版本。

    • kube-system 是要安装 Elastic Agent 的命名空间。

    • --set 参数添加了特定于 serverless 项目、当前用户以及 Helm chart 部署方法的配置值。

      有关所用配置选项的更详细解释，请参阅 使用 Helm 在 Kubernetes 上安装独立 Elastic Agent。

  4. 返回 Kibana 中的 Kubernetes: Logs & Metrics 页面。

    数据被引入之前可能会有短暂的延迟。准备就绪后，你将看到消息 We are monitoring your cluster。

  5. 点击 Explore Kubernetes cluster 以导航到仪表板并探索你的数据。

  1. 在 Kibana 中，转到 Observability UI 并点击 Add Data。

  2. 在 What do you want to monitor? 部分，选择 Kubernetes，然后选择 Elastic Agent: Logs & Metrics。

  3. 要在你的主机上安装 Elastic Agent，请复制并运行安装命令。

    通过运行此命令，你将使用 kubectl kustomize 下载清单文件，注入特定于部署的数据（例如由 Kibana 为当前用户生成的 API 密钥），并为 Elastic Agent 创建 Kubernetes 资源。

  4. 返回 Kibana 中的 Kubernetes: Logs & Metrics 页面。

    数据被引入之前可能会有短暂的延迟。准备就绪后，你将看到消息 We are monitoring your cluster。

  5. 点击 Explore Kubernetes cluster 以导航到仪表板并探索你的数据。

可视化你的数据

安装完成后，所有相关数据开始流入 Elastic，Visualize your data 部分允许你访问可用于监控集群健康状况的 Kubernetes Cluster Overview 仪表板。

Kubernetes overview dashboard

此外，你还可以访问其他用于监控 Kubernetes 资源的有用预构建仪表板，例如每个命名空间的运行 Pod 及其消耗的资源（如 CPU 和内存）。

有关其他有用功能的描述，请参阅 Observability 概览。

要卸载 Elastic Agent 以及随 Helm 一起安装的 Kubernetes 资源，请运行

helm uninstall <release-name> -n <namespace>
  1. 将 <release-name> 替换为发布名称，将 <namespace> 替换为 收集你的数据部分中描述的快速入门命令中使用的命名空间。

如果你使用了快速入门中的默认值，则命令将是

helm uninstall elastic-agent -n kube-system

要卸载 Elastic Agent 以及随 Helm 一起安装的 Kubernetes 资源，请运行

helm uninstall <release-name> -n <namespace>
  1. 将 <release-name> 替换为发布名称，将 <namespace> 替换为 收集你的数据部分中描述的快速入门命令中使用的命名空间。

如果你使用了快速入门中的默认值，则命令将是

helm uninstall elastic-agent -n kube-system

要卸载 Elastic Agent 和使用 kubectl 安装的 Kubernetes 资源

  1. 复制 收集你的数据部分中描述的用于安装 Elastic Agent 的 kubectl 快速入门命令。
  2. 将 | kubectl apply -f- 替换为 | kubectl delete -f-，然后运行该命令。

如果你正在使用 helm 在 Kubernetes 集群中安装 Elastic Agent，并且 kube-state-metrics 已经安装在要安装 Elastic Agent 的同一个命名空间中，你可能会遇到错误。在这种情况下，请将选项 --set kube-state-metrics.enabled=false 添加到 UI 提供的安装命令中，以跳过 kube-state-metrics 的安装。

如果你正在使用 helm 在 Kubernetes 集群中安装 Elastic Agent，并且主机上已经配置了 elastic 存储库，请将 UI 提供的命令中的 helm repo add elastic https://helm.elastic.co/ 部分替换为 helm repo update elastic，以确保存储库已使用最新的包信息进行更新。

© . This website operates independently and is not affiliated with or endorsed by Elasticsearch B.V. All brand names, logos, and trademarks are the property of their respective owners.