Grafisches Darstellen von durch Regeln generierte Metriken

Contributor Insights bietet eine Metrikberechnungsfunktion, INSIGHT_RULE_METRIC. Sie können diese Funktion verwenden, um Daten aus einem Contributor Insights-Bericht zu einem Diagramm auf der Registerkarte Metriken der CloudWatch Konsole hinzuzufügen. Sie können auch einen Alarm basierend auf dieser mathematischen Funktion einstellen. Weitere Informationen zu Metrikberechnungsfunktionen finden Sie unter Verwenden von Metrikberechnungen

Um diese Metrikberechnungsfunktion verwenden zu können, müssen Sie an einem Konto angemeldet sein, das über die Berechtigungen cloudwatch:GetMetricData und cloudwatch:GetInsightRuleReport verfügt.

Die Syntax lautet INSIGHT_RULE_METRIC(ruleName, metricName). ruleName ist der Name einer Contributor Insights-Regel und metricName ist einer der Werte in der folgenden Liste. Der Wert von metricName bestimmt, welche Art von Daten die mathematische Funktion zurückgibt.

• UniqueContributors – die Anzahl der eindeutigen Mitwirkenden für jeden Datenpunkt.

• MaxContributorValue – der Wert des obersten Mitwirkenden für jeden Datenpunkt. Die Identität des Contributors kann sich für jeden Datenpunkt in dem Diagramm ändern.

  Wenn diese Regel nach Count aggregiert wird, ist der Top-Contributor für jeden Datenpunkt der Contributor mit den meisten Vorkommen in diesem Zeitraum. Wenn die Regel nach Sum aggregiert wird, ist der Top-Contributor der Contributor mit der größten Summe in dem durch das Value der Regel angegebenen Protokollfeld während dieses Zeitraums.

• SampleCount – Die Anzahl der Datenpunkte, mit denen die Regel übereinstimmt.

• Sum – die Summe der Werte aller Mitwirkenden während des durch diesen Datenpunkt repräsentierten Zeitraums.

• Minimum – der Mindestwert einer einzelnen Beobachtung während des durch diesen Datenpunkt repräsentierten Zeitraums.

• Maximum – der Höchstwert einer einzelnen Beobachtung während des durch diesen Datenpunkt repräsentierten Zeitraums.

• Average – der durchschnittliche Wert aller Mitwirkenden während des durch diesen Datenpunkt repräsentierten Zeitraums.

Festlegen eines Alarms für Contributor Insights-Metrikdaten

Mit der Funktion INSIGHT_RULE_METRIC können Sie Alarme für Metriken festlegen, die von Contributor Insights generiert werden. Beispielsweise können Sie einen Alarm basierend auf dem Prozentsatz der zurückgewiesenen TCP-Verbindungen (Transmission Control Protocol) erstellen. Um mit dieser Art von Alarm zu beginnen, können Sie Regeln wie die in den folgenden beiden Beispielen gezeigten erstellen:

Beispielregel: "" RejectedConnectionsRule

{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "LogGroupNames": [
        "/aws/containerinsights/sample-cluster-name/flowlogs"
    ],
    "LogFormat": "CLF",
    "Fields": {
        "3": "interfaceID",
        "4": "sourceAddress",
        "8": "protocol",
        "13": "action"
    },
    "Contribution": {
        "Keys": [
            "interfaceID",
            "sourceAddress"
        ],
        "Filters": [
            {
                "Match": "protocol",
                "EqualTo": 6
            },
            {
                "Match": "action",
                "In": [
                    "REJECT"
                ]
            }
        ]
    },
    "AggregateOn": "Sum"
}

Beispielregel: "TotalConnectionsRule"

{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "LogGroupNames": [
        "/aws/containerinsights/sample-cluster-name/flowlogs"
    ],
    "LogFormat": "CLF",
    "Fields": {
        "3": "interfaceID",
        "4": "sourceAddress",
        "8": "protocol",
        "13": "action"
    },
    "Contribution": {
        "Keys": [
            "interfaceID",
            "sourceAddress"
        ],
        "Filters": [{
            "Match": "protocol",
            "EqualTo": 6
        }],
        "AggregateOn": "Sum"
    }
}

Nachdem Sie Ihre Regeln erstellt haben, können Sie in der CloudWatch Konsole die Registerkarte „Metriken“ auswählen. Dort können Sie die folgenden mathematischen Beispielausdrücke verwenden, um die von Contributor Insights gemeldeten Daten grafisch darzustellen:

Example: Metric math expressions (Beispiel: Metrikberechnungs-Ausdrücke)

e1 INSIGHT_RULE_METRIC("RejectedConnectionsRule", "Sum")
e2 INSIGHT_RULE_METRIC("TotalConnectionsRule", "Sum")
e3 (e1/e2)*100

Im Beispiel werden mit dem Metrikberechnungs-Ausdruck e3 alle abgelehnten TCP-Verbindungen zurückgegeben. Wenn Sie benachrichtigt werden möchten, wenn 20 % der TCP-Verbindungen abgelehnt werden, können Sie den Schwellenwert im Ausdruck von 100 zu 20 ändern.

Anmerkung

Für eine Metrik, die Sie überwachen, können Sie im Abschnitt Metrics (Metriken) einen Alarm erstellen. Auf der Registerkarte Graphed metrics (Grafisch dargestellt Metriken) können Sie das Create alarm (Alarm erstellen)-Symbol unter der Spalte Actions (Aktionen) auswählen. Das Symbol für Alarm erstellen sieht aus wie eine Glocke.

Weitere Hinweise zur grafischen Darstellung von Metriken und zum Verwenden von Metrikberechnungsfunktionen finden Sie im folgenden Abschnitt: Fügen Sie einem CloudWatch Diagramm einen mathematischen Ausdruck hinzu.