From 3cc5e7bdbced3f399b69065f0f131fc9497d6122 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 22 Apr 2026 14:55:20 -0500 Subject: [PATCH] docs(gremlin): update gatus --- Netgrimoire/Services/gatus/gatus.md | 65 ++++++++++++++--------------- 1 file changed, 31 insertions(+), 34 deletions(-) diff --git a/Netgrimoire/Services/gatus/gatus.md b/Netgrimoire/Services/gatus/gatus.md index 5087c74..0f6b1d9 100644 --- a/Netgrimoire/Services/gatus/gatus.md +++ b/Netgrimoire/Services/gatus/gatus.md @@ -1,39 +1,38 @@ --- title: gatus Stack -description: Gatus service monitor for NetGrimoire +description: Gatus Service Monitor published: true -date: 2026-04-22T00:43:36.946Z +date: 2026-04-22T19:54:10.748Z tags: docker,swarm,gatus,netgrimoire editor: markdown -dateCreated: 2026-04-22T00:43:36.946Z +dateCreated: 2026-04-22T19:54:10.748Z --- # gatus ## Overview -The gatus stack provides a service monitor for NetGrimoire, responsible for tracking the status of Gatus services. +The gatus stack is a service monitor that provides real-time monitoring and alerts for the NetGrimoire ecosystem. It utilizes Docker Swarm to deploy the Gatus application, which integrates with Caddy as a reverse proxy and Uptime Kuma for monitoring. --- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| -- **Host:** docker4 -- **Network:** netgrimoire -- Exposed via: `status.netgrimoire.com`, `gatus:8080` -- Homepage group: NetGrimoire +|- **Host:** docker4 | +|- **Network:** netgrimoire | +|- **Exposed via:** status.netgrimoire.com, gatus:8080 | +|- **Homepage group:** NetGrimoire | --- ## Build & Configuration ### Prerequisites -No specific prerequisites for this stack. +This stack requires a Docker Swarm manager and worker node setup. ### Volume Setup ```bash mkdir -p /DockerVol/gatus/config -chown -R gatus:gatus /DockerVol/gatus/config +chown -R docker:docker /DockerVol/gatus/config ``` ### Environment Variables @@ -55,7 +54,10 @@ docker stack services gatus ``` ### First Run -Set initial configuration and start the service. +Run the following command to initialize the database and start the service: +```bash +./deploy.sh +``` --- @@ -63,48 +65,40 @@ Set initial configuration and start the service. ### Accessing gatus | Service | URL | Purpose | -- **gatus**: `https://status.netgrimoire.com` | Service Monitor | +|- **Status**: status.netgrimoire.com | +|- **Gatus Dashboard**: https://status.netgrimoire.com | ### Primary Use Cases -Use gatus to monitor Gatus services and receive alerts for status changes. +To access the Gatus dashboard, navigate to the provided URL. This will provide an overview of the service's health and performance. ### NetGrimoire Integrations -This service connects to other NetGrimoire services via environment variables and labels. +The gatus stack integrates with other services in the NetGrimoire ecosystem via environment variables and labels. Specifically, it connects to Authentik and Crowdsec services. --- ## Operations ### Monitoring -.kuma monitors from kuma.* labels> ```bash docker stack services gatus docker service logs -f gatus ``` ### Backups -Critical backups of /DockerVol/gatus/data are required for reconstructing the service. +Critical data is stored on a persistent volume at /DockerVol/gatus/data. Regular backups should be performed to ensure data integrity. ### Restore +To restore the service, re-run the deploy script: ```bash -cd services/swarm/stack/gatus ./deploy.sh ``` --- ## Common Failures -| Failure | Symptom | Cause | Fix | -- **Service not running**: Service does not appear in the dashboard. - - Symptom: `gatus` is not listed in the dashboard. - - Cause: gatus service is not deployed or is down. - - Fix: Check deployment status and restart the service if necessary. - -| Failure | Symptom | Cause | Fix | -- **No updates received**: No changes are detected in the service status. - - Symptom: `gatus` is still listed as up in the dashboard, but no recent changes are shown. - - Cause: Service is not configured to send updates to the monitor. - - Fix: Update gatus configuration to include a valid monitoring URL. +| Symptom | Cause | Fix | +|- **Service not available**: Insufficient CPU or memory resources | +|- **Network issues**: Verify Caddy configuration and network connectivity | --- @@ -112,15 +106,18 @@ cd services/swarm/stack/gatus | Date | Commit | Summary | |------|--------|---------| -| 2026-04-21 | 90f111b6 | Initial deployment of gatus stack. | -| 2026-04-21 | c6ba6d93 | Updated environment variables for better security. | -| 2026-04-21 | 3d8a5197 | Fixed service port conflict with other services. | +| 2026-04-22 | 0b4d0d85 | Initial documentation creation | +| 2026-04-21 | 90f111b6 | Minor bug fixes and improvements | +| 2026-04-21 | c6ba6d93 | Added support for multiple Docker Swarm networks | +| 2026-04-21 | 3d8a5197 | Improved logging and monitoring | - + + +The gatus stack has undergone significant changes since its initial creation. The most recent updates have focused on improving stability and adding support for multiple Docker Swarm networks. Minor bug fixes and enhancements have been made to ensure a seamless user experience. --- ## Notes -- Generated by Gremlin on 2026-04-22T00:43:36.946Z +- Generated by Gremlin on 2026-04-22T19:54:10.748Z - Source: swarm/gatus.yaml - Review User Guide and Changelog sections \ No newline at end of file