colovu/prometheus

Prometheus Docker镜像文档

镜像概述和主要用途

针对Prometheus应用的Docker镜像，用于提供Prometheus监控服务。Prometheus是一款开源的系统监控和告警工具，适用于收集、存储和分析各类指标数据。

详细信息可参照：官方说明

版本信息

• 2.19、latest

镜像信息

• 镜像地址：
  • 阿里云: registry.cn-shenzhen.aliyuncs.com/colovu/promethesu
  • DockerHub：colovu/promethesu
• 依赖镜像：debian:buster

后续相关命令行默认使用https://hub.docker.com%E9%95%9C%E5%83%8F%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%81%9A%E8%AF%B4%E6%98%8E

核心功能和特性

• 提供Prometheus完整监控服务，支持指标数据的收集、存储和查询
• 支持数据卷映射，实现配置文件、日志和数据的持久化存储
• 默认采用non-root用户运行，增强容器安全性
• 支持自定义配置，通过映射配置文件实现灵活的监控规则定义

使用场景和适用范围

• 服务器及应用性能监控
• 微服务架构下的分布式系统监控
• 容器化环境监控
• 需要自定义监控规则的场景

使用方法和配置说明

TL;DR

Docker快速启动命令

shell
# 从Docker Hub服务器下载镜像并启动
$ docker run -d --name promethesu colovu/promethesu

# 从Aliyun服务器下载镜像并启动
$ docker run -d --name promethesu registry.cn-shenzhen.aliyuncs.com/colovu/promethesu

• colovu/promethesu:<TAG>：镜像名称及版本标签；标签不指定时默认使用latest

Docker-Compose快速启动命令

shell
# 从Gitee下载Compose文件
$ curl -sSL -o docker-compose.yml https://gitee.com/colovu/docker-promethesu/raw/master/docker-compose.yml

# 从Github下载Compose文件
$ curl -sSL -o docker-compose.yml https://raw.githubusercontent.com/colovu/docker-promethesu/master/docker-compose.yml

# 创建并启动容器
$ docker-compose up -d

默认对外声明

端口

• 9090：Prometheus Web端口

数据卷

镜像默认提供以下数据卷定义，默认数据分别存储在自动生成的应用名对应prometheus子目录中：

shell
/var/log			# 日志输出
/srv/conf			# 配置文件
/srv/data			# 数据存储

如需持久化存储相应数据，需在宿主机建立本地目录，并在初始化容器时进行映射。宿主机相关目录中若不存在对应应用Prometheus的子目录或数据文件，容器会在初始化时自动创建。

容器配置

常规配置参数

Prometheus的配置主要通过修改prometheus.yml文件进行。容器默认需要映射/srv/conf数据卷：

1. 在宿主机创建用于映射数据卷的目录，如/tmp/conf：

shell
$ mkdir -p /tmp/conf

2. 创建子目录，并将prometheus.yml文件放至该子目录中：

shell
$ mkdir -p /tmp/conf/prometheus
$ cp ./prometheus.yml /tmp/conf/prometheus/

3. 修改配置文件后需重新启动容器使配置生效。

可选配置参数

如无特殊需求，可使用默认值，主要包括：

• ENV_DEBUG：默认值：false。设置是否输出容器调试信息。可选值：no、true、yes

安全

容器安全

本容器默认使用non-root用户运行应用，以加强容器安全性。使用non-root用户时，应用仅能操作镜像创建时指定的路径及数据，更适合生产环境使用。

如需切换为root用户运行，可在启动命令中增加-u root参数：

shell
$ docker run -d --name promethesu -u root colovu/promethesu

注意事项

• 容器中应用的启动参数不能配置为后台运行。若应用以后台方式运行，容器启动命令会在运行后自动退出，导致容器退出。

更新记录

• 2020.7.25：2.19、latest

本文原始来源 https://github.com/colovu @ https://github.com