MetriBeacon-Agent

Vor der Installation

Wählen Sie das Paket für Betriebssystem und Prozessor: Linux, macOS ab 14, Windows 11 oder Windows Server ab 2022 mit x64 oder ARM64. npm-Installation braucht Node.js ab 22, native Downloads nicht. Zur Installation eines Hintergrunddiensts benötigen Sie Rechte auf Ihrem eigenen Gerät. Linux ohne systemd kann den Vordergrundmodus nutzen.

Installieren und verbinden

Öffnen Sie Server, wählen Sie Linux / macOS oder Windows und kopieren Sie den Installationsbefehl. Führen Sie ihn auf Ihrem Server aus. Neuester freigegebener Agent, Systemdienst, Geräteschlüssel und gewähltes Profil werden automatisch eingerichtet; eine Browserbestätigung auf dem Server ist nicht nötig. Ihr Betriebssystem kann Administratorrechte anfordern.

Alternativ können Sie die CLI über npm oder einen nativen Download installieren und die folgenden Befehle für die browsergestützte Kopplung verwenden.

npm install -g metribeacon
metribeacon setup
metribeacon status
# Alternatives: pnpm add -g metribeacon; yarn global add metribeacon

Zugang privat halten

Das Verbinden mit einem bestehenden Konto erstellt kein weiteres Konto. Die Einrichtung fragt Geräte-Datenzugriff und CLI-/MCP-Verwaltungszugriff gesondert ab. Halten Sie Identitätsdateien und Schlüssel privat und aus Befehlsargumenten, Logs und Repositorys heraus. Ein Verbindungscode läuft nach zehn Minuten ab; starten Sie dann die Einrichtung neu.

Messwerte auswählen

Standardmäßig sind CPU-Auslastung, belegter Arbeitsspeicher und Systemlaufwerk alle 10 Sekunden gewählt. Erkannte Komponenten sind Vorschläge, keine aktiven Messwerte. Ergänzen Sie unterstützte Laufwerke, Netzwerkschnittstellen und weitere Werte im Serverprofil des Monitors. Optionale Prozess-, Datei-, Programm-, SMART-, Container- oder Verbindungsprüfungen können eine lokale Rechterichtlinie auf Ihrem eigenen Gerät brauchen. Erlauben Sie nur die genauen gewünschten Prüfungen.

Download auswählen

Nutzen Sie ein für Ihre Plattform angebotenes Paket und lesen Sie seinen Unterstützungshinweis. Pakete für Linux ARM64, macOS x64 und Windows ARM64 sind nicht auf dieser Plattform getestet. macOS- und Windows-Installer haben derzeit keine Betriebssystem-Codesignatur und können eine Warnung anzeigen. Folgen Sie den Hinweisen zur Manifestprüfung; deaktivieren Sie den Systemschutz nicht pauschal. Ersetzen Sie ein fehlendes Paket nicht durch eine andere Prozessorarchitektur.

Installierten Agent aktualisieren

Neue native Installationen aktivieren Fernupdates mit einem eigenen Schlüsselrecht. Sobald eine neuere freigegebene Version verfügbar ist, erscheint ein Symbol in der Serverliste. Der Arbeitsbereichsbesitzer bestätigt jedes Update; warten Sie anschließend auf die Bestätigung nach dem Neustart. Konfigurationsschreibrechte sind davon unabhängig. Vorübergehende Belegung liefert 503 mit update_busy und Retry-After: 1. Wiederholen Sie mit derselben operation_id und demselben bestätigten Ziel; die Oberfläche versucht dies bis zu zehn Sekunden. Bereits angenommene Anfragen liefern denselben Auftrag zurück. Die opake target_id bindet freigegebenes Release und Ausgangsinstallation/-version; bei Änderungen erneut laden und bestätigen.

Native Dienste aktivieren vom Besitzer bestätigte Fernupdates standardmäßig. Lokal stehen Administratoren metribeacon agent remote-updates disable, enable und status zur Verfügung; eine gespeicherte lokale Abschaltung bleibt erhalten. Auch das Schlüsselrecht „Fernupdates erlauben“ lässt sich abschalten. npm- und Vordergrundinstallationen werden lokal aktualisiert.

Für eine native Neuinstallation mit bestehendem Serverschlüssel verwenden Sie setup --non-interactive --device-id SERVER_ID --key-file /protected/device.key mit authentifizierter Verwaltungsidentität. Die Einrichtung aktiviert das Updaterecht einmalig. Der Schlüssel muss aktiv und auf genau diesen Server begrenzt sein; breite oder widerrufene Schlüssel sind ungeeignet. Neustarts und normale Updates ändern keine Berechtigungen.

Ältere Installationen benötigen zunächst ein lokales Upgrade. Führen Sie danach als Administrator metribeacon agent remote-updates enable aus, um den Updater einzurichten. Für Offline-Server werden keine unerwarteten späteren Updates vorgemerkt.