nmhung1210/nginx-alpine-amplify

https://img.shields.io/docker/stars/nmhung1210/nginx-alpine-amplify.svg?style=plastic](https://registry.hub.docker.com/v2/repositories/nmhung1210/nginx-alpine-amplify/stars/count/) https://img.shields.io/docker/pulls/nmhung1210/nginx-alpine-amplify.svg?style=plastic](https://registry.hub.docker.com/v2/repositories/nmhung1210/nginx-alpine-amplify/) https://img.shields.io/docker/automated/nmhung1210/nginx-alpine-amplify.svg?maxAge=2592000?style=plastic](https://github.com/nmhung1210/nginx-alpine-amplify/)

1. 概述

NGINX Amplify是一款免费监控工具，适用于基于NGINX和Docker的微服务架构，由NGINX Inc.开发维护。它可跨Docker容器收集和聚合指标，展示NGINX关键性能数据（如活跃连接、每秒请求数）的可视化结果，帮助快速检测性能退化、流量异常并深入分析NGINX配置。

使用Amplify需在容器内安装基于Python的https://github.com/nginxinc/nginx-amplify-agent%EF%BC%8C%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E8%A7%81https://github.com/nginxinc/nginx-amplify-doc/blob/master/amplify-guide.md%E3%80%82

1.1 容器内的NGINX Amplify Agent

Amplify Agent可部署在Docker环境中监控容器内的NGINX实例，目前仅支持"容器内Agent"模式，即Agent需与NGINX实例在同一容器中运行。

1.2 独立模式

默认情况下，Agent启动时会自动获取OS主机名生成UUID以唯一标识监控对象。若无额外配置，每个从该镜像启动的容器会作为独立系统上报至Amplify界面，且主机名通常不易读。推荐使用imagename选项，告知Agent运行在容器环境中，按容器场景收集和上报指标。若需将同一镜像的不同实例作为独立对象监控，可为每个实例分配不同的imagename。

1.3 聚合模式

Agent会根据/etc/amplify-agent/agent.conf中的imagename配置上报监控对象。该选项可通过Dockerfile或环境变量设置：

• Dockerfile配置：

  ENV AMPLIFY_IMAGENAME my-docker-instance-123
  

• 运行时环境变量：

  docker run --name mynginx1 -e API_KEY=ffeedd0102030405060708 -e AMPLIFY_IMAGENAME=my-service-123 -d nginx-amplify
  

若多个实例使用相同imagename，其指标会在Amplify后端聚合，形成单一"容器"类型对象，便于查看微服务的总请求数等聚合统计。同一imagename的容器可分布在不同物理主机，无需共享本地镜像或NGINX配置。

1.4 当前限制

• 若需收集https://github.com/nginxinc/nginx-amplify-doc/blob/master/amplify-guide.md#additional-nginx-metrics%EF%BC%8CNGINX%E6%97%A5%E5%BF%97%E9%9C%80%E4%BF%9D%E7%95%99%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%EF%BC%88%E9%BB%98%E8%AE%A4%E6%97%A5%E5%BF%97%E4%BC%9A%E9%87%8D%E5%AE%9A%E5%90%91%E8%87%B3Docker%E6%97%A5%E5%BF%97%E6%94%B6%E9%9B%86%E5%99%A8%EF%BC%89%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87https://github.com/nginxinc/nginx-amplify-doc/blob/master/amplify-guide.md#configuring-syslog%E5%B0%86%E6%97%A5%E5%BF%97%E5%96%82%E7%BB%99Agent%E3%80%82
• 聚合模式下，部分OS指标和元数据（如主机名、CPU使用率、磁盘I/O、网络接口配置）无法收集。
• Agent仅能监控同一容器内的NGINX，暂不支持跨容器监控相邻NGINX容器。

2. 如何构建和运行Amplify-enabled的NGINX镜像？

2.1 构建镜像

（注：若不熟悉Docker，可参考https://docs.docker.com/engine/installation/%EF%BC%89
基于官方NGINX镜像构建集成Amplify Agent的Alpine镜像步骤：

bash
git clone https://github.com/nmhung1210/nginx-alpine-amplify
cd nginx-alpine-amplify
docker build -t nginx-alpine-amplify .

构建完成后，通过docker images查看镜像列表：

bash
docker images
# 输出示例：
# REPOSITORY                 TAG       IMAGE ID       CREATED        SIZE
# nginx-alpine-amplify       latest    d039b39d2987   3 minutes ago  241.6 MB

2.2 运行容器

需先注册Amplify账号获取有效API_KEY。启动容器命令：

bash
docker run --name mynginx1 -e API_KEY=ffeedd0102030405060708 -e AMPLIFY_IMAGENAME=my-service-123 -d nginx-amplify

其中API_KEY为Amplify账号分配的密钥，AMPLIFY_IMAGENAME用于标识服务（见1.2和1.3节）。

验证容器状态

• 查看运行中的容器：

  bash
  docker ps
  # 输出示例：
  # CONTAINER ID   IMAGE                  COMMAND             CREATED        STATUS        PORTS     NAMES
  # 7d7b47ba4c72   nginx-alpine-amplify   "/entrypoint.sh"    3 seconds ago  Up 2 seconds  80/tcp    mynginx1
  

• 查看容器日志：

  bash
  docker logs 7d7b47ba4c72
  # 输出示例：
  # starting nginx ...
  # updating /etc/amplify-agent/agent.conf ...
  # ---> using api_key = ffeedd0102030405060708
  # ---> using imagename = my-service-123
  # starting amplify-agent ...
  

• 检查进程：

  bash
  docker exec 7d7b47ba4c72 ps axu
  # 输出应包含amplify-agent进程
  

• 查看Agent日志：

  bash
  docker exec 7d7b47ba4c72 tail /var/log/amplify-agent/agent.log
  

停止容器

bash
docker stop 7d7b47ba4c72

查看所有容器（含停止状态）：

bash
docker ps -a

若一切正常，约1分钟后可在Amplify web界面看到新容器的监控数据。