Konfiguration

Jeder Schlüssel der Plugin-Config plus das, was stattdessen im Dashboard eingestellt wird.

PulseNode v5.0.2Paper · Spigot1.21 – 1.21.x

Die Plugin-Config ist bewusst klein. Alles, was eine Vorliebe statt eines Verbindungsdetails ist, liegt im Dashboard — damit du es ändern kannst, ohne den Server anzufassen.

Die komplette Datei

plugins/PulseNode/config.yml

api-url: "https://pulsenode.tech"api-key: "DEIN-API-KEY" # Sammelintervall in Sekunden (Minimum 10, Standard 30)interval: 30 # Plugin-CPU-Daten senden (für genaue Werte wird Spark benötigt)track-plugins: true # SEVERE-Konsolenfehler erfassen und an PulseNode sendentrack-console-errors: true # Kritischer TPS-Schwellwert für Sofort-Alertscritical-tps: 15.0 # Security-Monitoringsecurity:  enabled: true

Schlüssel	Standard	Wirkung
`api-url`	`https://pulsenode.tech`	Der API-Endpunkt. Nur ändern, wenn man es dir sagt.
`api-key`	—	Identifiziert einen Server. Nie zwischen Servern teilen.
`interval`	`30`	Sekunden zwischen Momentaufnahmen. Minimum 10.
`track-plugins`	`true`	CPU pro Plugin. Mit Spark genau, ohne geschätzt.
`track-console-errors`	`true`	Erfasst `SEVERE`-Zeilen aus der Konsole.
`critical-tps`	`15.0`	Darunter feuert ein Sofort-Alert und ein Lag-Snapshot wird erstellt.
`security.enabled`	`true`	Verfolgt gefährliche Befehle, Verbindungsfluten und Login-Fehlschläge.

Änderungen übernimmst du mit /pn reload.

Das Intervall wählen

YAML

interval: 30

30 Sekunden passen für fast alle. Der Kompromiss:

Niedriger (10–20 s) — feinere Auflösung bei kurzen Spitzen, mehr Anfragen, mehr Historienzeilen gegen dein Tarifkontingent.
Höher (60 s+) — leichter, aber eine 40-Sekunden-Lagspitze kann komplett zwischen zwei Messpunkte fallen und taucht in keinem Diagramm auf.

Werte unter 10 werden abgelehnt. Schneller zu sammeln kostet mehr Overhead, als die zusätzliche Auflösung wert ist.

critical-tps

YAML

critical-tps: 15.0

Zwei Dinge passieren, wenn die TPS darunter fällt:

Ein Sofort-Alert geht raus, statt auf den nächsten Report zu warten.
Ein Lag-Snapshot wird erstellt — der komplette Zustand in diesem Moment: TPS, MSPT, Entity- und Chunk-Zahlen pro Welt, und wer online war.

Der Snapshot ist der wertvolle Teil. Er ist der Unterschied zwischen „TPS ist um 20:14 gefallen" und „TPS ist um 20:14 gefallen, bei 11.400 Entities in world_nether und diesen sechs Spielern online".

Auf deinen Server abstimmen, nicht auf 20

Auf einem gut ausgelasteten Server, der den ganzen Abend bei 17 TPS liegt, feuert ein Schwellwert von 15 permanent — und du hörst auf, die Alerts zu lesen. Setz ihn knapp unter deinen normalen Boden, damit er etwas bedeutet.

Was gesendet wird

Jedes Intervall:

TPS, MSPT, RAM belegt und maximal, Uptime
Entity-Anzahl, geladene Chunks und Größe auf der Platte, pro Welt
Spielerzahl und die Namen der Online-Spieler
mit track-plugins die CPU-Zeit pro Plugin
mit track-console-errors erfasste SEVERE-Zeilen
mit security.enabled die aufgelaufenen Security-Ereignisse
bei TPS unter critical-tps ein Lag-Snapshot

Dazu regelmäßige Momentaufnahmen der Plugin- und Server-Konfiguration — genau das erlaubt einem Report, auf view-distance zu zeigen, statt allgemein zu bleiben.

Schwärzung

Konfigurations-Snapshots werden im Plugin, vor der Übertragung gefiltert. Jeder Schlüssel, der hierauf passt, wird geschwärzt:

TEXT

password   secret   token   key      api-keyapikey     api_key  credentials      authmysql      database jdbc     connection-stringwebhook    license

Deine Datenbank-Zugangsdaten, Webhook-URLs und Lizenzschlüssel verlassen die Maschine nie.

Einstellungen im Dashboard

Auf pulsenode.tech konfiguriert, nicht in der Datei:

Einstellung	Wo
Report-Frequenz und Empfänger	Server → Reports
Alert-Schwellwerte und -Kanäle	Server → Alerts
Discord-Kanal-Bindung	Server → Integrationen
Datenaufbewahrung	Ergibt sich aus deinem Tarif
API-Tokens	Account → API (Business)

Diese Trennung existiert, damit das Ändern eines Report-Empfängers keinen SSH-Zugriff auf einen Gameserver braucht.

Dinge abschalten

YAML

track-plugins: falsetrack-console-errors: falsesecurity:  enabled: false

Alle drei lassen sich einzeln abschalten — der Rest läuft weiter. security.enabled: false entfernt zusätzlich das /pn security-GUI, das dann meldet, dass Security-Monitoring deaktiviert ist.