Abrufen benutzerdefinierter Metriken mit collectd

Sie können zusätzliche Messwerte aus Ihren Anwendungen oder Diensten 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 Plugins, die Systemstatistiken für eine Vielzahl von Anwendungen sammeln können. Durch die Kombination der Systemmetriken, die der CloudWatch Agent bereits erfassen kann, mit den zusätzlichen Metriken von collectd können Sie Ihre Systeme und Anwendungen besser überwachen, analysieren und Fehler beheben. Weitere Informationen zu collectd finden Sie unter collectd – Daemon für die Systemstatistikerfassung.

Sie verwenden die gesammelte Software, um die Metriken an den Agenten zu senden. CloudWatch Bei den gesammelten Metriken fungiert der CloudWatch Agent als Server, während das Collectd-Plugin als Client fungiert.

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 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 Dienstadresse, auf die der CloudWatch Agent hören 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 Metriken zu einzelnen Datenpunkten aggregiert werden. CloudWatch 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
         }
      }
   }
}

Gesammelte Metriken anzeigen, CloudWatch die vom Agenten importiert wurden

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

Um gesammelte Metriken in der Konsole anzuzeigen CloudWatch

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 der Fall CWAgent, aber Sie haben möglicherweise einen anderen Namespace in der CloudWatch Agentenkonfigurationsdatei 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, Zum Dashboard hinzufügen aus.