SimpleHealthMonitor
SimpleHealthMonitor is een Joomla System Plugin die de technische gezondheid van een Joomla-website bewaakt.
De plugin voert een aantal ingebouwde health checks uit, berekent een Health Score en publiceert een beveiligd JSON-endpoint dat kan worden gebruikt door externe monitoringdiensten zoals Uptime Kuma, Zabbix en andere HTTP-monitoringtools.
Features
- Joomla 6 native
- Compatibel met Joomla 5.4
- PHP 8.1 of hoger
- Geen database-tabellen
- Geen externe services
- Beveiligd JSON Health Endpoint
- Configureerbare Health Score
- Overzichtelijke backendstatus
- Volledig gebaseerd op Joomla Core API's
- Beschikbaar in vijf talen
Health Checks
Versie 1.0 bevat de volgende health checks.
| Health Check | Beschrijving |
|---|---|
| Content | Controleert of de frontend correct bereikbaar is. |
| Controleert of Joomla e-mail kan verzenden. | |
| Scheduler | Controleert of de Joomla Scheduler actief is. |
Iedere health check retourneert één van de volgende statussen:
- OK
- FAILED
- UNKNOWN
Health Score
Iedere health check kent een eigen penalty.
De totale Health Score is de som van alle penalties.
Wanneer de totale score gelijk is aan of hoger is dan de ingestelde threshold, wordt de website als ongezond beschouwd.
Hiermee kan onderscheid worden gemaakt tussen kleine waarschuwingen en kritieke problemen.
Health Endpoint
SimpleHealthMonitor publiceert een beveiligd JSON-endpoint.
Bijvoorbeeld:
https://example.com/?healthcheck=<token>De exacte endpoint-URL wordt automatisch weergegeven in de pluginconfiguratie.
HTTP-statuscodes
| HTTP | Betekenis |
|---|---|
| 200 | Website is gezond. |
| 403 | Ongeldig Health Token. |
| 503 | Health Score overschrijdt de ingestelde threshold. |
Het JSON-resultaat bevat onder andere:
- algemene healthstatus;
- Health Score;
- threshold;
- resultaten van alle health checks;
- aanvullende detailinformatie;
- eventuele aanbevolen acties.
Installatie
- Installeer de plugin via Systeem → Installeren.
- Publiceer de plugin.
- Open de pluginconfiguratie.
- Stel een uniek Health Token in.
- Configureer de gewenste Health Score threshold.
- Sla de configuratie op.
Na het opslaan worden de actuele Health Status, Health Score en de endpoint-URL automatisch weergegeven.
Configuratie
SimpleHealthMonitor gebruikt uitsluitend Joomla Plugin Parameters.
De plugin:
- maakt geen database-tabellen aan;
- installeert geen cronjobs;
- gebruikt geen externe services.
Architectuur
SimpleHealthMonitor volgt de Joomla Core-architectuur en houdt businesslogica en presentatie strikt gescheiden.
Belangrijke uitgangspunten zijn:
- kleine services met één verantwoordelijkheid;
- uniforme
HealthResult-objecten; - centrale
HealthService; - duidelijke scheiding tussen businesslogica en presentatie;
- geen duplicatie van businesslogica.
Meer informatie is beschikbaar in ARCHITECTURE.md.
Compatibiliteit
| Platform | Ondersteund |
|---|---|
| Joomla 6 | ✅ |
| Joomla 5.4 | ✅ |
| PHP 8.1+ | ✅ |
Documentatie
Voor aanvullende informatie zijn de volgende documenten beschikbaar:
- ARCHITECTURE.md — softwarearchitectuur
- CHANGELOG.md — wijzigingen per release
- ROADMAP.md — geplande toekomstige ontwikkelingen
Een uitgebreide gebruikershandleiding is beschikbaar via de projectwebsite.
Licentie
GNU General Public License versie 2 of later (GPL-2.0-or-later).
Auteur
SimpleHealthMonitor
Een lichtgewicht Joomla System Plugin voor het bewaken van de technische gezondheid van Joomla-websites, ontwikkeld volgens de Joomla Core-conventies.