在 Fleet 管理下在 Kubernetes 上运行 Elastic Agent

下载清单文件

curl -L -O https://raw.githubusercontent.com/elastic/elastic-agent/8.17/deploy/kubernetes/elastic-agent-managed-kubernetes.yaml

此清单包括用于收集 Kubernetes 指标的 Kubernetes 集成，以及用于从节点收集系统级别指标和日志的系统集成。

Elastic Agent 被部署为 DaemonSet，以确保在集群的每个节点上都有一个正在运行的实例。这些实例用于从主机检索大多数指标，例如系统指标、Docker 统计信息以及从 Kubernetes 之上运行的所有服务检索指标。这些指标通过已部署的 kube-state-metrics 访问。请注意，默认情况下，所有内容都部署在 kube-system 命名空间下。要更改命名空间，请修改清单文件。

此外，DaemonSet 中的一个 Pod 将持续保持领导者锁，这使其负责处理集群范围的监控。您可以在领导者选举提供程序中找到有关领导者选举配置选项的更多信息。领导者 Pod 将检索整个集群唯一的指标，例如 Kubernetes 事件或 kube-state-metrics。

出于 Kubernetes 安全态势管理 (KSPM) 的目的，Elastic Agent 需要对各种类型的 Kubernetes 资源、节点进程和文件进行读取访问。为了实现此目的，将授予 Elastic Agent 对必要资源的读取权限，并挂载来自托管节点文件系统的卷，以允许 Elastic Agent Pod 访问。

需要将 Elastic Agent 分配给一个策略，以启用正确的输入。为了实现 Kubernetes 可观测性，该策略需要包括 Kubernetes 集成。请参考创建策略和向策略添加集成，了解如何配置Kubernetes 集成。

Elastic Agent 的注册定义为将特定代理注册到正在运行的 Fleet Server 的操作。

通过使用 FLEET_URL 参数，将 Elastic Agent 注册到正在运行的 Fleet Server。此外，使用 FLEET_ENROLLMENT_TOKEN 参数将 Elastic Agent 连接到特定的 Elastic Agent 策略。

在创建新策略时，将创建一个新的 FLEET_ENROLLMENT_TOKEN，并且在引导式安装期间将其插入 Elastic Agent 清单中。

查找有关 注册令牌 的更多信息。

要指定不同的目标/凭据，请在清单文件中更改以下参数

- name: FLEET_URL
  value: "https://fleet-server_url:port" 
- name: FLEET_ENROLLMENT_TOKEN
  value: "token" 
- name: FLEET_SERVER_POLICY_ID
  value: "fleet-server-policy" 
- name: KIBANA_HOST
  value: "" 
- name: KIBANA_FLEET_USERNAME
  value: "" 
- name: KIBANA_FLEET_PASSWORD
  value: "" 

如果您还需要运行 Fleet Server，请通过添加以下环境变量来调整上面的 docker run 命令

- name: FLEET_SERVER_ENABLE
  value: "true" 
- name: FLEET_SERVER_ELASTICSEARCH_HOST
  value: "<elasticsearch-host>" 
- name: FLEET_SERVER_SERVICE_TOKEN
  value: "<service-token>" 

请参阅环境变量，了解所有可用选项。

Kubernetes 控制平面节点可以使用污点来限制可以在其上运行的工作负载。独立 Elastic Agent 的清单定义了可以在这些节点上运行的容忍度。在控制平面节点上运行的 Agent 从 Kubernetes 的控制平面组件（调度程序、控制器管理器）收集指标。要禁用 Elastic Agent 在控制平面节点上运行，请删除 DaemonSet 规范的以下部分

spec:
  # Tolerations are needed to run Elastic Agent on Kubernetes control-plane nodes.
  # Agents running on control-plane nodes collect metrics from the control plane components (scheduler, controller manager) of Kubernetes
  tolerations:
    - key: node-role.kubernetes.io/control-plane
      effect: NoSchedule
    - key: node-role.kubernetes.io/master
      effect: NoSchedule

这两个容忍度的作用相同，但 node-role.kubernetes.io/master 从 Kubernetes 版本 v1.25 起已弃用。

要将 Elastic Agent 部署到 Kubernetes，请运行

kubectl create -f elastic-agent-managed-kubernetes.yaml

要检查状态，请运行

$ kubectl -n kube-system get pods -l app=elastic-agent
NAME                            READY   STATUS    RESTARTS   AGE
elastic-agent-4665d             1/1     Running   0          81m
elastic-agent-9f466c4b5-l8cm8   1/1     Running   0          81m
elastic-agent-fj2z9             1/1     Running   0          81m
elastic-agent-hs4pb             1/1     Running   0          81m