marcinbudny/ravendb_exporter
自动构建
marcinbudny
RavenDB 4的Prometheus导出器，用于导出RavenDB 4的指标并支持Prometheus抓取，不支持4之前的版本，因旧版本API和认证机制不同。
下载次数: 0状态：自动构建维护者：marcinbudny仓库类型：镜像最近更新：2 年前
RavenDB 4 Prometheus导出器
镜像概述和主要用途
RavenDB 4 Prometheus导出器用于导出RavenDB 4的指标数据，支持Prometheus进行指标抓取。由于API和认证机制的差异，该导出器不支持RavenDB 4之前的版本。
核心功能和特性
- 导出RavenDB 4的多种关键指标，包括数据库文档数量、索引状态、请求计数、服务器资源使用等
- 支持通过命令行参数、环境变量和配置文件进行灵活配置
- 支持客户端证书认证，可配置CA证书、客户端证书及私钥
- 可设置请求超时时间和启用详细日志
- 暴露标准Prometheus抓取端点，便于Prometheus集成
使用场景和适用范围
适用于需要对RavenDB 4服务器及数据库进行监控的场景，可帮助运维人员实时掌握数据库性能、资源使用情况和索引状态，适用于生产、测试等各类环境。
详细使用方法和配置说明
安装方式
从源码安装
需配置Go 1.6+环境：
bashcd $GOPATH/src mkdir -p github.com/marcinbudny git clone https://github.com/marcinbudny/ravendb_exporter github.com/marcinbudny/ravendb_exporter cd github.com/marcinbudny/ravendb_exporter go build -o ravendb_exporter ./ravendb_exporter --ravendb-url=http://live-test.ravendb.net
使用Docker安装
基本用法：
bashdocker run -d -p 9440:9440 -e RAVENDB_URL=http://live-test.ravendb.net marcinbudny/ravendb_exporter
配置说明
导出器可通过命令行参数、环境变量和配置文件进行配置。配置文件格式详情可参考https://github.com/namsral/flag%E4%BB%93%E5%BA%93%E3%80%82
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
| --ravendb-url | RAVENDB_URL | http://localhost:8080 | RavenDB URL |
| --port | PORT | 9440 | 暴露抓取端点的端口 |
| --timeout | TIMEOUT | 10s | 调用RavenDB的超时时间 |
| --verbose | VERBOSE | false | 启用详细日志 |
| --ca-cert | CA_CERT | (空) | RavenDB服务器的CA公钥证书文件路径 |
| --use-auth | USE_AUTH | false | 若设置为true，将使用客户端证书进行RavenDB连接认证 |
| --client-cert | CLIENT_CERT | (空) | 用于认证的客户端公钥证书路径 |
| --client-key | CLIENT_KEY | (空) | 用于认证的客户端私钥路径 |
| --client-key-password | CLIENT_KEY_PASSWORD | (空) | 客户端私钥密码（若私钥已加密） |
Docker认证配置示例
bashdocker run -d \ -e RAVENDB_URL=https://a.myserver.ravendb.community \ -e CA_CERT=/certs/lets-encrypt-x3-cross-signed.crt \ -e USE_AUTH=true \ -e CLIENT_CERT=/certs/admin.client.certificate.myserver.crt \ -e CLIENT_KEY=/certs/admin.client.certificate.myserver.key \ -e CLIENT_KEY_PASSWORD=mypassword \ -v /path/to/certs/on/host:/certs \ -p 9440:9440 \ marcinbudny/ravendb_exporter
导出的指标
如需添加其他指标，请反馈。
ravendb_cpu_time_seconds_total 1613.68 # HELP ravendb_database_document_put_bytes_total 数据库文档写入字节数 # TYPE ravendb_database_document_put_bytes_total counter ravendb_database_document_put_bytes_total{database="Demo"} 405 # HELP ravendb_database_document_put_total 数据库文档写入次数 # TYPE ravendb_database_document_put_total counter ravendb_database_document_put_total{database="Demo"} 3 # HELP ravendb_database_documents 数据库中文档数量 # TYPE ravendb_database_documents gauge ravendb_database_documents{database="Demo"} 1063 # HELP ravendb_database_indexes 数据库中索引数量 # TYPE ravendb_database_indexes gauge ravendb_database_indexes{database="Demo"} 20 # HELP ravendb_database_mapindex_indexed_total 数据库映射索引已索引数量 # TYPE ravendb_database_mapindex_indexed_total counter ravendb_database_mapindex_indexed_total{database="Demo"} 952 # HELP ravendb_database_mapreduceindex_mapped_total 数据库映射-归约索引已映射数量 # TYPE ravendb_database_mapreduceindex_mapped_total counter ravendb_database_mapreduceindex_mapped_total{database="Demo"} 0 # HELP ravendb_database_mapreduceindex_reduced_total 数据库映射-归约索引已归约数量 # TYPE ravendb_database_mapreduceindex_reduced_total counter ravendb_database_mapreduceindex_reduced_total{database="Demo"} 0 # HELP ravendb_database_request_total 数据库请求总数 # TYPE ravendb_database_request_total counter ravendb_database_request_total{database="Demo"} 6179 # HELP ravendb_database_size_bytes 数据库大小（字节） # TYPE ravendb_database_size_bytes gauge ravendb_database_size_bytes{database="Demo"} 6.35568128e+08 # HELP ravendb_database_stale_indexes 数据库中过期索引数量 # TYPE ravendb_database_stale_indexes gauge ravendb_database_stale_indexes{database="Demo"} 0 # HELP ravendb_document_put_bytes_total 服务器级文档写入字节数 # TYPE ravendb_document_put_bytes_total counter ravendb_document_put_bytes_total 0 # HELP ravendb_document_put_total 服务器级文档写入次数 # TYPE ravendb_document_put_total counter ravendb_document_put_total 0 # HELP ravendb_is_leader 若为1表示节点是集群领导者，否则为0 # TYPE ravendb_is_leader gauge ravendb_is_leader 1 # HELP ravendb_mapindex_indexed_total 服务器级映射索引已索引数量 # TYPE ravendb_mapindex_indexed_total counter ravendb_mapindex_indexed_total 0 # HELP ravendb_mapreduceindex_mapped_total 服务器级映射-归约索引已映射数量 # TYPE ravendb_mapreduceindex_mapped_total counter ravendb_mapreduceindex_mapped_total 0 # HELP ravendb_mapreduceindex_reduced_total 服务器级映射-归约索引已归约数量 # TYPE ravendb_mapreduceindex_reduced_total counter ravendb_mapreduceindex_reduced_total 0 # HELP ravendb_request_total 服务器级请求总数 # TYPE ravendb_request_total counter ravendb_request_total 15530 # HELP ravendb_up RavenDB抓取是否成功（1为成功，0为失败） # TYPE ravendb_up gauge ravendb_up 1 # HELP ravendb_working_set_bytes 进程工作集大小 # TYPE ravendb_working_set_bytes gauge ravendb_working_set_bytes 1.651195904e+09
变更日志
0.3.0
- 支持密码保护的私钥
- 修复无法加载配置文件的问题 #1
0.2.0
- 更改指标名称以符合Prometheus规范
0.1.2
- 修复ravendb_database_stale_index_count指标名称
0.1.1
- 初始版本
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"