Abrufen benutzerdefinierter Metriken mit StatsD - Amazon CloudWatch
Vom Agenten importierte StatsD-Metriken anzeigen CloudWatch

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abrufen benutzerdefinierter Metriken mit StatsD

Sie können zusätzliche benutzerdefinierte Metriken aus Ihren Anwendungen oder Diensten abrufen, indem Sie den CloudWatch Agenten mit dem StatsD Protokoll verwenden. StatSD ist eine beliebte Open-Source-Lösung, mit der Metriken aus einer Vielzahl von Anwendungen gesammelt werden können. StatSD ist besonders nützlich für das Instrumentieren eigener Metriken. Ein Beispiel für die gemeinsame Verwendung von CloudWatch Agent und StatsD finden Sie unter So überwachen Sie Ihre benutzerdefinierten Anwendungsmetriken mithilfe von Amazon CloudWatch Agent besser.

StatsDwird sowohl auf Linux-Servern als auch auf Servern unterstützt, auf denen Windows Server ausgeführt wird. CloudWatch unterstützt das folgende StatsD Format:

MetricName:value|type|@sample_rate|#tag1:
  value,tag1...

  • MetricName – Eine Zeichenfolge ohne Doppelpunkte, Balken, #-Zeichen oder @-Zeichen.

  • value – Dies kann eine Ganzzahl oder Gleitkommazahl sein.

  • type – Geben Sie c für Zähler, g für Anzeige, ms für Timer, h für Histogramm oder s für Set an.

  • sample_rate – (Optional) Eine Gleitkommazahl zwischen 0 und 1. Wird nur für Zähler-, Histogramm- und Timer-Metriken verwendet. Der Standardwert lautet "1" (Erfassung über die gesamte Zeit hinweg).

  • tags— (Optional) Eine durch Kommas getrennte Liste von Tags. StatsDTags ähneln den Dimensionen in. CloudWatch Verwenden Sie für Schlüssel/Wert-Tags Doppelpunkte, z. B. env:prod.

Sie können jeden StatsD Client verwenden, der dieses Format verwendet, um die Metriken an den CloudWatch Agenten zu senden. Weitere Informationen zu einigen der verfügbaren StatsD Clients finden Sie auf der StatsD-Client-Seite unter GitHub.

Um diese benutzerdefinierten Metriken zu erfassen, fügen Sie die Zeile "statsd": {} 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.

Die StatsD-Standardkonfiguration eignet sich für die meisten Benutzer. Es gibt optionale Felder, die Sie ganz nach Bedarf zum Abschnitt statsd der Agentenkonfigurationsdatei hinzufügen können:

  • service_address— Die Dienstadresse, auf die der CloudWatch Agent hören soll. Das Format ist ip:port. Wenn Sie die IP-Adresse weglassen, überwacht der Agent alle verfügbaren Schnittstellen. Es wird nur das UDP Format unterstützt, sodass Sie kein UDP Präfix angeben müssen.

    Der Standardwert ist :8125.

  • metrics_collection_interval – Wie oft (in Sekunden) das StatsD-Plug-in ausgeführt wird und Metriken erfasst. Der Standardwert liegt bei 10 Sekunden. Der Bereich liegt zwischen 1 und 172.000.

  • metrics_aggregation_interval— Wie oft in Sekunden werden CloudWatch Metriken zu einzelnen Datenpunkten zusammengefasst. Der Standardwert liegt bei 60 Sekunden.

    Wenn beispielsweise 10 und 60 metrics_collection_interval metrics_aggregation_interval ist, werden alle 10 Sekunden Daten CloudWatch erfasst. Nach jeder Minute werden die sechs Messwerte dieser Minute zu einem einzigen Datenpunkt zusammengefasst, an CloudWatch den gesendet wird.

    Der Bereich liegt zwischen 0 und 172.000. Wenn für metrics_aggregation_interval "0" festgelegt wird, ist die Aggregation von StatsD-Metriken deaktiviert.

  • allowed_pending_messages— Die Anzahl der UDP Nachrichten, die in die Warteschlange aufgenommen werden dürfen. Wenn die Warteschlange voll ist, beginnt der StatsD-Server, Pakete zu verwerfen. Der Standardwert lautet 10.000.

  • drop_original_metrics Optional. Wenn Sie das aggregation_dimensions-Feld im metrics-Abschnitt verwenden, um Metriken zu aggregierten Ergebnissen zusammenzufassen, dann sendet der Agent standardmäßig sowohl die aggregierten Metriken als auch die ursprünglichen Metriken, die für jeden Wert der Dimension getrennt sind. Wenn Sie nicht möchten, dass die ursprünglichen Metriken gesendet werden CloudWatch, können Sie diesen Parameter mit einer Liste von Metriken angeben. Für die zusammen mit diesem Parameter angegebenen Metriken werden keine nach Dimension aufgeschlüsselten Kennzahlen gemeldet CloudWatch. Stattdessen werden nur die aggregierten Metriken gemeldet. Dadurch verringert sich die Anzahl der Metriken, die der Agent erfasst, was Ihre Kosten senkt.

Im Folgenden finden Sie ein Beispiel für den Abschnitt statsd der Agent-Konfigurationsdatei unter Verwendung des Standard-Ports und von benutzerdefinierten Sammlungs- und Aggregationsintervallen.

{
   "metrics":{
      "metrics_collected":{
         "statsd":{
            "service_address":":8125",
            "metrics_collection_interval":60,
            "metrics_aggregation_interval":300
         }
      }
   }
}

Vom Agenten importierte StatsD-Metriken anzeigen CloudWatch

Nach dem Import von StatsD-Metriken in CloudWatch 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 StatsD-Metriken als Zeitreihendiagramm anzeigen. Weitere Informationen zum Einrichten eines -Alarms finden Sie unter CloudWatch Amazon-Alarme verwenden.

So zeigen Sie StatsD-Metriken in der Konsole an 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.