Log Forwarding

smoxy kann CDN-Zugriffslogs in Echtzeit an einen externen Log-Aggregationsdienst weiterleiten. Dies ermöglicht es dir, deine Logs zu zentralisieren, eigene Dashboards zu erstellen und die Weiterleitung in deine bestehende Monitoring-Infrastruktur zu integrieren.

---

Wie Log Forwarding funktioniert

Log Forwarding wird auf Site-Ebene konfiguriert, erzeugt aber nur Logs für Hostnamen, bei denen CDN aktiviert ist. Dies ist ein wichtiger Unterschied:

• Eine Site kann mehrere Hostnamen zugewiesen haben.

• Nur Hostnamen mit aktivierter CDN-Funktionalität erzeugen Zugriffslogs.

• Hostnamen auf derselben Site, bei denen CDN nicht aktiviert ist, erscheinen nicht in den weitergeleiteten Logs.

• Jeder weitergeleitete Log-Eintrag gehört zum spezifischen Hostnamen, der die Anfrage empfangen hat.

Beispiel:

Hostname	CDN aktiviert	Logs weitergeleitet
www.example.com	Ja	Ja
api.example.com	Ja	Ja
staging.example.com	Nein	Nein

Obwohl alle drei Hostnamen dieselbe Site-Konfiguration nutzen, erzeugen nur www.example.com und api.example.com weitergeleitete Log-Einträge.

---

Voraussetzungen

• Eine Site mit mindestens einem Hostnamen, bei dem CDN aktiviert ist

• Ein Log-Empfänger (Syslog-kompatibler Endpunkt oder Datadog)

---

Konfiguration

Log Forwarding wird pro Site auf der Seite Grundkonfiguration konfiguriert.

Einstellungen

Einstellung	Erforderlich	Typ	Beschreibung
Log Forwarding aktivieren	—	Boolean	Schaltet Log Forwarding ein oder aus
Hostname	Ja (wenn aktiviert)	String	Der Hostname oder die IP-Adresse deines Log-Empfängers
Port	Ja (wenn aktiviert)	Integer (1–65535)	Der Port, auf dem dein Log-Empfänger lauscht
Token	Nein	String	Optionaler Authentifizierungstoken, der mit jedem Log-Eintrag gesendet wird
Protokoll	Ja (wenn aktiviert)	Auswahl	Transportprotokoll (siehe unten)
Format	Ja (wenn aktiviert)	Auswahl	Log-Ausgabeformat (siehe unten)

Protokolle

Protokoll	Beschreibung	Anwendungsfall
UDP	Unverschlüsselt, verbindungslos	Schnellste Option, geeignet für lokale/vertrauenswürdige Netzwerke
TCP	Unverschlüsselt, verbindungsbasiert	Zuverlässige Zustellung über vertrauenswürdige Netzwerke
TCPEncrypted	TLS-verschlüsseltes TCP	Empfohlen für die Übertragung von Logs über das Internet
DataDog	Datadog-natives Protokoll	Direkte Integration mit Datadog Log Management

Formate

Format	Beschreibung
JSON	Strukturierte JSON-Log-Einträge — empfohlen für die meisten Log-Aggregationstools
Plain	Klartext-Log-Einträge — nützlich für einfache Syslog-Setups

---

Einrichtungsanleitung

Schritt 1: Log-Empfänger vorbereiten

Richte einen Log-Empfänger ein, der eingehende Logs akzeptieren kann. Gängige Optionen:

Grafana Loki mit Promtail/Syslog:

• Konfiguriere einen Syslog-Listener auf einem bekannten Port

• Verwende TCP oder TCPEncrypted für zuverlässige Zustellung

Elastic Stack (ELK):

• Konfiguriere Logstash mit einem TCP- oder UDP-Input

• Verwende das JSON-Format für strukturiertes Parsing

Datadog:

• Verwende die Protokolloption DataDog

• Konfiguriere deinen Datadog-API-Key als Token

Generisches Syslog:

• Jeder Syslog-kompatible Empfänger funktioniert

• Verwende UDP für Einfachheit oder TCP/TCPEncrypted für Zuverlässigkeit

Schritt 2: CDN ist aktiviert sicherstellen

Log Forwarding funktioniert nur für Hostnamen mit aktiviertem CDN. Überprüfe, ob die Hostnamen, für die du Logs möchtest, CDN aktiviert haben:

1. Navigiere zu deiner Site in smoxy

2. Überprüfe die Hostname-Liste — Hostnamen mit aktiviertem CDN werden entsprechend angezeigt

3. Wenn CDN für einen Hostnamen nicht aktiviert ist, aktiviere es zuerst

Schritt 3: Log Forwarding konfigurieren

1. Navigiere zu deiner Site in smoxy

2. Öffne die Grundkonfiguration

3. Scrolle zum Abschnitt Log Forwarding

4. Aktiviere den Schalter Log Forwarding aktivieren

5. Gib die Details deines Log-Empfängers ein:

   • Hostname: z. B. logs.deinefirma.com

   • Port: z. B. 514 (Syslog-Standard) oder dein eigener Port

   • Protokoll: Wähle basierend auf deinem Setup

   • Format: JSON (empfohlen) oder Plain

   • Token: Optionaler Authentifizierungstoken, falls dein Empfänger einen benötigt

6. Speichere die Konfiguration

Schritt 4: Überprüfen

Nach der Aktivierung überprüfe deinen Log-Empfänger auf eingehende Log-Einträge von smoxy. Log-Einträge sollten innerhalb von Minuten erscheinen, sobald deine CDN-aktivierten Hostnamen Traffic empfangen.

Wenn du keine Logs siehst, überprüfe:

• Ob die Hostnamen, die Traffic empfangen, CDN aktiviert haben

• Ob dein Log-Empfänger aus dem Internet auf dem konfigurierten Port erreichbar ist

• Ob Protokoll und Format mit der Konfiguration deines Empfängers übereinstimmen

---

Log Forwarding deaktivieren

Um die Log-Weiterleitung zu stoppen:

1. Navigiere zur Grundkonfiguration deiner Site

2. Deaktiviere den Schalter Log Forwarding aktivieren

3. Speichern

---

Wichtige Hinweise

• CDN erforderlich: Nur Hostnamen mit aktiviertem CDN erzeugen weitergeleitete Logs. Hostnamen ohne CDN auf derselben Site sind nicht enthalten.

• Logs pro Hostname: Jeder Log-Eintrag gehört zum spezifischen CDN-aktivierten Hostnamen, der die Anfrage bearbeitet hat, nicht zur Site als Ganzes.

• Konfiguration auf Site-Ebene: Die Log-Forwarding-Einstellungen (Empfänger, Protokoll, Format) werden einmal pro Site konfiguriert und gelten für alle CDN-aktivierten Hostnamen auf dieser Site. Du kannst keine unterschiedlichen Log-Ziele für einzelne Hostnamen konfigurieren.

• Kein Puffern: Wenn dein Empfänger offline geht, werden Logs während des Ausfalls nicht in eine Warteschlange gestellt oder erneut gesendet.

• Verwende TCPEncrypted, wenn du Logs über das Internet weiterleitest, um die Log-Daten während der Übertragung zu schützen.

• Verwende das JSON-Format für einfacheres Parsen und Filtern in Log-Aggregationstools.

• Das Token-Feld ist nützlich für die Authentifizierung bei Diensten wie Datadog oder benutzerdefinierten Log-Empfängern, die einen API-Key erfordern.