dropshell-templates/logclient

Log Client (Promtail)

Ships Docker and system logs to Log Server. Zero configuration!

Quick Start

1. Configure (edit config/service.env):

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:

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:

./status.sh

View client logs:

./logs.sh

Test connection to server:

nc -zv <logserver-ip> 3100