# Métricas em representações gráficas geradas por regras no CloudWatch
<a name="ContributorInsights-GraphReportData"></a>

O Contributor Insights fornece uma função matemática de métrica, `INSIGHT_RULE_METRIC`. Você pode usar essa função para adicionar dados de um relatório do Contributor Insights a um grafo na guia **Metrics** (Métricas) do console do CloudWatch. Você também pode definir um alarme com base nessa função matemática. Para mais informações sobre funções matemáticas de métrica, consulte [Uso de expressões matemáticas com as métricas do CloudWatch](using-metric-math.md).

Para usar essa função matemática de métrica, é necessário estar conectado em uma conta que tenha as permissões `cloudwatch:GetMetricData` e `cloudwatch:GetInsightRuleReport`.



A sintaxe é `INSIGHT_RULE_METRIC(ruleName, metricName)`. *ruleName* é o nome de uma regra do Contributor Insights, e *metricName* é um dos valores na lista a seguir. O valor de *metricName* determina qual tipo de dados a função matemática retorna.
+ `UniqueContributors`: o número de colaboradores exclusivos para cada ponto de dados.
+ `MaxContributorValue`: o valor do principal colaborador para cada ponto de dados. A identidade do colaborador pode mudar para cada ponto de dados no gráfico.

  Se essa regra for agregada por `Count`, o principal colaborador de cada ponto de dados será o colaborador com mais ocorrências nesse período. Se a regra for agregada por `Sum`, o principal colaborador será o que tiver a maior soma no campo de log especificado pelo `Value` da regra durante esse período.
+ `SampleCount`: o número de pontos de dados correspondentes pela regra.
+ `Sum`: a soma dos valores de todos os colaboradores durante o período representado por esse ponto de dados.
+ `Minimum`: o valor mínimo de uma única observação durante o período representado por esse ponto de dados.
+ `Maximum`: o valor máximo de uma única observação durante o período representado por esse ponto de dados.
+ `Average`: o valor médio de todos os colaboradores durante o período representado por esse ponto de dados.

## Definir um alarme para os dados de métrica do Contributor Insights
<a name="ContributorInsights-GraphReportData-Alarm"></a>

É possível definir alarmes em métricas geradas pelo Contributor Insights usando a função `INSIGHT_RULE_METRIC`. Por exemplo, você pode criar um alarme com base na porcentagem de conexões de Transmission Control Protocol (TCP – Protocolo de controle de transmissão) rejeitadas. Para começar com esse tipo de alarme, você pode criar regras como as mostradas nos dois exemplos a seguir:

**Exemplo de regra: "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"
}
```

**Exemplo de regra: "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"
    }
}
```

Depois de criar suas regras, você pode selecionar a guia **Metrics** (Métricas), no Console do CloudWatch, e usar as seguintes expressões matemáticas de métrica de exemplo para representar gráficos dos dados que o Contributor Insights relata:

**Exemplo: expressões matemáticas de métrica**

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

No exemplo, a expressão matemática de métrica `e3` retorna todas as conexões TCP rejeitadas. Se quiser ser notificado quando 20% das conexões TCP forem rejeitadas, você poderá modificar a expressão, alterando o limite de `100` para `20`.

**nota**  
Você pode criar um alarme em uma métrica que você está monitorando a partir da seção **Metrics** (Métricas). Enquanto estiver na guia **Graphed metrics** (Representar métricas em gráficos), você poderá selecionar o ícone **Create alarm** (Criar alarme) na coluna **Actions** (Ações). O ícone **Create alarm** (Criar alarme) parece um sino. 

Para obter mais informações sobre como criar gráficos de métricas e usar funções matemáticas de métricas, consulte a seguinte seção: [Adicionar uma expressão matemática a um gráfico do CloudWatch](using-metric-math.md#adding-metrics-expression-console).