Abrufen benutzerdefinierter Metriken mit collectd - Amazon CloudWatch
Anzeigen von Collectd-Metriken, die vom CloudWatch-Agenten importiert wurden

Abrufen benutzerdefinierter Metriken mit collectd

Sie können zusätzliche Metriken aus Ihren Anwendungen oder Services abrufen, indem Sie den CloudWatch-Agenten mit dem collectd-Protokoll verwenden, das nur auf Linux-Servern unterstützt wird. collectd ist eine beliebte Open-Source-Lösung mit Plug-Ins, die Systemstatistiken für eine Vielzahl von Anwendungen erfassen können. Durch die Kombination der Systemmetriken, die der CloudWatch-Agent bereits erfassen kann, mit den zusätzlichen Metriken von collectd wird eine bessere Überwachung, Analyse und Problembehandlung für Ihre Systeme und Anwendungen ermöglicht. Weitere Informationen zu collectd finden Sie unter collectd – Daemon für die Systemstatistikerfassung.

Sie verwenden die collectd-Software, um die Metriken an den CloudWatch-Agent zu senden. Für die collectd-Metriken fungiert der CloudWatch-Agent als Server, das collectd-Plug-in dagegen als Client.

Die collectd-Software wird nicht auf jedem Server automatisch installiert. Führen Sie auf einem Server mit Amazon Linux 2 die folgenden Schritte aus, um collectd zu installieren.

sudo amazon-linux-extras install collectd

Informationen zum Installieren von collectd auf anderen Systemen finden Sie auf der Download-Seite für collectd.

Um diese benutzerdefinierten Metriken zu erfassen, fügen Sie die Zeile "collectd": {} zum Abschnitt metrics_collected der Agentenkonfigurationsdatei hinzu. Sie können diese Zeile manuell hinzufügen. Wenn Sie zum Erstellen der Konfigurationsdatei den Assistenten verwenden, geschieht dies automatisch. Weitere Informationen finden Sie unter So erstellen Sie die CloudWatch-Agent-Konfigurationsdatei.

Optionale Parameter sind ebenfalls verfügbar. Wenn Sie bei Einsatz des collectd-Protokolls nicht /etc/collectd/auth_file als Wert für collectd_auth_file verwenden, müssen Sie einige dieser Optionen selbst festlegen.

  • service_address: Die Service-Adresse, die der CloudWatch-Agent überwachen soll. Das Format ist "udp://ip:port. Der Standardwert ist udp://127.0.0.1:25826.

  • name_prefix: Ein Präfix zum Anfügen an den Anfang des Namens einer jeden collectd-Metrik. Der Standardwert ist collectd_. Die maximale Länge beträgt 255 Zeichen.

  • collectd_security_level: Legt die Sicherheitsstufe für die Netzwerkkommunikation fest. Der Standardwert lautet encrypt (Verschlüsseln).

    encrypt (Verschlüsseln) gibt an, dass nur verschlüsselte Daten akzeptiert werden. sign (Signieren) gibt an, dass nur signierte und verschlüsselte Daten akzeptiert werden. none (Keine) gibt an, dass alle Daten akzeptiert werden. Wenn Sie einen Wert für collectd_auth_file angeben, werden verschlüsselte Daten, falls möglich, entschlüsselt.

    Weitere Informationen finden Sie unter Client-Einrichtung und Mögliche Interaktionen in der collectd Wiki.

  • collectd_auth_file Legt eine Datei fest, in der Benutzernamen Passwörtern zugeordnet sind. Diese Passwörter werden verwendet, um Signaturen zu verifizieren und verschlüsselte Netzwerkpakete zu entschlüsseln. Sofern angegeben, werden signierte Daten verifiziert und verschlüsselte Pakete entschlüsselt. Andernfalls werden signierte Daten ohne Überprüfung der Signatur akzeptiert und verschlüsselte Daten können nicht entschlüsselt werden.

    Der Standardwert ist /etc/collectd/auth_file.

    Wenn collectd_security_level auf none (Keine) gesetzt ist, ist dies optional. Wenn Sie collectd_security_level auf encrypt oder sign (Signieren) einstellen, müssen Sie einen Wert für collectd_auth_file angeben.

    Bei dem Format der auth-Datei ist jede Zeile ein Benutzernamen, gefolgt von einem Doppelpunkt und einer beliebigen Anzahl von Leerzeichen, gefolgt von dem Passwort. Zum Beispiel:

    user1: user1_password

    user2: user2_password

  • collectd_typesdb: Eine Liste von einer oder mehreren Dateien, die die Beschreibungen der Datensätze enthalten. Die Liste muss in eckigen Klammern stehen, auch wenn sie nur einen Eintrag enthält. Jeder Eintrag in der Liste muss in Anführungszeichen stehen. Wenn mehrere Einträge vorhanden sind, trennen Sie sie durch Kommas voneinander. Der Standardwert auf Linux-Servern ist ["/usr/share/collectd/types.db"]. Die Standardeinstellung auf macOs Computern hängt von der Version von collectd ab. Beispiel, ["/usr/local/Cellar/collectd/5.12.0/share/collectd/types.db"].

    Weitere Informationen finden Sie unter https://www.collectd.org/documentation/manpages/types.db.html.

  • metrics_aggregation_interval: Wie oft (in Sekunden) CloudWatch Metriken in einzelne Datenpunkte aggregiert. Standardmäßig ist ein Zeitraum von 60 Sekunden festgelegt. Der Bereich liegt zwischen 0 und 172.000. Wenn für ihn "0" festgelegt wird, ist die Aggregation von collectd-Metriken deaktiviert.

