Graphite Docker镜像文档

镜像概述和主要用途

本镜像是基于官方Graphite镜像（graphiteapp/graphite-statsd）的封装版本，专为配合sitespeed.io工具设计，支持快速部署Graphite（1.1.3版本）并优化指标存储配置。镜像默认启用Basic Auth认证，固定数据存储目录，可直接用于收集、存储sitespeed.io生成的性能指标，也可通过自定义配置适配其他监控场景。

核心功能和特性

• 默认Basic Auth认证：启动时需提供.htpasswd文件配置登录凭证，保障Web界面访问安全。
• 固定数据存储路径：Graphite数据目录默认指向/opt/graphite/storage/whisper，支持外部挂载实现数据持久化。
• 可自定义存储策略：支持通过挂载storage-schemas.conf和storage-aggregation.conf文件，调整指标存储周期和聚合规则。
• 即开即用的sitespeed.io适配：预配置指标存储策略，无需额外调整即可兼容sitespeed.io的指标格式。

使用场景和适用范围

• 网站性能监控：配合sitespeed.io收集前端性能指标（如加载时间、资源大小等），并通过Graphite长期存储和展示。
• 自定义指标存储：通过调整存储策略，适用于需要按不同粒度（如10分钟/点、30分钟/点）存储监控数据的场景。
• 开发/测试环境快速部署：无需手动配置Graphite组件，通过Docker命令一键启动完整服务。

使用方法和配置说明

1. 基本启动（默认认证）

使用默认的guest/guest认证凭证启动容器，仅用于测试环境：

docker run -d \
  --name graphite \
  -p 8080:80 \  # Web界面端口（映射到宿主机8080）
  -p 2003:2003 \  # 指标接收端口（Carbon缓存端口）
  sitespeedio/graphite

注意：默认认证安全性低，生产环境需替换为自定义.htpasswd文件。

2. 自定义认证文件

通过挂载宿主机的.htpasswd文件替换默认认证凭证，步骤如下：

1. 生成.htpasswd文件：使用htpasswd工具创建（参考Apache文档）：

   htpasswd -c /local/path/to/.htpasswd <用户名>  # 按提示输入密码
   

2. 启动容器并挂载认证文件：

   docker run -d \
     --name graphite \
     -p 8080:80 \
     -p 2003:2003 \
     -v /local/path/to/.htpasswd:/etc/nginx/.htpasswd \  # 挂载自定义认证文件
     sitespeedio/graphite
   

3. 数据持久化（挂载存储目录）

为避免容器重启导致数据丢失，需将Graphite的whisper数据目录挂载到宿主机：

docker run -d \
  --name graphite \
  -p 8080:80 \
  -p 2003:2003 \
  -v /local/path/to/.htpasswd:/etc/nginx/.htpasswd \  # 自定义认证
  -v /path/to/whisper:/opt/graphite/storage/whisper \  # 持久化数据目录
  sitespeedio/graphite

4. 自定义数据存储策略

默认存储策略为retentions = 10m:60d,30m:90d（10分钟/点存储60天，30分钟/点存储90天，共3个月数据）。如需调整（如延长存储周期），可通过挂载自定义storage-schemas.conf文件实现：

4.1 准备自定义存储策略文件

创建storage-schemas.conf文件，示例内容（存储1年数据）：

[default_1min_for_1year]
pattern = .*
retentions = 10m:180d, 30m:365d  # 10分钟/点存180天，30分钟/点存365天

4.2 挂载自定义配置启动

docker run -d \
  --name graphite \
  -p 8080:80 \
  -p 2003:2003 \
  -v /local/path/to/.htpasswd:/etc/nginx/.htpasswd \
  -v /path/to/whisper:/opt/graphite/storage/whisper \
  -v /path/to/storage-schemas.conf:/opt/graphite/conf/storage-schemas.conf \  # 挂载自定义存储策略
  sitespeedio/graphite

5. Docker Compose配置示例

创建docker-compose.yml文件，整合认证、数据持久化和自定义存储策略：

version: '3'
services:
  graphite:
    image: sitespeedio/graphite
    container_name: graphite
    ports:
      - "8080:80"
      - "2003:2003"
    volumes:
      - /local/path/to/.htpasswd:/etc/nginx/.htpasswd  # 自定义认证
      - /path/to/whisper:/opt/graphite/storage/whisper  # 数据持久化
      - /path/to/storage-schemas.conf:/opt/graphite/conf/storage-schemas.conf  # 自定义存储策略
    restart: unless-stopped  # 容器退出时自动重启

启动命令：docker-compose up -d

关键配置参数说明

基础镜像信息

本镜像基于官方Graphite镜像graphiteapp/graphite-statsd构建，继承其核心组件（Carbon、Whisper、Graphite Web），并添加sitespeed.io适配配置。