36e580f180
Add Dozzle for simple, real-time Docker container log viewing. Features: - Real-time log streaming from all containers - Search and filter capabilities - Multi-container side-by-side view - Container resource statistics (CPU, memory) - No database required (reads directly from Docker) - Minimal footprint (~4MB image) Configuration: - Restricted to local network only (local-only middleware) - Auto-discovery of all running containers - Dark/light theme support Includes quickstart guide and comprehensive documentation.
133 lines
3.2 KiB
Markdown
133 lines
3.2 KiB
Markdown
# Dozzle - Quick Start
|
|
|
|
## Access Now
|
|
|
|
**Open:** https://logs-docker.fig.systems
|
|
|
|
## What You'll See
|
|
|
|
- List of all running Docker containers
|
|
- Click any container to see its logs
|
|
- Real-time streaming (updates automatically)
|
|
- Search box at top to filter logs
|
|
|
|
## Common Tasks
|
|
|
|
### View logs from a specific container
|
|
1. Click the container name from the list
|
|
2. Logs appear instantly
|
|
|
|
### Search for errors
|
|
1. Open any container's logs
|
|
2. Type `error` in the search box at top
|
|
3. Only matching lines show
|
|
|
|
### View multiple containers at once
|
|
1. Open first container
|
|
2. Click the **"+"** button in the header
|
|
3. Select another container
|
|
4. View side-by-side
|
|
|
|
### Download logs
|
|
1. Open container logs
|
|
2. Click **"Download"** button (top right)
|
|
3. Saves visible logs as .txt file
|
|
|
|
### View older logs
|
|
- Scroll up in the log view
|
|
- Note: Only shows what Docker has stored (default: all logs)
|
|
|
|
### Pause live streaming
|
|
- Click the **pause button** (⏸️) to stop auto-scrolling
|
|
- Useful when examining specific log entries
|
|
- Click **play** (▶️) to resume
|
|
|
|
## Settings
|
|
|
|
Click the **gear icon** (⚙️) to:
|
|
- Change theme (dark/light)
|
|
- Adjust font size
|
|
- Change date/time format
|
|
- Toggle compact mode
|
|
|
|
## Limitations
|
|
|
|
**Dozzle shows logs Docker currently has.** For logs older than a week:
|
|
|
|
1. **Check Docker's log retention:**
|
|
```bash
|
|
docker inspect <container-name> | grep -A 5 "LogConfig"
|
|
```
|
|
|
|
2. **If logs are rotating too quickly**, configure Docker log rotation:
|
|
|
|
Edit `/etc/docker/daemon.json`:
|
|
```json
|
|
{
|
|
"log-driver": "json-file",
|
|
"log-opts": {
|
|
"max-size": "50m",
|
|
"max-file": "5"
|
|
}
|
|
}
|
|
```
|
|
|
|
This keeps ~250MB of logs per container.
|
|
|
|
3. **Restart Docker:**
|
|
```bash
|
|
sudo systemctl restart docker
|
|
```
|
|
|
|
4. **Recreate containers** (they inherit new log settings)
|
|
|
|
## vs Loki/Grafana
|
|
|
|
| Feature | Dozzle | Loki/Grafana |
|
|
|---------|--------|--------------|
|
|
| Setup | ✅ Simple (1 container) | ⚠️ Complex (3 containers + config) |
|
|
| Real-time logs | ✅ Excellent | ✅ Good |
|
|
| Search | ✅ Simple text search | ✅ Advanced LogQL queries |
|
|
| History | ⚠️ Limited to Docker's retention | ✅ Configurable retention |
|
|
| Multi-server | ⚠️ Requires setup | ✅ Built-in |
|
|
| Log aggregation | ❌ No | ✅ Yes |
|
|
| Alerts | ❌ No | ✅ Yes |
|
|
| Resource usage | ✅ Minimal (~10MB) | ⚠️ Higher (~200MB+) |
|
|
|
|
**Recommendation:** Use both!
|
|
- **Dozzle** for quick log checks and real-time monitoring
|
|
- **Loki** for historical analysis and complex queries
|
|
|
|
## Tips
|
|
|
|
1. **Bookmark the URL** - Quick access to your logs
|
|
2. **Use keyboard shortcuts:**
|
|
- `/` - Focus search
|
|
- `Space` - Pause/resume
|
|
- `Esc` - Clear search
|
|
3. **Multi-tab viewing** - Open different containers in browser tabs
|
|
4. **Container stats** - Click "Stats" tab to see CPU/memory usage
|
|
|
|
## Troubleshooting
|
|
|
|
**No containers showing?**
|
|
```bash
|
|
docker logs dozzle
|
|
```
|
|
|
|
**Can't access the web UI?**
|
|
```bash
|
|
# Check if Dozzle is running
|
|
docker ps | grep dozzle
|
|
|
|
# Check Traefik routing
|
|
docker logs traefik | grep dozzle
|
|
```
|
|
|
|
**Logs are truncated?**
|
|
- Docker may be rotating logs too aggressively
|
|
- See "Limitations" section above to increase retention
|
|
|
|
---
|
|
|
|
**Need more help?** Check the full README.md in this directory.
|