Es folgt ein Beispiel des collectd-Abschnitts der Agenten-Konfigurationsdatei.

{
   "metrics":{
      "metrics_collected":{
         "collectd":{
            "name_prefix":"My_collectd_metrics_",
            "metrics_aggregation_interval":120
         }
      }
   }
}

Anzeigen von Collectd-Metriken, die vom CloudWatch-Agenten importiert wurden

Nachdem Sie Collectd-Metriken in CloudWatch importiert haben, können Sie diese Metriken als Zeitreihendiagramme anzeigen und Alarme erstellen, die diese Metriken überwachen und Sie benachrichtigen können, wenn sie einen von Ihnen angegebenen Schwellenwert überschreiten. Das folgende Verfahren zeigt, wie Sie Collectd-Metriken als Zeitreihendiagramm anzeigen. Weitere Informationen zum Einrichten eines -Alarms finden Sie unter Verwenden von Amazon-CloudWatch-Alarmen.

Anzeigen von Collectd-Metriken in der CloudWatch-Konsole

  1. Öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Wählen Sie im Navigationsbereich Metriken aus.

  3. Wählen Sie den Namespace für die vom Agent zu erfassenden Metriken. Standardmäßig ist dies CWAgent, aber Sie haben möglicherweise einen anderen Namespace in der Konfigurationsdatei des CloudWatch-Agenten angegeben.

  4. Wählen Sie eine Metrikdimension aus (z. B. Per-Instance Metrics (Metriken pro Instance)).

  5. Die Registerkarte All metrics zeigt alle Metriken für diese Dimension im Namespace an. Sie haben die folgenden Möglichkeiten:

    1. Um eine Metrik grafisch darzustellen, müssen Sie das Kontrollkästchen neben der Metrik aktivieren. Um alle Metriken auszuwählen, aktivieren Sie das Kontrollkästchen in der Kopfzeile der Tabelle.

    2. Um die Tabelle sortieren, verwenden Sie die Spaltenüberschrift.

    3. Um nach Ressource zu filtern, müssen Sie zunächst die Ressourcen-ID und dann die Option Zu Suche hinzufügen auswählen.

    4. Um nach Metrik zu filtern, müssen Sie den Metriknamen und anschließend Add to search (Zur Suche hinzufügen) auswählen.

  6. (Optional) Um dieses Diagramm zu einem CloudWatch-Dashboard hinzuzufügen, wählen Sie Aktionen, Zu Dashboard hinzufügen.