julius/prometheus-demo-service

Prometheus虚假指标演示服务器镜像

镜像概述

本镜像提供一个轻量级演示服务器，可生成并导出合成的虚假Prometheus指标。它旨在帮助用户测试Prometheus监控环境、验证告警规则配置、演示监控可视化效果，而无需依赖真实业务服务。

核心功能与特性

• 合成指标生成：支持多种Prometheus指标类型，包括计数器（Counter）、仪表盘（Gauge）、直方图（Histogram）和摘要（Summary）
• 动态指标模拟：可模拟指标的随机波动、线性增长/下降、周期性变化等多种动态行为
• 标准兼容：通过/metrics端点暴露指标，完全符合Prometheus数据采集格式规范
• 轻量级设计：基于精简基础镜像构建，资源占用低，启动快速
• 可配置性：支持通过环境变量自定义指标类型、更新频率、取值范围等参数

使用场景与适用范围

• Prometheus部署测试：验证Prometheus服务发现、指标采集配置的正确性
• 告警规则验证：模拟异常指标场景，测试告警规则触发逻辑
• 可视化演示：为Grafana等可视化工具提供样例数据，展示监控面板效果
• 教学培训：在Prometheus学习过程中，提供可控的指标数据源

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/prometheus-demo-metrics:latest

启动容器

bash
docker run -d -p 8080:8080 --name prometheus-demo-server docker.xuanyuan.run/[镜像仓库地址]/prometheus-demo-metrics:latest

访问指标

容器启动后，通过以下URL访问生成的指标：

http://localhost:8080/metrics

自定义配置

通过环境变量可自定义服务器行为，支持的配置参数如下：

自定义配置示例

bash
docker run -d -p 8080:8080 \
  -e METRIC_UPDATE_INTERVAL=2s \
  -e METRIC_TYPE=gauge \
  -e GAUGE_RANGE_MIN=10 \
  -e GAUGE_RANGE_MAX=200 \
  --name prometheus-demo-server docker.xuanyuan.run/[镜像仓库地址]/prometheus-demo-metrics:latest

Docker Compose配置示例

yaml
version: '3'
services:
  prometheus-demo:
    image: docker.xuanyuan.run/[镜像仓库地址]/prometheus-demo-metrics:latest
    ports:
      - "8080:8080"
    environment:
      - METRIC_UPDATE_INTERVAL=3s
      - METRIC_TYPE=mixed
      - COUNTER_INCREMENT=2
    restart: unless-stopped

指标示例

访问/metrics端点将返回类似以下格式的Prometheus指标：

# HELP demo_gauge_example 示例Gauge类型指标
# TYPE demo_gauge_example gauge
demo_gauge_example 42.8

# HELP demo_counter_example 示例Counter类型指标
# TYPE demo_counter_example counter
demo_counter_example 156

# HELP demo_histogram_example 示例Histogram类型指标
# TYPE demo_histogram_example histogram
demo_histogram_example_bucket{le="0.1"} 3
demo_histogram_example_bucket{le="1"} 12
demo_histogram_example_bucket{le="5"} 34
demo_histogram_example_bucket{le="10"} 42
demo_histogram_example_bucket{le="20"} 50
demo_histogram_example_bucket{le="+Inf"} 50
demo_histogram_example_count 50
demo_histogram_example_sum 238.5