bandsintown/prometheus

bandsintown/prometheus 镜像文档

镜像概述

该镜像基于Alpine Linux构建，提供Prometheus监控系统的容器化部署方案。Prometheus是Cloud Native Computing Foundation（CNCF）项目，用于系统和服务监控，通过定期从配置目标收集指标、评估规则表达式、展示结果并在满足条件时触发告警。此镜像特别集成了Consul和Consul Template，实现动态配置管理，支持灵活调整监控目标和告警规则。

核心功能与特性

Prometheus核心特性

• 多维数据模型：时序数据由指标名称和键值维度集合定义
• 灵活查询语言：支持利用维度特性的强大查询能力
• 无分布式存储依赖：单服务器节点自治运行
• 基于HTTP的拉取模型：通过HTTP主动拉取时序数据
• 支持推送时序数据：通过中间网关实现数据推送
• 目标发现机制：支持服务发现或静态配置
• 多模式图形化与仪表盘支持
• 支持层次化和水平联邦

本镜像增强特性

• 基于Alpine Linux，镜像体积小、资源占用低
• 集成Consul和Consul Template，实现动态配置管理
• 支持通过Consul键值存储动态更新监控配置和告警规则

架构概述

!Prometheus架构图

使用场景

• 需要动态调整监控目标的微服务环境
• 需频繁更新告警规则的复杂监控场景
• 基于Consul服务发现的容器化部署环境
• 对监控系统资源占用有严格要求的场景

配置与使用方法

通过Consul配置

该镜像通过Consul实现动态配置管理，需通过以下Consul键路径进行配置：

1. 全局配置

创建Consul键 service/prometheus/global.yml 存储Prometheus全局配置，注意：全局配置中不得包含rule_files部分。

示例全局配置内容：

yaml
global:
  scrape_interval: 15s
  evaluation_interval: 15s
alerting:
  alertmanagers:
  - static_configs:
    - targets:
      - alertmanager:9093
scrape_configs:
  - job_name: 'prometheus'
    static_configs:
    - targets: ['localhost:9090']

2. 告警规则配置

创建Consul键 service/prometheus/rule_files/<规则名称> 添加告警规则。创建后，规则将自动添加到Prometheus配置并触发服务重载。

示例告警规则（键路径：service/prometheus/rule_files/high_cpu）：

yaml
groups:
- name: example
  rules:
  - alert: HighCPUUsage
    expr: avg(rate(node_cpu_seconds_total{mode!="idle"}[5m])) by (instance) > 0.85
    for: 5m
    labels:
      severity: critical
    annotations:
      summary: "High CPU usage detected"
      description: "Instance {{ $labels.instance }} has high CPU usage ({{ $value }})"

部署示例

Docker Run命令

bash
docker run -d \
  --name prometheus \
  -p 9090:9090 \
  --link consul:consul \
  bandsintown/prometheus

Docker Compose配置

yaml
version: '3'
services:
  prometheus:
    image: bandsintown/prometheus
    ports:
      - "9090:9090"
    depends_on:
      - consul
    environment:
      - CONSUL_HTTP_ADDR=consul:8500

  consul:
    image: consul
    ports:
      - "8500:8500"

许可证

本仓库所有代码（除非另有明确说明）均采用ISC许可证。许可证完整内容见 LICENSE 文件。