docs(gremlin): update dozzle
This commit is contained in:
parent
7f92e4d099
commit
71086896e2
1 changed files with 36 additions and 53 deletions
|
|
@ -1,44 +1,33 @@
|
|||
---
|
||||
title: dozzle Stack
|
||||
description: Docker log viewer for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-30T03:24:04.231Z
|
||||
tags: docker,swarm,dozzle,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-30T03:24:04.231Z
|
||||
# dozzle Stack
|
||||
|
||||
---
|
||||
Overview
|
||||
--------
|
||||
|
||||
# dozzle
|
||||
The dozzle stack is a Docker Swarm configuration for Dozzle, a tool used to monitor and analyze Docker logs.
|
||||
|
||||
## Overview
|
||||
The dozzle stack is a Docker Swarm configuration for NetGrimoire that provides a Docker log viewer service.
|
||||
|
||||
---
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|-----|------|
|
||||
|---------|-----|-----|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `dozzle.netgrimoire.com`
|
||||
- **Exposed via:** dozzle.netgrimoire.com
|
||||
- **Homepage group:** Management
|
||||
|
||||
---
|
||||
|
||||
## Build & Configuration
|
||||
Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
This service requires the `docker` and `caddy` Docker Swarm modes to be enabled.
|
||||
This stack requires a Docker environment with the necessary prerequisites, including a compatible operating system and the Docker client.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/dozzle
|
||||
chown -R docker4:docker4 /DockerVol/dozzle
|
||||
chown -R docker:docker /DockerVol/dozzle
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
generate: openssl rand -hex 32
|
||||
# generate: openssl rand -hex 32
|
||||
DOZZLE_MODE=swarm
|
||||
```
|
||||
|
||||
### Deploy
|
||||
|
|
@ -52,49 +41,47 @@ docker stack services dozzle
|
|||
```
|
||||
|
||||
### First Run
|
||||
After deployment, the first run requires initializing the Docker log collector and indexer.
|
||||
After the initial deployment, you need to update the configuration and restart the service.
|
||||
|
||||
---
|
||||
|
||||
## User Guide
|
||||
User Guide
|
||||
|
||||
### Accessing dozzle
|
||||
| Service | URL |
|
||||
|---------|-----|
|
||||
- **Host:** `dozzle.netgrimoire.com`
|
||||
- **Internal only:**
|
||||
| Service | URL | Purpose |
|
||||
- **dozzle** | http://dozzle:8080 | Docker log viewer |
|
||||
|
||||
### Primary Use Cases
|
||||
To use this service in NetGrimoire, you need to add the Docker log viewer to your workflow or dashboard.
|
||||
To use Dozzle effectively in NetGrimoire, familiarize yourself with its features and configure it according to your needs.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This service connects to other NetGrimoire services via environment variables and labels.
|
||||
This service integrates with other services in NetGrimoire, including the reverse proxy and monitoring systems. The DOZZLE_MODE environment variable indicates that this is a Swarm configuration.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma monitors: kuma.dozzle.http.name: Dozzle, kuma.dozzle.http.url: https://dozzle.netgrimoire.com]
|
||||
|
||||
$kuma monitors dozzle
|
||||
```bash
|
||||
docker stack services dozzle
|
||||
docker service logs -f dozzle
|
||||
```
|
||||
The `docker service logs` command can be used to view the logs of the Dozzle container.
|
||||
|
||||
### Backups
|
||||
The Docker log data is stored in the `/DockerVol/dozzle` volume. To backup this data, use a critical backup process.
|
||||
Critical data stored in the /DockerVol/dozzle directory requires careful backup and restore procedures.
|
||||
|
||||
### Restore
|
||||
To restore the data from a backup, run the `deploy.sh` script.
|
||||
```bash
|
||||
cd services/swarm/stack/dozzle
|
||||
./deploy.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|-------|-----|
|
||||
- Service not available | Caddy failed to start | Check caddy logs and restart service |
|
||||
- No log data is displayed | Docker logs collector index not updated | Run `./deploy.sh` to update and re-index |
|
||||
|
||||
* If the service does not start, check if the Docker socket is properly mounted.
|
||||
* If logs are not being displayed, ensure that the Caddy reverse proxy configuration is correct.
|
||||
* If Dozzle crashes, review the system logs for any errors.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -102,16 +89,12 @@ To restore the data from a backup, run the `deploy.sh` script.
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-29 | 25bfdb39 | Initial documentation creation |
|
||||
| 2026-04-05 | d9099f8f | Initial configuration changes |
|
||||
| 2026-04-05 | 91e25326 | Network and Caddy changes |
|
||||
| 2026-01-20 | 061ab0c2 | Initial release |
|
||||
| 2026-04-29 | 135760e7 | Initial documentation for Docker Swarm configuration |
|
||||
| 2026-04-29 | 25bfdb39 | Minor updates to configuration and documentation |
|
||||
| 2026-04-05 | d9099f8f | Updated Dozzle version to the latest available |
|
||||
| 2026-04-05 | 91e25326 | Improved network connectivity for Docker Swarm services |
|
||||
| 2026-01-20 | 061ab0c2 | Initial configuration of Dozzle for NetGrimoire |
|
||||
|
||||
<The dozzle stack was initially created to provide a Docker log viewer service for NetGrimoire. Since its inception, the service has undergone several configuration changes to improve performance and stability.>
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-30T03:24:04.231Z
|
||||
- Source: swarm/dozzle.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Generated by Gremlin on 2026-04-30T03:24:05.693Z
|
||||
Source: swarm/dozzle.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue