lucabecker42/ollama-exporter

Ollama Prometheus Exporter

极简的指标导出工具，用于抓取Ollama服务器数据并在/metrics端点暴露Prometheus指标，同时提供基础的/health健康检查端点。

核心功能

• 指标收集: 支持Ollama版本信息、模型清单、运行中模型、VRAM使用情况、抓取统计等指标
• 端点支持: 提供/metrics（指标）和/health（健康检查）两个端点
• 可配置性: 支持端口、抓取间隔、Ollama主机地址、超时时间、日志级别等参数配置

使用场景

• 监控Ollama服务器的运行状态和资源使用情况
• 集成Prometheus和Grafana实现Ollama服务的可视化监控
• 自动化运维中对Ollama服务的健康状态检查

配置说明

快速启动（本地）

1. 安装依赖

bash
npm install

2. 运行

bash
npm start -- \
  --port 8000 \
  --interval 30 \
  --ollama-host localhost:11434 \
  --api-timeout 30 \
  --log-level INFO

访问http://localhost:8000/metrics查看指标，http://localhost:8000/health检查健康状态。

Systemd安装

将exporter安装到/opt/ollama-exporter，创建专用用户，构建TypeScript项目并安装依赖。服务通过/etc/ollama-exporter.env配置：

bash
sudo bash ./install-systemd.sh

环境变量默认值（位于/etc/ollama-exporter.env）：

bash
PORT=8000
INTERVAL=30
OLLAMA_HOST=localhost:11434
API_TIMEOUT=30
LOG_LEVEL=INFO

服务管理命令：

bash
sudo systemctl status ollama-exporter
sudo systemctl restart ollama-exporter
sudo systemctl enable ollama-exporter

卸载命令：

bash
sudo systemctl disable --now ollama-exporter
sudo rm -f /etc/systemd/system/ollama-exporter.service
sudo rm -f /etc/ollama-exporter.env
sudo rm -rf /opt/ollama-exporter
sudo systemctl daemon-reload

Docker部署

构建镜像：

bash
docker build -t ollama-exporter:latest .

运行容器（调整OLLAMA_HOST为Ollama可访问的地址）：

bash
docker run --rm -p 8000:8000 \
  -e PORT=8000 \
  -e INTERVAL=30 \
  -e OLLAMA_HOST=host.docker.internal:11434 \
  -e API_TIMEOUT=30 \
  -e LOG_LEVEL=INFO \
  --name ollama-exporter \
  docker.xuanyuan.run/ollama-exporter:latest

配置选项

• -p, --port: 服务监听端口（默认：8000）
• -i, --interval: 指标抓取间隔（单位：秒，默认：30）
• --ollama-host: Ollama服务器地址和端口（默认：localhost:***）
• -t, --api-timeout: Ollama API调用超时时间（单位：秒，默认：30）
• -l, --log-level: 日志级别（可选值：DEBUG、INFO、WARNING、ERROR，默认：INFO）
• --validate-config: 验证配置并退出

Prometheus抓取配置示例

yaml
- job_name: 'ollama-exporter'
  static_configs:
    - targets: ['exporter-hostname:8000']

维护者

Luca Becker — *** — [***]

许可证

GPL-3.0-only