dropshell-templates/logserver/README.md

Log Server (Loki + Grafana)

Central log server using Grafana + Loki. MUCH simpler than ELK/Kibana!

Quick Start

1. Install

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:

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:

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