f114773d78
All checks were successful
Test and Publish Templates / test-and-publish (push) Successful in 40s
73 lines
1.7 KiB
Markdown
73 lines
1.7 KiB
Markdown
# Log Server (Loki + Grafana)
|
|
|
|
Central log server using Grafana + Loki. MUCH simpler than ELK/Kibana!
|
|
|
|
## Quick Start
|
|
|
|
1. **Install**
|
|
```bash
|
|
dropshell install logserver
|
|
```
|
|
|
|
2. **Access Web UI**
|
|
- URL: `http://<server-ip>:3000`
|
|
- Login: `admin` / `changeme` (set in service.env)
|
|
|
|
3. **View Logs**
|
|
- Click **Dashboards** (4 squares icon)
|
|
- Click **"Central Logs"**
|
|
- All logs from all servers appear!
|
|
|
|
## For Client Servers
|
|
|
|
On each server that should send logs here:
|
|
|
|
1. Edit `logclient/config/service.env`:
|
|
```bash
|
|
LOGSERVER_HOST=<this-server-ip>
|
|
LOGSERVER_PORT=3100
|
|
LOKI_USER=logclient # Default username
|
|
LOKI_PASSWORD=<your-password> # From server's service.env
|
|
```
|
|
|
|
2. Install the client:
|
|
```bash
|
|
dropshell install logclient
|
|
```
|
|
|
|
## Features
|
|
- **Super simple interface** - Just one dashboard
|
|
- **Lightweight** - Uses 10x less resources than ELK
|
|
- **Real-time** - Logs appear instantly
|
|
- **Multi-server** - See all servers in one place
|
|
- **Automatic labels** - Filter by hostname, container, etc.
|
|
|
|
## Security
|
|
- Loki endpoint requires authentication (HTTP Basic Auth)
|
|
- Default: `logclient` / `changeme`
|
|
- **IMPORTANT**: Change `LOKI_PASSWORD` in service.env!
|
|
|
|
## Ports
|
|
- `3000` - Grafana Web UI
|
|
- `3100` - Loki API (authenticated)
|
|
|
|
## How to Use
|
|
|
|
### Filter by Server
|
|
- Use the "Server" dropdown at the top
|
|
- Or click any `hostname` label
|
|
|
|
### Filter by Container
|
|
- Click any `container_name` label
|
|
|
|
### Search Text
|
|
- Use the search box in each panel
|
|
|
|
### Time Range
|
|
- Top-right corner - adjust as needed
|
|
|
|
## Why This Instead of ELK?
|
|
- **10x simpler** - One clean dashboard vs Kibana complexity
|
|
- **10x smaller** - ~200MB RAM vs 2-3GB for ELK
|
|
- **Zero configuration** - Just works
|
|
- **Fast setup** - No index patterns, mappings, or complexity |