热门搜索:

graphiteapp/graphite-statsd

graphiteapp

Graphite官方Docker镜像，用于存储和可视化时间序列数据，基于稳定仓库，适用于一般用途。

133 次收藏下载次数: 0状态：社区镜像维护者：graphiteapp仓库类型：镜像最近更新：3 个月前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

Graphite & Statsd Docker 镜像文档

!Docker Pulls !Docker Size

镜像概述和主要用途

本镜像为 Graphite 和 Statsd 的官方 Docker 镜像，基于 https://github.com/hopsoft/docker-graphite-statsd 和 https://github.com/obfuscurity/synthesize 项目构建。主要用途是提供快速部署方案，帮助用户在几分钟内搭建起完整的指标收集与可视化系统，无需手动配置复杂的 Graphite 和 Statsd 环境。

标签与架构

开发版本：已弃用原开发仓库（graphiteapp/docker-graphite-statsd），不稳定构建请使用稳定仓库的 master 标签（graphiteapp/graphite-statsd:master）。
多架构支持：从 1.1.7-1 版本开始支持 arm/arm64 架构；从 1.1.7-6 版本开始提供 x64 架构的 -pypy 版本（针对性能优化，详情见 https://github.com/graphite-project/docker-graphite-statsd/pull/151%EF%BC%89%E3%80%82

核心功能和特性

包含组件

Nginx：反向代理 Graphite 仪表盘
Graphite：前端指标可视化仪表盘
Carbon：后端指标接收与存储服务（包含 carbon-cache、carbon-aggregator）
Statsd：UDP 协议的指标聚合代理
可选组件：Redis（用于 TagDB）、Collectd（系统指标收集）

关键特性

快速部署：一键启动完整的 Graphite & Statsd 环境
灵活配置：通过环境变量调整性能参数和功能开关
多架构支持：x64、arm、arm64 架构兼容，提供 PyPy 优化版本
数据持久化：支持挂载卷存储配置、指标数据和日志
服务监控：使用 runit 管理进程，支持优雅启停和日志轮转

使用场景和适用范围

适用场景

开发/测试环境的指标收集与调试
中小型生产环境的系统/应用指标监控
需要快速搭建可视化监控平台的场景
对指标存储和查询性能有基础需求的场景

不适用场景

超大规模集群监控（建议使用分布式部署方案）
对组件独立扩展有强需求的场景（建议拆分部署各组件）

使用方法和配置说明

快速开始

通过以下命令一键启动容器：

sh
docker run -d \
  --name graphite \
  --restart=always \
  -p 80:80 \
  -p 2003-2004:2003-2004 \
  -p 2023-2024:2023-2024 \
  -p 8125:8125/udp \
  -p 8126:8126 \
  graphiteapp/graphite-statsd

参数说明：

--name graphite：指定容器名称为 graphite
--restart=always：容器退出时自动重启
-p：端口映射（详见下文“端口映射”）
可根据需求调整端口映射（如主机端口冲突时）

端口映射

主机端口	容器端口	服务说明
80	80	Nginx（反向代理 Graphite 仪表盘）
2003	2003	Carbon 纯文本协议接收端口
2004	2004	Carbon Pickle 协议接收端口
2023	2023	Carbon Aggregator 纯文本协议接收端口
2024	2024	Carbon Aggregator Pickle 协议接收端口
8080	8080	Graphite 内部 Gunicorn 端口（不经过 Nginx 代理）
8125	8125/udp	Statsd 指标接收端口（默认 UDP，可通过 `STATSD_INTERFACE=tcp` 切换为 TCP）
8126	8126	Statsd 管理接口端口

卷挂载

默认情况下，容器会自动创建***卷存储以下数据。建议显式挂载主机目录以实现持久化：

主机目录（示例）	容器目录	用途说明
`/path/to/graphite/conf`	`/opt/graphite/conf`	Graphite 配置文件
`/path/to/graphite/storage`	`/opt/graphite/storage`	指标数据存储（whisper 文件）
`/path/to/statsd/config`	`/opt/statsd/config`	Statsd 配置文件
`/path/to/nginx/conf`	`/etc/nginx`	Nginx 配置文件
`/path/to/logs`	`/var/log`	日志文件（Graphite、Statsd 等）
`/path/to/redis/data`	`/var/lib/redis`	Redis 数据（用于 TagDB，可选）

挂载示例：

sh
docker run -d \
  --name graphite \
  -v /host/graphite/conf:/opt/graphite/conf \
  -v /host/graphite/storage:/opt/graphite/storage \
  -v /host/statsd/config:/opt/statsd/config \
  graphiteapp/graphite-statsd

开始使用 Graphite & Statsd

发送测试指标数据

通过以下命令向 Statsd 发送随机指标：

sh
while true; do echo -n "example:$((RANDOM % 100))|c" | nc -w 1 -u 127.0.0.1 8125; done

（example 为指标名，c 表示计数器类型，数值为 0-99 随机数）

可视化指标数据

访问 Graphite 仪表盘查看指标：

仪表盘：http://localhost/dashboard
指标查询：http://localhost/render?from=-10mins&until=now&target=stats.example

安全设置：Django Admin

默认 Django 管理员账户存在安全风险，需立即修改：

