elastic/apm-server Docker Image

APM Server Docker镜像文档

镜像概述

APM Server是Elastic APM解决方案的核心组件，负责收集、处理来自APM代理的应用性能监控数据，并将其发送至Elasticsearch进行存储和分析。本镜像由Elastic官方维护，提供了便捷的容器化部署方式，适用于快速集成APM功能到Elastic Stack环境中。

核心功能与特性

• 数据收集：接收来自Java、Python、Node.js等多种语言APM代理发送的性能数据（如事务、错误、指标等）
• 数据处理：支持数据过滤、字段重命名、采样等预处理操作
• 生态集成：无缝对接Elasticsearch（存储数据）和Kibana（可视化与分析）
• 官方维护：确保镜像安全性、稳定性及版本更新与Elastic Stack保持一致

使用场景

• 应用性能监控：实时追踪应用响应时间、错误率、吞吐量等关键指标
• 分布式追踪：监控微服务架构中的请求链路，定位性能瓶颈
• Elastic Stack集成：作为Elastic可观测性解决方案的一部分，构建全链路监控体系
• 适用于开发、测试及生产环境的APM部署需求

使用方法与配置说明

前提条件

• 已部署Elasticsearch和Kibana（推荐与APM Server版本匹配）
• 网络环境允许APM Server与Elasticsearch、Kibana及APM代理通信

获取镜像

从Elastic官方Docker仓库拉取镜像：

bash
docker pull ***-elastic.xuanyuan.run/apm/apm-server:<version>

（版本号需替换为具体版本，如8.11.3，版本列表可参考https://www.docker.elastic.co）

基本运行示例

bash
docker run -d \
  --name apm-server \
  -p 8200:8200 \
  ***-elastic.xuanyuan.run/apm/apm-server:<version> \
  --strict.perms=false \
  -e "output.elasticsearch.hosts=['http://elasticsearch:9200']" \
  -e "setup.kibana.host=http://kibana:5601"

关键配置说明

• 环境变量：通过-e参数配置APM Server设置，如Elasticsearch地址（output.elasticsearch.hosts）、Kibana地址（setup.kibana.host）等
• 配置文件挂载：如需自定义详细配置，可通过-v挂载本地配置文件：

  bash
  docker run -d \
    --name apm-server \
    -v /path/to/apm-server.yml:/usr/share/apm-server/apm-server.yml:ro \
    ***-elastic.xuanyuan.run/apm/apm-server:<version>
  

• 权限设置：默认以非root用户运行，如需调整权限可通过--user参数指定

详细文档参考

• 完整配置说明：https://www.elastic.co/guide/en/apm/server/master/running-on-docker.html
• Elastic APM概述：http://elastic.co/solutions/apm
• 镜像版本与标签：https://www.docker.elastic.co