Représentation graphique des métriques générées par les règles dans CloudWatch

Contributor Insights fournit une fonction mathématique métrique, INSIGHT_RULE_METRIC. Vous pouvez utiliser cette fonction pour ajouter les données d'un rapport Contributor Insights à un graphique dans l'onglet Metrics de la CloudWatch console. Vous pouvez également définir une alerte en fonction de cette fonction mathématique. Pour de plus amples informations sur les fonctions mathématiques de métrique, consultez Utilisation d'expressions mathématiques avec des CloudWatch métriques.

Pour utiliser cette fonction mathématique de métrique, vous devez être connecté à un compte disposant à la fois des autorisations cloudwatch:GetMetricData et cloudwatch:GetInsightRuleReport.

La syntaxe est INSIGHT_RULE_METRIC(ruleName, metricName). ruleName est le nom d'une règle Contributor Insights. metricName est l'une des valeurs de la liste suivante. La valeur de metricName détermine le type de données renvoyé par la fonction mathématique.

• UniqueContributors — le nombre de contributeurs uniques pour chaque point de données.

• MaxContributorValue — la valeur du contributeur le plus important pour chaque point de données. L'identité du contributeur peut changer pour chaque point de données du graphique.

  Si cette règle est agrégée par Count, le contributeur le plus important pour chaque point de données est celui qui a le plus d'occurrences au cours de cette période. Si la règle est agrégée par Sum, le contributeur principal est le contributeur dont la somme est la plus élevée dans le champ de journal spécifié par la valeur Value de la règle pendant cette période.

• SampleCount — le nombre de points de données correspondant à la règle.

• Sum — la somme des valeurs de tous les contributeurs pendant la période représentée par ce point de données.

• Minimum — la valeur minimale d'une observation unique au cours de la période représentée par ce point de données.

• Maximum — la valeur maximale d'une observation unique pendant la période représentée par ce point de données.

• Average — la valeur moyenne de tous les contributeurs au cours de la période représentée par ce point de données.

Définition d'une alerte sur les données de métrique de Contributor Insights

À l'aide de la fonction INSIGHT_RULE_METRIC, vous pouvez définir des alertes sur les métriques générées par Contributor Insights. Par exemple, vous pouvez créer une alarme basée sur le pourcentage de connexions rejetées par le protocole de contrôle de transmission (TCP). Pour commencer avec ce type d'alerte, vous pouvez créer des règles comme celles présentées dans les deux exemples suivants :

Exemple de règle : « 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"
}

Exemple de règle : « 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"
    }
}

Après avoir créé vos règles, vous pouvez sélectionner l'onglet Mesures dans la CloudWatch console, dans lequel vous pouvez utiliser les exemples d'expressions mathématiques métriques suivants pour représenter graphiquement les données rapportées par Contributor Insights :

Exemple : expressions mathématiques appliquées aux métriques

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

Dans l'exemple, l'expression mathématique métrique e3 renvoie toutes les TCP connexions rejetées. Si vous souhaitez être averti lorsque 20 % des TCP connexions sont rejetées, vous pouvez modifier l'expression en faisant passer le seuil de 100 à20.

Note

Vous pouvez définir une alerte sur une métrique que vous surveillez à partir de la section Metrics (Métriques). Pendant que vous êtes sur l'onglet Graphed metrics (Métriques sous forme de graphique), vous pouvez sélectionner l'icône Create alarm (Créer une alerte) sous la colonne Actions. L'icône Create alarm Créer une alerte) ressemble à une cloche.

Pour de plus amples informations sur la représentation graphique des métriques et l'utilisation des fonctions mathématiques des métriques, veuillez consulter la section suivante : Ajouter une expression mathématique à un CloudWatch graphique.