friendlyfriend/prometheus-immich-exporter Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Immich Prometheus Exporter

概述

Immich Prometheus Exporter 是一个轻量级工具，用于收集 Immich 应用的关键监控指标，并通过 Prometheus 兼容的端点暴露，以便集成到监控系统中。该导出器可抓取用户数量、相册统计、媒体文件存储使用量等核心指标，帮助管理员实时掌握 Immich 服务状态。

特性

• 轻量级设计：基于精简运行时，资源占用低，适合边缘环境与容器部署
• 核心指标覆盖：支持用户数、相册数、媒体文件总数、存储占用量等关键业务指标
• 配置简单：通过环境变量快速配置，无需复杂配置文件
• Prometheus 兼容：默认暴露 /metrics 端点，支持 Prometheus 自动发现

使用场景

• 个人或家庭服务器中监控 Immich 实例的存储增长趋势
• 企业环境下跟踪用户活动与资源分配情况
• 集成 Grafana 构建 Immich 专属监控面板，实现可视化与告警

部署示例

Docker Run 快速启动

bash
docker run -d \
  --name immich-exporter \
  -p 9273:9273 \
  -e IMMICH_URL=[***] \
  -e IMMICH_API_KEY=your_immich_api_key \
  -e SCRAPE_INTERVAL=30 \
  immich-prometheus-exporter:latest

Docker Compose 集成

yaml
version: '3.8'
services:
  immich-exporter:
    image: immich-prometheus-exporter:latest
    ports:
      - "9273:9273"
    environment:
      - IMMICH_URL=[***]
      - IMMICH_API_KEY=${IMMICH_API_KEY}
      - PORT=9273
      - SCRAPE_INTERVAL=60
    restart: unless-stopped

环境变量配置

注意事项

• 确保 Immich API 密钥拥有足够权限（需 ADMIN 角色或 metrics:read 权限）
• 网络配置需保证导出器可访问 Immich 服务的 API 端点（通常为 /api 路径）
• Prometheus 配置中需添加该导出器实例的 scrape_configs 以完成指标采集