Daniel Nashed's Blog

Domino Prometheus exporter -- Support for downtime statistics

Measuring downtime is an interesting challenge and can be tricky.Here is an idea I am working on.
In the first step I always remove the .prom files when the task was shutdown.
Now I am keeping domino.prom and only keep the stats that make still sense if the server is down.
As long the Node Exporter is still running, the statistics are still provided over the /metric endpoint.

DominoHealth_stat_update_timestamp

Updated whenever the stats are updated.
If the timestamp is not changing over a certain time, Grafana can detect that a server is down.


Maintenance status?

But what if the server is down for maintenance?

I added a way to set maintenance for a server via "tell domprom maintenance .. commands".

DominoHealth_maintenance_status
Provides the current status

DominoHealth_maintenance_start_timestamp
Provides the start time of the maintenance window

DominoHealth_maintenance_end_timestamp
Provides the end time of the maintenance window

In addition the statistics will report the last update time for the stats. And also if the server is restricted
It took me a moment to get the statistics right including showing the configuration.
The maintenance window is stored in memory and in notes.ini to preserve it at server restart.

I think this makes sense for uptime monitoring which will be part of a separate Grafana dashboard.

tell domprom status

01/27/2026 00:25:20   Collection  Interval :   64 seconds)
01/27/2026 00:25:20   Transaction Interval :  180 seconds)
01/27/2026 00:25:20   I/O Stats   Interval :  -Disabled-)
01/27/2026 00:25:20   Statistics File      :  /local/notesdata/domino/stats/domino.prom
01/27/2026 00:25:20   Transactions File    :  /local/notesdata/domino/stats/domino_trans.prom
01/27/2026 00:25:20   Maintenance start    :  01/27/2026 00:09:02 (since 16.28 minutes)
01/27/2026 00:25:20   Maintenance end      :  01/27/2026 01:49:02 (will end in 1.40 hours)


# HELP DominoHealth_Exporter_Build Domino Prometheus Exporter build version 1.0.3
# TYPE DominoHealth_Exporter_Build gauge
DominoHealth_Exporter_Build 10003
# HELP DominoHealth_stat_update_timestamp Domino Statistics last update epoch time
# TYPE DominoHealth_stat_update_timestamp gauge
DominoHealth_stat_update_timestamp 1769469174
# HELP DominoHealth_maintenance_start_timestamp Start of maintenance window in epoch time (01/27/2026 00:09:02)
# TYPE DominoHealth_maintenance_start_timestamp gauge
DominoHealth_maintenance_start_timestamp 1769472542
# HELP DominoHealth_maintenance_end_timestamp End of maintenance window in epoch time (01/27/2026 01:49:02)
# TYPE DominoHealth_maintenance_end_timestamp gauge
DominoHealth_maintenance_end_timestamp 1769478542
# HELP DominoHealth_maintenance_status Domino maintenance status
# TYPE DominoHealth_maintenance_status gauge
DominoHealth_maintenance_status 1
# HELP DominoHealth_server_restricted_status Domino server restricted status
# TYPE DominoHealth_server_restricted_status gauge
DominoHealth_server_restricted_status 4
# HELP DominoHealth_stat_shutdown_timestamp Domino statistic shutdown epoch time
# TYPE DominoHealth_stat_shutdown_timestamp gauge
DominoHealth_stat_shutdown_timestamp 1769472773

• Comments [0]