Installation#

Voraussetzungen#

Um unseren Go Agent zu installieren benötigen Sie:

  • API Token ihrer Organisation (Zu finden im Reiter Organisation)

  • Agent ID (wird nach Erstellung eines neuen Agent angezeigt)

  • Das System muss einen HTTP-Request an unseren Server senden können

  • Das Betriebssystem, sowie die Architektur müssen unterstützt sein (hier)

Hintergrund#

Der Agent erleichtert das Monitoring eines Systems in dem Basismetriken automatisch gesammelt werden. Weitere Metriken, sowie die Konfiguration des Agent, kann ganz bequem im Dashboard erfolgen.

Die gesammelten Basismetriken sind:

  • Betriebssystem inkl. Version

  • Hostname

  • Architektur (arm64, amd64, etc.)

  • CPU Auslastung

  • RAM Auslastung

  • Nutzung der Festplatte

  • Uptime des Systems

Einrichtung#

Nachdem Sie einen neuen Agent über das Dashboard angelegt haben (alternativ über die API Endpunkte), wird die Agent ID angezeigt (bzw. ist Teil der HTTP-Response).

Um nun den Agent per Oneliner installieren zu können muss auf dem Zielsystem nur das folgende Kommando ausgeführt werden (AGENT_ID und API_TOKEN sind entsprechend zu ersetzen):

curl -sfL https://wgri.de/install | WG_AGENT=<AGENT_ID> WG_TOKEN=<API_TOKEN> sh -

Nach erfolgreicher Installation werden die Metriken vom Agent automatisch an den Server gesendet und sind über das Dashboard abrufbar.