MetriBeacon
Menü
Deutsch
AnmeldenZum Konto

Agent-Messreihen synchronisieren

Verwalten Sie die Erfassung im Monitor oder lokal mit derselben Messhistorie.

Auf dieser Seite

Das benötigen Sie

Einen aktuellen Agenten im Serverprofilmodus und die aktivierte Synchronisierung für Ihren Monitor. Ein Owner oder Editor muss Konfigurationsänderungen an einem Schlüssel ausdrücklich erlauben, der nur diesem Servermonitor zugeordnet ist.

So geht es

  1. Setzen Sie collection_sync und server_profile in Ihrer geschützten Agentkonfiguration auf true sowie device_id auf die UUID des gebundenen Servermonitors. Wählen Sie im Tab Messreihen Serverparameter oder lokal freigegebene Prüfungen aus und prüfen Sie Änderungen vor dem Speichern.
  2. Führen Sie metribeacon agent metrics list --json aus. Ändern Sie die Erfassung beispielsweise mit metribeacon agent metrics update --source-id catalog/system/cpu_usage --interval 60. Die Befehle add, enable, disable und remove verwenden dieselbe geschützte Konfiguration.
  3. Prüfen Sie den Agentstatus unter Messreihen. Bei funktionierender Verbindung, ausführbarer Quelle und freiem Kontingent erreichen Konfigurationsänderungen beide Seiten innerhalb von fünf Sekunden; der Messwert folgt nach Ende der Prüfung.

Gut zu wissen

Die zuletzt vom Server angenommene Änderung gewinnt für jedes geänderte Feld. Namen und Beschreibungen erzeugen keine neue Historie. Entfernen einer Agentenreihe beendet die Erfassung und erhält die Historie; ihre Alarme müssen ausdrücklich wieder aktiviert werden. Unveränderte Zustände behalten ihr getrenntes Wiederholungsintervall von mindestens 270 Sekunden.

Deklarieren Sie eigene Programmausgaben in der administratorgeschützten Collector-Policy mit stabiler custom/-source_id, component_id, parameter_key, kind und unit. Freigegebene Programme liefern JSON-values und optional counter_epochs. Nur deklarierte Felder werden gesendet; Befehle und Argumente bleiben lokal. Maximale Laufzeit: 60 Sekunden; Ausgabe: 64 KiB. Ein einmaliger metric send verwendet eine external/-Kennung und richtet keine wiederkehrende Prüfung ein.

Lassen Sie das Programm und seinen SHA-256 durch einen Administrator in der vorhandenen Collector-Richtlinie freigeben. Ersetzen Sie im Beispiel Programmpfad und Hash; behalten Sie source_id beim Umbenennen bei. Das Programm schreibt ausschließlich das folgende JSON auf die Standardausgabe. Speichern Sie Geheimnisse lokal außerhalb dieser Definition.

json
{
  "version": 1,
  "targets": [
    {
      "component": {
        "id": "program:queue",
        "kind": "program",
        "label": "Queue",
        "local_ref": "queue"
      },
      "program": {
        "executable": "/usr/local/libexec/my-queue-check",
        "arguments": [],
        "sha256": "REPLACE_WITH_THE_EXECUTABLE_SHA256",
        "timeout_seconds": 5,
        "outputs": [
          {
            "source_id": "custom/queue-depth",
            "component_id": "program:queue",
            "parameter_key": "queue_depth",
            "kind": "gauge",
            "unit": "items",
            "name": "Queue depth",
            "description": "",
            "interval_seconds": 30,
            "available": true
          }
        ]
      }
    }
  ]
}
json
{"values":{"queue_depth":42},"counter_epochs":{}}

Wenn etwas nicht klappt

Bei einem Ausfall läuft die zuletzt bestätigte Konfiguration weiter. Lokale Änderungen warten in einer geschützten Warteschlange mit höchstens 256 Vorgängen. Prüfen Sie collection/collection.settings.json unter Ihrem konfigurierten Spoolverzeichnis; bearbeitbar sind nur name, description, enabled und interval_seconds. Ändern Sie keine Kennungen, bestätigten Stände oder vorgemerkten Vorgangskennungen. Fehlende Definitionen, Rechte und ungültige Ausgaben erscheinen als ausdrückliche Zustände.

Verwandte Anleitungen