« 在容器化环境中安装 Elastic Agent 在由 Fleet 管理的 Kubernetes 上运行 Elastic Agent »
Elastic 文档 ›Fleet 和 Elastic Agent 指南 [8.17] ›安装 Elastic Agent ›在容器化环境中安装 Elastic Agent

在容器中运行 Elastic Agent

编辑

在容器中运行 Elastic Agent

编辑

你可以在容器内部运行 Elastic Agent，无论是使用 Fleet Server 还是独立运行。所有版本的 Elastic Agent 的 Docker 镜像都可从 Elastic Docker 注册表 获取。如果你在 Kubernetes 中运行，请参阅 在 ECK 上运行 Elastic Agent。

请注意，在容器中运行 Elastic Agent 仅在 Linux 环境中受支持。因此，我们目前不提供 Windows 的 Elastic Agent 容器镜像。

注意事项

  • 当 Elastic Agent 在容器内部运行时，它不能通过 Fleet 进行升级，因为它期望容器本身被升级。
  • 注册和运行 Elastic Agent 通常是一个两步过程。但是，这在容器中不起作用，因此会调用一个特殊的子命令 container。此命令允许使用环境变量配置所有属性，并将 enroll 和 run 命令作为单个命令运行。
你需要什么
编辑
步骤 1：拉取镜像
编辑

Elastic Agent 有两个镜像，elastic-agent 和 elastic-agent-complete。elastic-agent 镜像包含运行 Beats 的所有二进制文件，而 elastic-agent-complete 镜像包含这些二进制文件以及通过 Elastic Synthetics 运行浏览器监视器的其他依赖项。有关更多信息，请参阅 通过 Elastic Agent 和 Fleet 进行综合监控。

针对 Elastic Docker 注册表运行 docker pull 命令

docker pull docker.elastic.co/elastic-agent/elastic-agent:8.17.0

如果要运行 Synthetics 测试，请运行 docker pull 命令以获取 elastic-agent-complete 镜像

docker pull docker.elastic.co/elastic-agent/elastic-agent-complete:8.17.0
步骤 2：可选：验证镜像
编辑

虽然是可选的，但我们强烈建议验证下载的 Docker 镜像中包含的签名，以确保镜像有效。

Elastic 镜像使用 Cosign 进行签名，Cosign 是 Sigstore 项目的一部分。Cosign 支持 OCI 注册表中的容器签名、验证和存储。为你的操作系统安装相应的 Cosign 应用程序。

运行以下命令以验证 Elastic Agent v8.17.0 的 elastic-agent 容器镜像签名

wget https://artifacts.elastic.co/cosign.pub 
cosign verify --key cosign.pub docker.elastic.co/elastic-agent/elastic-agent:8.17.0

下载 Elastic 公钥以验证容器签名

使用 Elastic 公钥验证容器

如果你使用的是 elastic-agent-complete 镜像，请按如下方式运行命令

wget https://artifacts.elastic.co/cosign.pub 
cosign verify --key cosign.pub docker.elastic.co/elastic-agent/elastic-agent-complete:8.17.0

该命令以 JSON 格式打印检查结果和签名有效负载，例如

Verification for docker.elastic.co/elastic-agent/elastic-agent-complete:8.17.0 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The signatures were verified against the specified public key
步骤 3：了解 Elastic Agent 容器命令
编辑

Elastic Agent 容器命令提供了多种选项。要查看完整列表，请运行

docker run --rm docker.elastic.co/elastic-agent/elastic-agent:8.17.0 elastic-agent container -h
步骤 4：运行 Elastic Agent 镜像
编辑
docker run \
  --env FLEET_ENROLL=1 \ 
  --env FLEET_URL=<fleet-server-host-url> \ 
  --env FLEET_ENROLLMENT_TOKEN=<enrollment-token> \ 
  --rm docker.elastic.co/elastic-agent/elastic-agent:8.17.0

设置为 1 以将 Elastic Agent 注册到 Fleet Server。

用于将 Fleet Server 注册到的 URL。你可以在 Kibana 中找到它。选择 管理 → Fleet → Fleet 设置，并复制 Fleet Server 主机 URL。

