f114773d78
All checks were successful
Test and Publish Templates / test-and-publish (push) Successful in 40s
56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
# Log Client (Promtail)
|
|
|
|
Ships Docker and system logs to Log Server. Zero configuration!
|
|
|
|
## Quick Start
|
|
|
|
1. **Configure** (edit `config/service.env`):
|
|
```bash
|
|
LOGSERVER_HOST=<server-ip> # Your log server IP
|
|
LOGSERVER_PORT=3100 # Default Loki port
|
|
LOKI_USER=logclient # Default username
|
|
LOKI_PASSWORD=<password> # Get from server admin
|
|
```
|
|
|
|
2. **Install**:
|
|
```bash
|
|
dropshell install logclient
|
|
```
|
|
|
|
That's it! Logs are now shipping to your central server.
|
|
|
|
## What Gets Sent
|
|
- All Docker container logs (via Docker API)
|
|
- System logs (/var/log/syslog)
|
|
- Auth logs (/var/log/auth.log)
|
|
- Hostname is automatically included
|
|
|
|
## View Your Logs
|
|
Go to: `http://<logserver-ip>:3000`
|
|
- Click Dashboards → Central Logs
|
|
- Your server's logs appear with its hostname
|
|
|
|
## Features
|
|
- **Zero maintenance** - Just runs
|
|
- **Lightweight** - ~20MB RAM
|
|
- **Automatic** - Finds all containers
|
|
- **Labeled** - Hostname included automatically
|
|
|
|
## Simple Authentication
|
|
Just a username/password - much simpler than ELK's API key system!
|
|
|
|
## Troubleshooting
|
|
Check if client is running:
|
|
```bash
|
|
./status.sh
|
|
```
|
|
|
|
View client logs:
|
|
```bash
|
|
./logs.sh
|
|
```
|
|
|
|
Test connection to server:
|
|
```bash
|
|
nc -zv <logserver-ip> 3100
|
|
``` |