Prometheus Immich Exporter
A Prometheus exporter for self-hosted Immich that exposes server metrics for Grafana; active development has been retired in favor of ImmichStat.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
30/100 Low
- Maintained
- 5last commit 683 days ago
- Popular
- 3239 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 75no serious findings
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 42 days ago
- GitHub stars
- 39
- Open issues
- 1
- Last commit
- 2025-01-07
- License
- GPL-3.0
- Activity
- stale
Checked 18 days ago - source: GitHub (friendlyFriend4000/prometheus-immich-exporter)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Check that Prometheus sees the target From the machine running Prometheus, run curl http://localhost:9090/api/v1/targets after starting Prometheus. If the target you added is missing or shows as down, Prometheus cannot collect its metrics until the scrape settings or network access are fixed. source
- Keep a backup of prometheus.yml Use the YAML global section as a template when editing prometheus.yml, and keep a backup before changing defaults such as scrape_interval or external_labels. Invalid YAML or changed external labels can stop Prometheus from reloading or make metrics look different. source
- Example Node Exporter ports can clash The Node Exporter examples listen on 127.0.0.1:8080, 8081, and 8082, so check those ports are free before starting them. If they are already used, the examples will not start or you will get confusing port conflicts. source
- Docker setup Set IMMICH_HOST, IMMICH_PORT, and IMMICH_API_TOKEN, then expose port 8000 for Prometheus. source
Fetched 38 days ago - each note links to its source
Variants
Alternatives (12)
- Amazon CloudWatch - Amazon CloudWatch is a monitoring service for AWS cloud resources and the applications running on AWS.
- Better Stack - AI-driven monitoring platform providing incident management, real-time logs, uptime, traces, error tracking, infrastructure analytics, and…
- Datadog - Datadog Agent is an on-host monitoring agent that collects metrics, logs, and traces from hosts, containers, and Kubernetes clusters and se…
- DeepFlow - Unify your cloud-native monitoring with zero-code eBPF, advanced profiling, and 10x storage efficiency.
- Grafana Loki - Grafana Loki is an open-source log aggregation system.
- Graylog - Graylog is a centralized log management platform built on open standards for capturing, storing, and analyzing terabytes of machine data in…
- InfluxDB - InfluxDB is an open source time series database with no external dependencies.
- Kibana - Kibana is the data visualization layer for querying, analyzing, and managing data stored in Elasticsearch.
- New Relic - Pinpoint and solve performance issues in your Ruby, Java, .NET, PHP and Python apps with real user, application and server monitoring.
- Prometheus - Prometheus is a systems and service monitoring system.
- Splunk - Splunk is a self-hosted platform for collecting, indexing, searching, and analyzing log and security data, helping homelabbers and operatio…
- VictoriaMetrics - VictoriaMetrics is a fast, cost-effective, and scalable open-source time-series database that stores long-term monitoring metrics, accepts…
Checked 40 days ago - source: AlternativeTo
Common questions
After adding the prometheus-immich-exporter target, how can I check whether Prometheus is actually scraping it?
From the machine running Prometheus, check the local targets endpoint after starting Prometheus. If the target is missing or shows as down, scrape settings or network access need to be fixed.
What should I preserve before editing Prometheus defaults such as scrape_interval or external_labels for the exporter?
Back up prometheus.yml before changing defaults such as scrape_interval or external_labels. Invalid YAML or changed external labels can stop Prometheus from reloading or make metrics look different.
Where should I send problem reports for FriendlyFriend’s prometheus-immich-exporter Docker image?
The Unraid support thread points users to GitHub issues for problem reports. It also links to the Docker Hub image and GitHub repository.
Besides Prometheus metrics, what other Immich observability data can be exported?
Immich provides performance metrics primarily as Prometheus metrics. It also allows exporting traces because of OpenTelemetry instrumentation.
Answers sourced from docs.immich.app, forums.unraid.net, github.com, github.com
Community
- Immich - High-performance self-hosted backup photos/videos ... - Reddit (reddit)
- [Support] FriendlyFriend - Application Dockers - Unraid (forum)
- I asked ChatGPT to advice me how to manage metadata in Immich (reddit)
- FriendlyFriend's Content - Unraid (forum)
- FAQ - Prometheus Monitoring System (forum)
Collected 48 days ago - public community threads