Wie binde ich einen Monitoring-Agent ein?

Ab Tarif Pro

Kurzantwort

Erstelle im Abschnitt Monitoring-Agents einen Einbindungs-Token, lade den Notory-Agent für dein Betriebssystem herunter, hinterlege Server-URL und Token und starte den Agent als Dienst. Er meldet dann fortlaufend CPU, Arbeitsspeicher, Festplatte, Netzwerk und Laufzeit. Das System erscheint automatisch als Agent-System in der Liste.

Voraussetzungen

Monitoring gehört zum Modul Operations und ist ab Tarif Pro verfügbar.

Token erstellen. Scrolle im Modul Monitoring zum Abschnitt Monitoring-Agents. Vergib einen Namen (z. B. „Fleet A” für einen Standort oder eine Geräteflotte) und klicke „Token erstellen”. Der Einbindungs-Token wird nur einmal angezeigt. Kopiere ihn sofort.

Screenshot ausstehend monitoring-agent-01 Abschnitt Monitoring-Agents mit Namensfeld, Schaltfläche Token erstellen und Download-Schaltflächen je Betriebssystem

Einbindungs-Token erstellen und den Agent je Betriebssystem herunterladen.
Agent herunterladen. Klicke unter „Agent herunterladen” die passende Variante (Windows, Linux oder macOS, je amd64/arm64). Ist ein Build noch nicht verfügbar, meldet Notory „… ist noch nicht verfügbar”.
Agent betreiben. Hinterlege auf dem Zielsystem die Server-URL und den Einbindungs-Token und starte den Agent als Dienst (Aufgabenplanung / systemd / launchd). Ab der ersten Meldung taucht das System als Agent in der Liste auf.

Agent-Binary laden: GET /api/v1/monitoring/agent/download mit os und arch:

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/monitoring/agent/download?os=linux&arch=amd64" \
  --output notory-agent

Unterstützt: os ∈ windows | linux | darwin (bzw. macos), arch ∈ amd64 | arm64. Ist das Binary noch nicht gebaut, antwortet die API mit 404.

Was der Agent sendet: Er pusht seine Messwerte an POST /api/v1/monitoring/agent/metrics, authentifiziert über den Einbindungs-Token (nicht über eine Benutzersitzung). Pflicht ist machine_id:

curl -X POST https://demo.notory.io/api/v1/monitoring/agent/metrics \
  -H "Authorization: Bearer <einbindungs-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "machine_id": "b3f1-win-0421",
    "hostname": "SRV-DMZ-01",
    "os": "windows",
    "cpu_pct": 37.5,
    "mem_pct": 61.2,
    "disk_pct": 74.0,
    "uptime_s": 862400,
    "load1": 0.8
  }'

{ "host_id": "hs_9a8b…", "created": true }

Mögliche Fehler: 400 (nicht unterstütztes os/arch), 401 (Token ungültig), 403 (Modul Operations nicht im Tarif), 404 (Binary noch nicht verfügbar).

Was passiert dabei?

Automatische Systemanlage: Beim ersten Metrik-Push legt Notory anhand der machine_id ein Agent-System an (bzw. aktualisiert es) und setzt den Status auf Online.
Verknüpfung mit dem Inventar: Existiert ein Asset mit passender externer Kennung, wird das System damit verbunden; andernfalls legt Notory ein schlankes Asset an. So hängen Überwachung und Bestand zusammen.
Erweiterte Messwerte: Über das Feld extra kann der Agent zusätzlich Dienste, Prozesse oder Temperaturen liefern; sie erscheinen im Systemverlauf unter „Erweiterte Messwerte”.
Einmal-Anzeige des Tokens: Der Einbindungs-Token wird aus Sicherheitsgründen nur bei der Erstellung angezeigt, danach nicht erneut abrufbar.