ikubernetes/metrics-app

镜像概述

该Docker镜像包含一个可提供指标数据的应用程序，其核心功能是生成并暴露可被Prometheus监控系统采集的指标，旨在为监控体系提供标准化的指标来源，兼容Prometheus监控生态。

核心功能和特性

• Prometheus兼容：提供符合Prometheus指标格式的接口，支持Prometheus的指标抓取协议
• 多类型指标：包含基础系统指标（如CPU使用率、内存占用等）及应用特定指标
• 轻量级设计：容器化部署，资源占用低，适合在各类容器环境中运行
• 可配置性：支持通过参数调整指标暴露端口、路径等核心配置

使用场景和适用范围

• 应用性能监控：收集应用运行时的关键性能指标（如响应时间、请求量、错误率等）
• 系统资源监控：监控容器或主机的CPU、内存、磁盘I/O等系统资源使用情况
• 监控体系构建：作为Prometheus监控栈的指标数据源，配合Grafana等工具实现可视化监控
• 适用于：需要构建监控系统的开发、测试及生产环境，尤其适合采用Prometheus作为监控解决方案的场景

使用方法和配置说明

基本部署

通过以下命令启动容器，默认配置下应用将在9090端口暴露指标接口：

bash
docker run -d -p 9090:9090 --name metrics-app [镜像名称]

Prometheus可通过http://<容器IP>:9090/metrics端点抓取指标数据。

环境变量配置

可通过环境变量自定义应用行为，常用配置参数如下：

• METRICS_PORT：指标服务监听端口，默认值：9090
• METRICS_PATH：指标接口路径，默认值：/metrics
• LOG_LEVEL：日志级别（debug/info/warn/error），默认值：info

自定义配置示例

bash
docker run -d \
  -p 8080:8080 \
  --name custom-metrics-app \
  -e METRICS_PORT=8080 \
  -e METRICS_PATH=/app-metrics \
  -e LOG_LEVEL=debug \
  [镜像名称]

Prometheus配置示例

在Prometheus配置文件（prometheus.yml）中添加如下job配置，即可实现指标抓取：

yaml
scrape_configs:
  - job_name: 'metrics-app'
    scrape_interval: 15s  # 抓取间隔，根据需求调整
    static_configs:
      - targets: ['<容器IP>:9090']  # 替换为实际容器IP和端口（若使用默认配置）

docker-compose部署示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  metrics-app:
    image: [镜像名称]
    ports:
      - "9090:9090"
    environment:
      - METRICS_PORT=9090
      - METRICS_PATH=/metrics
    restart: always

通过docker-compose up -d启动服务。