用于注册的令牌。关闭弹出面板，然后选择 注册令牌。找到你要将 Elastic Agent 注册到的 Agent 策略，并显示和复制密钥令牌。要了解如何创建策略，请参阅 不使用 UI 创建代理策略。

如果要运行 elastic-agent-complete 镜像，请将 elastic-agent 替换为 elastic-agent-complete。使用 elastic-agent 用户而不是 root 用户来运行 Synthetics 浏览器测试。Synthetic 测试不能在 root 用户下运行。有关更多信息，请参阅 Synthetics Fleet 快速入门。

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

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

  --env FLEET_SERVER_ENABLE=true \ 
  --env FLEET_SERVER_ELASTICSEARCH_HOST=<elasticsearch-host> \ 
  --env FLEET_SERVER_SERVICE_TOKEN=<service-token>

设置为 true 以在此 Elastic Agent 上引导 Fleet Server。这也会自动强制进行 Fleet 注册。

Fleet Server 用于通信的 Elasticsearch 主机，例如 http://elasticsearch:9200。

用于与 Elasticsearch 和 Kibana 通信的服务令牌。

在只读文件系统上运行 Elastic Agent

如果你想在只读文件系统的 Docker 容器中运行 Elastic Agent，可以通过指定 --read-only 选项来实现。Elastic Agent 需要一个有状态的目录来存储应用程序数据，因此，使用 --read-only 选项时，你还需要使用 --mount 选项来指定可以存储该数据的路径。

例如

docker run --rm --mount source=$(pwd)/state,destination=/state -e {STATE_PATH}=/state --read-only docker.elastic.co/elastic-agent/elastic-agent:8.17.0 <1>

其中 {STATE_PATH} 是要挂载的有状态目录的路径，可以在其中存储 Elastic Agent 应用程序数据。

你还可以将 type=tmpfs 添加到挂载参数 (--mount type=tmpfs,destination=/state...) 中，以指定临时文件存储位置。这样做应该谨慎，因为它可能会导致数据重复，尤其是在重新启动容器时，因为不会持久化任何状态数据。

步骤 5：在 Kibana 中查看你的数据
编辑

  1. 启动 Kibana

    1. 登录你的 Elastic Cloud 帐户。
    2. 导航到部署中的 Kibana 端点。

  2. 要检查你的 Elastic Agent 是否已注册到 Fleet，请转到 管理 → Fleet → 代理。

    Elastic Agents Fleet page
  3. 要查看流入的数据，请转到 分析 → 发现，然后选择索引 metrics-*，甚至更具体地选择 metrics-kubernetes.*。如果看不到这些索引，请为它们创建数据视图。
  4. 要查看预定义的仪表板，请选择 分析 → 仪表板，或通过集成安装资产。
Docker compose
编辑

你可以在 docker-compose 中运行 Elastic Agent。下面的示例显示了如何注册 Elastic Agent

version: "3"
services:
  elastic-agent:
    image: docker.elastic.co/elastic-agent/elastic-agent:8.17.0 
    container_name: elastic-agent
    restart: always
    user: root # note, synthetic browser monitors require this set to `elastic-agent`
    environment:
      - FLEET_ENROLLMENT_TOKEN=<enrollment-token>
      - FLEET_ENROLL=1
      - FLEET_URL=<fleet-server-url>

如果你打算使用完整版本，请将 elastic-agent 切换为 elastic-agent-complete。使用 elastic-agent 用户而不是 root 用户来运行 Synthetics 浏览器测试。Synthetic 测试不能在 root 用户下运行。有关更多信息，请参阅 Synthetics Fleet 快速入门。

如果你还需要运行 Fleet Server，请通过添加以下环境变量来调整上面的 docker-compose 文件

      - FLEET_SERVER_ENABLE=true
      - FLEET_SERVER_ELASTICSEARCH_HOST=<elasticsearch-host>
      - FLEET_SERVER_SERVICE_TOKEN=<service-token>

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

日志
编辑

