From 669243f2da93c6692660323095cef0d5a2b2bc2a Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 22 Apr 2026 15:01:27 -0500 Subject: [PATCH] docs(gremlin): update gatus --- Netgrimoire/Services/gatus/gatus.md | 87 +++++++++++++++-------------- 1 file changed, 45 insertions(+), 42 deletions(-) diff --git a/Netgrimoire/Services/gatus/gatus.md b/Netgrimoire/Services/gatus/gatus.md index 0f6b1d9..74809f8 100644 --- a/Netgrimoire/Services/gatus/gatus.md +++ b/Netgrimoire/Services/gatus/gatus.md @@ -1,46 +1,54 @@ --- title: gatus Stack -description: Gatus Service Monitor +description: Gatus service monitor stack for NetGrimoire published: true -date: 2026-04-22T19:54:10.748Z +date: 2026-04-22T20:00:20.142Z tags: docker,swarm,gatus,netgrimoire editor: markdown -dateCreated: 2026-04-22T19:54:10.748Z +dateCreated: 2026-04-22T20:00:20.142Z --- # gatus ## Overview -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. - ---- +The gatus stack is a Docker Swarm service monitor that provides real-time monitoring and alerting for the NetGrimoire system. It consists of a single containerized application running on host docker4, exposing port 8080 to the internal network. ## 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 (via Caddy reverse proxy) +- **Homepage group:** NetGrimoire --- ## Build & Configuration ### Prerequisites -This stack requires a Docker Swarm manager and worker node setup. +To build and deploy the gatus stack, you need to have Docker installed on your system. ### Volume Setup ```bash mkdir -p /DockerVol/gatus/config -chown -R docker:docker /DockerVol/gatus/config +chown -R gatus:gatus /DockerVol/gatus/config ``` ### Environment Variables ```bash -PUID=1964 -PGID=1964 -TZ=America/Chicago -GATUS_CONFIG_PATH=/config/config.yaml +PUID="1964" +PGID="1964" +TZ="America/Chicago" +GATUS_CONFIG_PATH="/config/config.yaml" + +caddy-docker-proxy: + labels: + status.netgrimoire.com: true + +kuma: + labels: + monitor.url: https://status.netgrimoire.com + monitor.type: http ``` ### Deploy @@ -54,10 +62,7 @@ docker stack services gatus ``` ### First Run -Run the following command to initialize the database and start the service: -```bash -./deploy.sh -``` +After deploying the service, you need to configure the Caddy reverse proxy and Kuma monitoring system. --- @@ -65,14 +70,16 @@ Run the following command to initialize the database and start the service: ### Accessing gatus | Service | URL | Purpose | -|- **Status**: status.netgrimoire.com | -|- **Gatus Dashboard**: https://status.netgrimoire.com | +|-|-|-| +- **Gatus**: https://status.netgrimoire.com (via Caddy reverse proxy) ### Primary Use Cases -To access the Gatus dashboard, navigate to the provided URL. This will provide an overview of the service's health and performance. +To use the gatus service in NetGrimoire, you can integrate it with other services and tools. ### NetGrimoire Integrations -The gatus stack integrates with other services in the NetGrimoire ecosystem via environment variables and labels. Specifically, it connects to Authentik and Crowdsec services. +The gatus service connects to the following NetGrimoire services: + +- Crowdsec --- @@ -81,43 +88,39 @@ The gatus stack integrates with other services in the NetGrimoire ecosystem via ### Monitoring ```bash docker stack services gatus -docker service logs -f gatus +docker service logs gatus ``` ### Backups -Critical data is stored on a persistent volume at /DockerVol/gatus/data. Regular backups should be performed to ensure data integrity. +Critical data is stored in the `/DockerVol/gatus/data` directory. Regular backups are recommended. ### Restore -To restore the service, re-run the deploy script: -```bash -./deploy.sh -``` +To restore the gatus service, you need to redeploy it using the `./deploy.sh` script. --- ## Common Failures -| Symptom | Cause | Fix | -|- **Service not available**: Insufficient CPU or memory resources | -|- **Network issues**: Verify Caddy configuration and network connectivity | +- **Service not available**: Check if Caddy and Kuma services are running. +- **Kuma configuration issues**: Verify that the `kuma.config` file is correctly configured. +- **Caddy reverse proxy issues**: Ensure that the `caddy-docker-proxy` service is running. --- ## Changelog | Date | Commit | Summary | -|------|--------|---------| -| 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 | +|-|-|-| +| 2026-04-22 | a86dd887 | Initial deployment of gatus stack | +| 2026-04-22 | 0b4d0d85 | Updated Caddy labels for reverse proxy | +| 2026-04-21 | 90f111b6 | Added Kuma monitoring configuration | +| 2026-04-21 | c6ba6d93 | Fixed Caddy import issues | +| 2026-04-21 | 3d8a5197 | Updated environment variables | - - -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. +This stack has undergone significant changes since its initial deployment. The most recent updates include improved Caddy reverse proxy configuration and Kuma monitoring integration. --- ## Notes -- Generated by Gremlin on 2026-04-22T19:54:10.748Z +- Generated by Gremlin on 2026-04-22T20:00:20.142Z - Source: swarm/gatus.yaml - Review User Guide and Changelog sections \ No newline at end of file