# Representación gráfica de métricas generadas por reglas en CloudWatch
<a name="ContributorInsights-GraphReportData"></a>

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 expresiones matemáticas con métricas de CloudWatch](using-metric-math.md).

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
<a name="ContributorInsights-GraphReportData-Alarm"></a>

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](using-metric-math.md#adding-metrics-expression-console).