由于容器仅支持一个版本的 Elastic Agent，因此日志和状态的存储方式与在容器外运行 Elastic Agent 时略有不同。日志可以在以下位置找到：/usr/share/elastic-agent/state/data/logs/*。

重要的是要注意，只有来自 Elastic Agent 进程本身的日志才会记录到 stdout。子进程日志不会。每个子进程将其自己的日志写入 logs 目录内的 default 目录

/usr/share/elastic-agent/state/data/logs/default/*

在 Fleet Server 中遇到错误？请查看 fleet-server 子进程日志以获取更多信息。

调试
编辑

可以启用一个监控端点来暴露资源使用情况和事件处理数据。该端点与以 Fleet 模式和独立模式运行的 Elastic Agent 兼容。

在安装了 Elastic Agent 的主机上的 elastic-agent.yml 中启用监控端点。一个示例配置如下所示：

agent.monitoring:
  enabled: true 
  logs: true 
  metrics: true 
  http:
      enabled: true 
      host: localhost 
      port: 6791

启用对正在运行的进程的监控。

启用日志监控。

启用指标监控。

通过 HTTP 暴露 Elastic Agent 指标。默认情况下，使用套接字和命名管道。

HTTP 端点将绑定到的主机名、IP 地址、Unix 套接字或命名管道。当使用 IP 地址时，我们建议只使用 localhost。

HTTP 端点将绑定到的端口。

上述配置会在 https://127.0.0.1:6791/processes 暴露一个监控端点。

https://127.0.0.1:6791/processes 输出 
{
   "processes":[
      {
         "id":"metricbeat-default",
         "pid":"36923",
         "binary":"metricbeat",
         "source":{
            "kind":"configured",
            "outputs":[
               "default"
            ]
         }
      },
      {
         "id":"filebeat-default-monitoring",
         "pid":"36924",
         "binary":"filebeat",
         "source":{
            "kind":"internal",
            "outputs":[
               "default"
            ]
         }
      },
      {
         "id":"metricbeat-default-monitoring",
         "pid":"36925",
         "binary":"metricbeat",
         "source":{
            "kind":"internal",
            "outputs":[
               "default"
            ]
         }
      }
   ]
}

可以访问 /processes 输出中的每个进程 ID 以获取更多详细信息。

https://127.0.0.1:6791/processes/{进程名称} 输出 
{
   "beat":{
      "cpu":{
         "system":{
            "ticks":537,
            "time":{
               "ms":537
            }
         },
         "total":{
            "ticks":795,
            "time":{
               "ms":796
            },
            "value":795
         },
         "user":{
            "ticks":258,
            "time":{
               "ms":259
            }
         }
      },
      "info":{
         "ephemeral_id":"eb7e8025-7496-403f-9f9a-42b20439c737",
         "uptime":{
            "ms":75332
         },
         "version":"7.14.0"
      },
      "memstats":{
         "gc_next":23920624,
         "memory_alloc":20046048,
         "memory_sys":76104712,
         "memory_total":60823368,
         "rss":83165184
      },
      "runtime":{
         "goroutines":58
      }
   },
   "libbeat":{
      "config":{
         "module":{
            "running":4,
            "starts":4,
            "stops":0
         },
         "reloads":1,
         "scans":1
      },
      "output":{
         "events":{
            "acked":0,
            "active":0,
            "batches":0,
            "dropped":0,
            "duplicates":0,
            "failed":0,
            "toomany":0,
            "total":0
         },
         "read":{
            "bytes":0,
            "errors":0
         },
         "type":"elasticsearch",
         "write":{
            "bytes":0,
            "errors":0
         }
      },
      "pipeline":{
         "clients":4,
         "events":{
            "active":231,
            "dropped":0,
            "failed":0,
            "filtered":0,
            "published":231,
            "retry":112,
            "total":231
         },
         "queue":{
            "acked":0,
            "max_events":4096
         }
      }
   },
   "metricbeat":{
      "system":{
         "cpu":{
            "events":8,
            "failures":0,
            "success":8
         },
         "filesystem":{
            "events":80,
            "failures":0,
            "success":80
         },
         "memory":{
            "events":8,
            "failures":0,
            "success":8
         },
         "network":{
            "events":135,
            "failures":0,
            "success":135
         }
      }
   },
   "system":{
      "cpu":{
         "cores":8
      },
      "load":{
         "1":2.5957,
         "15":5.415,
         "5":3.5815,
         "norm":{
            "1":0.3245,
            "15":0.6769,
            "5":0.4477
         }
      }
   }
}
« 在容器化环境中安装 Elastic Agent 在由 Fleet 管理的 Kubernetes 上运行 Elastic Agent »