monasca/persister
monasca
Monasca指标持久化工具的容器化版本，支持Python和Java两种实现，用于从Kafka接收监控指标并存储到InfluxDB等数据库，是Monasca监控系统的关键组件。
1 次收藏下载次数: 0状态：社区镜像维护者：monasca仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Monasca Persister Docker镜像文档
镜像概述
本镜像包含Monasca Persister的容器化版本。Monasca Persister是Monasca监控系统的核心组件，负责将监控指标持久化存储到数据库中。
该工具提供两种实现方式：
- Python实现（标签为
-python或默认无标签）- https://github.com/hpcloud-mon/monasca-docker/blob/master/monasca-persister-python/Dockerfile - Java实现（标签为
-java）- https://github.com/hpcloud-mon/monasca-docker/blob/master/monasca-persister-java/Dockerfile
当前推荐使用Python版本的镜像。有关Monasca项目的更多信息，请参见https://wiki.openstack.org/wiki/Monasca。
源代码仓库：https://github.com/openstack/monasca-persister/ · https://github.com/hpcloud-mon/monasca-docker/
标签约定
本仓库中的镜像遵循以下标签约定：
latest：指向最新稳定Python版本，例如1.3.0-pythonlatest-python、latest-java：分别指向Python或Java实现的最新稳定版本，例如1.3.0- 语义化版本标签：如
1.3.0、1.3、1，基于https://github.com/openstack/monasca-persister/的git标签 1.3.0-python、1.3-python、1-python：同上，但明确指向Python实现的版本- OpenStack版本名标签：如
mitaka、newton等，基于仓库中stable/版本名分支的最新代码构建 mitaka-python、newton-python：同上，但明确指向Python实现的版本master、master-DATESTAMP：从master分支构建的不稳定版本，不建议用于生产环境
除非另有说明，所有镜像均为Python实现。Java实现的镜像会明确标记-java后缀。
使用方法
运行Monasca Persister需要连接到正常运行的Zookeeper、Kafka以及数据库（如InfluxDB）。为实现完整功能，还需一个或多个https://hub.docker.com/r/monasca/api/实例向Kafka主题输出指标数据。
在类似https://github.com/hpcloud-mon/monasca-docker/blob/master/k8s/的部署场景中，无需额外配置参数，可直接运行：
bashdocker run -it docker.xuanyuan.run/monasca/persister:latest
配置说明
环境变量
| 变量名 | 默认值 | 描述 |
|---|---|---|
DEBUG | false | 若为true，启用调试日志 |
VERBOSE | true | 若为true，启用信息日志 |
ZOOKEEPER_URI | zookeeper:2181 | Zookeeper的主机和端口 |
KAFKA_URI | kafka:9092 | Kafka的主机和端口 |
KAFKA_WAIT_FOR_TOPICS | alarm-state-transitions,metrics | 启动时等待的Kafka主题列表 |
INFLUX_HOST | influxdb | InfluxDB的主机名 |
INFLUX_PORT | 8086 | InfluxDB的端口 |
INFLUX_USER | mon_persister | InfluxDB用户名 |
INFLUX_PASSWORD | password | InfluxDB密码 |
INFLUX_DB | mon | InfluxDB数据库名 |
自定义配置文件
如需覆盖更多配置值，可通过挂载文件替换/etc/monasca-persister/persister.conf.j2（Jinja2模板）。若不需要Jinja2格式化，可设置环境变量CONFIG_TEMPLATE=false。注意：即使禁用Jinja2，仍需覆盖.j2后缀的模板文件，因为容器会在运行时将模板复制为最终配置文件。
配置文件模板源码可在https://github.com/hpcloud-mon/monasca-docker/blob/master/monasca-persister-python/persister.conf.j2。运行时可通过以下命令查看生成的最终配置文件：
bashdocker exec -it <容器ID> cat /etc/monasca-persister/persister.conf
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 persister 镜像标签
docker pull docker.xuanyuan.run/monasca/persister:<标签>
DockerHub 原生拉取命令
docker pull monasca/persister:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
