elastic/metricbeat

Metricbeat Docker镜像

镜像概述

Metricbeat Docker镜像是由Elastic官方维护的轻量级指标收集工具容器化版本。作为Elastic Stack的核心组件之一，Metricbeat专注于从服务器、容器、云服务和应用程序中收集系统与服务指标，支持将数据发送至Elasticsearch、Logstash或其他目标，结合Kibana实现指标可视化与分析。该镜像确保与Elastic Stack（Elasticsearch、Kibana等）版本兼容，简化部署与集成流程。

核心功能与特性

1. 多源指标收集

• 支持通过预构建模块收集各类指标，涵盖系统（CPU、内存、磁盘、网络）、容器（Docker、Kubernetes）、数据库（MySQL、PostgreSQL）、Web服务（Nginx、Apache）等20+常用服务。
• 可自定义指标集，灵活适配特定业务场景需求。

2. 轻量高效

• 设计为低资源占用（MB级内存消耗），适合在资源受限环境（如边缘设备、轻量级容器）中运行。
• 采用事件驱动架构，减少不必要的系统开销。

3. Elastic Stack无缝集成

• 原生支持将指标数据发送至Elasticsearch存储与索引，或通过Logstash进行数据处理。
• 与Kibana深度整合，提供预设仪表盘模板，开箱即可实现指标可视化与告警配置。

4. 可配置与扩展性

• 支持通过YAML配置文件自定义收集规则、输出目标及处理逻辑。
• 模块化设计，可按需启用/禁用指标集，减少资源消耗。

适用场景

• 服务器性能监控：收集CPU、内存、磁盘I/O等系统级指标，监控服务器健康状态。
• 容器与K8s集群监控：通过Docker/Kubernetes模块收集容器资源使用、Pod状态等指标。
• 微服务监控：集成Spring Boot、Node.js等应用模块，监控服务响应时间、错误率等业务指标。
• ELK Stack监控系统构建：与Elasticsearch、Logstash、Kibana联动，构建端到端指标采集、存储、分析与可视化平台。

使用方法

基本运行（默认配置）

通过docker run命令启动容器，默认配置下Metricbeat将收集系统指标并输出至控制台：

bash
docker run docker.elastic.co/beats/metricbeat:8.11.3

连接Elasticsearch与Kibana

指定Elasticsearch和Kibana地址，自动加载默认仪表盘：

bash
docker run -d \
  --name metricbeat \
  --user=root \
  --volume="/var/run/docker.sock:/var/run/docker.sock:ro" \
  --volume="/sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro" \
  --volume="/proc:/hostfs/proc:ro" \
  --volume="/:/hostfs:ro" \
  -e ELASTICSEARCH_HOSTS="http://elasticsearch:9200" \
  -e KIBANA_HOST="http://kibana:5601" \
  -e ELASTICSEARCH_USERNAME="elastic" \
  -e ELASTICSEARCH_PASSWORD="changeme" \
  docker.elastic.co/beats/metricbeat:8.11.3 \
  --setup -e

参数说明：

• --user=root：需root权限访问主机系统指标（如/proc、/sys）；
• 挂载主机目录（/var/run/docker.sock、/proc等）：允许Metricbeat收集主机和容器指标；
• --setup：自动加载Kibana仪表盘和索引模板；
• -e：启用详细日志输出。

自定义配置

通过挂载本地配置文件覆盖默认配置（推荐生产环境使用）：

1. 本地创建配置文件 metricbeat.yml（参考官方配置示例）；
2. 启动容器时挂载配置文件：

bash
docker run -d \
  --name metricbeat \
  --user=root \
  --volume="/path/to/local/metricbeat.yml:/etc/metricbeat/metricbeat.yml:ro" \
  --volume="/var/run/docker.sock:/var/run/docker.sock:ro" \
  --volume="/proc:/hostfs/proc:ro" \
  --volume="/sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro" \
  --volume="/:/hostfs:ro" \
  docker.elastic.co/beats/metricbeat:8.11.3

Docker Compose示例（与ELK Stack集成）

yaml
version: '3'
services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.3
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9200:9200"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9200/_cluster/health"]
      interval: 10s
      timeout: 10s
      retries: 5

  kibana:
    image: docker.elastic.co/kibana/kibana:8.11.3
    environment:
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
    ports:
      - "5601:5601"
    depends_on:
      elasticsearch:
        condition: service_healthy

  metricbeat:
    image: docker.elastic.co/beats/metricbeat:8.11.3
    user: root
    volumes:
      - ./metricbeat.yml:/etc/metricbeat/metricbeat.yml:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /proc:/hostfs/proc:ro
      - /sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro
      - /:/hostfs:ro
    environment:
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
      - KIBANA_HOST=http://kibana:5601
    depends_on:
      elasticsearch:
        condition: service_healthy
      kibana:
        condition: service_started
    command: --setup -e

配置说明

核心环境变量

常用模块配置

Metricbeat通过模块化设计支持多场景监控，常用模块包括：

• system：收集CPU、内存、磁盘、网络等系统指标；
• docker：监控Docker容器资源使用、状态等；
• kubernetes：采集K8s集群节点、Pod、Service指标；
• nginx：监控Nginx请求数、连接数、响应时间等；
• mysql：收集MySQL连接数、查询性能、表状态等指标。

模块启用与配置可通过metricbeat.yml中的modules字段实现，详情参考官方模块文档。

官方文档与资源

• Metricbeat Docker运行指南
• Elastic Docker镜像仓库
• Metricbeat配置参考
• Metricbeat模块与指标集