Representación gráfica de métricas generadas por reglas

Contributor Insights proporciona una función de cálculo de métricas, INSIGHT_RULE_METRIC. Puede utilizar esta función para agregar datos de un informe de Contributor Insights a un gráfico en la pestaña Metrcis (Métricas) de la consola de CloudWatch. También puede establecer una alarma basada en esta función matemática. Para obtener más información acerca de las funciones de cálculo de métricas, consulte Uso de la calculadora de métricas.

Para utilizar esta función matemática de métricas, debe haber iniciado sesión en una cuenta que tenga los permisos cloudwatch:GetMetricData y cloudwatch:GetInsightRuleReport.

La sintaxis es INSIGHT_RULE_METRIC(ruleName, metricName). ruleName es el nombre de una regla de Contributor Insights y metricName es uno de los valores de la lista siguiente. El valor de metricName determina qué tipo de datos devuelve la función matemática.

• UniqueContributors: el número de colaboradores únicos para cada punto de datos.

• MaxContributorValue: el valor del colaborador principal para cada punto de datos. La identidad del colaborador puede cambiar en cada punto de datos del gráfico.

  Si la regla agrega por Count, el colaborador principal de cada punto de datos es el colaborador que más veces aparece en ese período. Si la regla agrega por Sum, el colaborador principal es aquel con la suma más alta en el campo de registro especificado por el Value de la regla durante ese período.

• SampleCount: el número de puntos de datos que concuerdan con la regla.

• Sum: la suma de los valores de todos los colaboradores durante el periodo de tiempo representado por ese punto de datos.

• Minimum: el valor mínimo de una sola observación durante el período de tiempo representado por ese punto de datos.

• Maximum: el valor máximo de una sola observación durante el período de tiempo representado por ese punto de datos.

• Average: el valor promedio de todos los colaboradores durante el período de tiempo representado por ese punto de datos.

Configuración de una alarma en los datos de métricas de Contributor Insights

Puede configurar alarmas para las métricas generadas por Contributor Insights mediante la función INSIGHT_RULE_METRIC. Por ejemplo, podría crear una alarma en función del porcentaje de conexiones de protocolo de control de transmisión (TCP) que se han rechazado. Para empezar a utilizar este tipo de alarma, puede crear reglas como las que se muestran en los dos ejemplos siguientes:

Regla de ejemplo: “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"
}

Regla de ejemplo: “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"
    }
}

Después de crear las reglas, puede seleccionar la pestaña Metrics (Métricas) en la consola de CloudWatch, donde puede utilizar las siguientes expresiones matemáticas de métricas de ejemplo para graficar los datos que informa Contributor Insights:

Ejemplo: expresiones matemáticas de métricas

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

En el ejemplo, la expresión matemática de métrica e3 devuelve todas las conexiones TCP rechazadas. Si desea recibir una notificación cuando se rechace el 20 por ciento de las conexiones TCP, puede modificar la expresión cambiando el umbral de 100 a 20.

nota

Puede configurar una alarma para una métrica que esté supervisando desde la sección Metrics (Métricas). Mientras está en la pestaña Graphed metrics (Métricas en gráficos), puede seleccionar el icono Create alarm (Crear alarma) en la columna Actions (Acciones). El icono Create alarm (Crear alarma) parece una campana.

Para obtener más información acerca de la representación gráfica de métricas y el uso de funciones matemáticas de métricas, consulte la sección Añadir una expresión matemática a un gráfico de CloudWatch.