默认用户名：root
默认密码：root
默认***：root.graphite@mailinator.com

修改步骤：

访问 http://localhost/account/login 登录
进入 http://localhost/admin/auth/user/1/ 修改用户信息

配置参数说明

基础参数

环境变量	默认值	说明
`GRAPHITE_WSGI_PROCESSES`	4	Gunicorn 工作进程数
`GRAPHITE_WSGI_THREADS`	1	每个工作进程的线程数
`GRAPHITE_WSGI_REQUEST_TIMEOUT`	65	请求超时时间（秒）
`STATSD_INTERFACE`	`udp`	Statsd 监听协议（`udp` 或 `tcp`）
`SVWAIT`	7	runit 服务停止超时时间（秒）

Graphite-web 配置

环境变量	默认值	说明
`GRAPHITE_ALLOWED_HOSTS`	`*`	允许访问的主机列表（Django 设置）
`GRAPHITE_TIME_ZONE`	`Etc/UTC`	时区设置
`GRAPHITE_UTF8_METRICS`	`false`	是否允许 UTF-8 格式指标名（可能影响性能）
`GRAPHITE_DEBUG`	`false`	是否启用调试模式（显示详细错误信息）
`GRAPHITE_DEFAULT_CACHE_DURATION`	60	指标数据和图表缓存时间（秒）
`GRAPHITE_CLUSTER_SERVERS`	`''`	集群服务器列表（远程指标查询）

Carbon 配置

环境变量	默认值	说明
`CARBON_DISABLE_TAGS`	`false`	是否禁用 TagDB（设置为 `true` 禁用）
`GRAPHITE_CARBONLINK_HOSTS`	`'127.0.0.1:7002'`	Carbonlink 服务地址列表
`RELAY`	`0`	是否启用 carbon-relay（设置为 `1` 启用）

TagDB 配置

TagDB 用于存储指标标签信息，默认使用 SQLite，可切换为 Redis：

环境变量	默认值	说明
`REDIS_TAGDB`	`false`	是否使用 Redis 存储标签（`true` 启用）
`GRAPHITE_TAGDB_REDIS_HOST`	`'localhost'`	Redis 主机地址
`GRAPHITE_TAGDB_REDIS_PORT`	6379	Redis 端口

其他功能开关

环境变量	默认值	说明
`COLLECTD`	`0`	启用 Collectd（`1` 启用）
`GOCARBON`	`0`	使用 go-carbon 替代 Carbon（`1` 启用）
`BRUBECK`	`0`	使用 Brubeck 替代 Statsd（`1` 启用）
`MEMCACHE_HOST`	`''`	Memcached 地址（如 `127.0.0.1:11211`）

修改配置文件

若需调整高级配置（如 storage-schemas.conf）：

停止容器：docker stop graphite
查看容器卷路径：docker inspect graphite（在 Mounts 中找到对应卷的 Source 路径）
修改主机上的配置文件（如 /var/lib/docker/volumes/xxx/_data/storage-schemas.conf）
重启容器：docker start graphite

注意：修改 storage-schemas.conf 后，需删除旧的 whisper 文件（/opt/graphite/storage/whisper/ 目录下）以应用新的数据保留策略。

高级部署方案

Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  graphite:
    image: graphiteapp/graphite-statsd
    container_name: graphite
    restart: always
    ports:
      - "80:80"
      - "2003-2004:2003-2004"
      - "8125:8125/udp"
      - "8126:8126"
    volumes:
      - ./graphite/conf:/opt/graphite/conf
      - ./graphite/storage:/opt/graphite/storage
    environment:
      - GRAPHITE_TIME_ZONE=Asia/Shanghai
      - GRAPHITE_WSGI_PROCESSES=8

启动：docker-compose up -d

Kubernetes 部署

推荐使用第三方 Helm Chart：https://github.com/kiwigrid/helm-charts/tree/master/charts/graphite

实验性功能

go-carbon

设置 GOCARBON=1 启用 https://github.com/lomik/go-carbon%EF%BC%88Carbon 的 Go 语言实现，性能更优）。若需启用 carbonserver，设置 GRAPHITE_CLUSTER_SERVERS="127.0.0.1:8000"。

Brubeck

设置 BRUBECK=1 启用 https://github.com/github/brubeck%EF%BC%88Statsd 替代方案，支持更多协议，但配置格式与原生 Statsd 不兼容）。

附加说明

关于 root 进程

容器使用 runit 作为 init 系统管理多进程，需 root 权限运行。这符合 Docker 多进程容器最佳实践，但不完全遵循“单进程容器”理念。若需无 root 运行，建议拆分部署各组件。

Statsd 与 Carbon 配置兼容性

确保 Statsd 刷新间隔（flushInterval）不小于 Carbon 最小数据保留粒度。例如，Statsd 配置 flushInterval: 10000（10 秒）时，storage-schemas.conf 中保留策略需设置为 10s:12h 或更大粒度。

附加阅读

Graphite 官方文档
https://github.com/etsy/statsd/wiki
Carbon 配置指南
Docker 多进程容器管理

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 graphite-statsd 镜像标签

docker pull docker.xuanyuan.run/graphiteapp/graphite-statsd:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull graphiteapp/graphite-statsd:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"