Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Rappresentazione grafica delle metriche generate dalle regole in CloudWatch
<a name="ContributorInsights-GraphReportData"></a>

Contributor Insights fornisce una funzione matematica dei parametri, `INSIGHT_RULE_METRIC`. Puoi utilizzare questa funzione per aggiungere dati da un rapporto di Contributor Insights a un grafico nella scheda **Metriche** della console. CloudWatch Puoi anche impostare un allarme basato su questa funzione matematica. Per ulteriori informazioni sulle funzioni matematiche dei parametri, consulta [Utilizzo di espressioni matematiche con metriche CloudWatch](using-metric-math.md)

Per utilizzare questa funzione matematica dei parametri, devi aver effettuato l'accesso a un account che dispone delle autorizzazioni `cloudwatch:GetMetricData` e `cloudwatch:GetInsightRuleReport`.



La sintassi è. `INSIGHT_RULE_METRIC(ruleName, metricName)` *ruleName*è il nome di una regola di Contributor Insights. *metricName*è uno dei valori nell'elenco seguente. Il valore di *metricName* determina il tipo di dati restituito dalla funzione matematica.
+ `UniqueContributors`: il numero di fattori univoci per ogni punto dati.
+ `MaxContributorValue`: il valore del fattore principale per ogni punto dati. L'identità del collaboratore può cambiare per ogni punto dati nel grafico.

  Se questa regola viene aggregata per `Count`, il collaboratore principale per ogni punto dati è quello con il maggior numero di occorrenze in tale periodo. Se la regola viene aggregata per `Sum`, il collaboratore principale è quello con la somma maggiore nel campo di log specificato dal `Value` della regola, durante tale periodo.
+ `SampleCount`: il numero di punti dati corrispondenti alla regola.
+ `Sum`: la somma dei valori di tutti i fattori durante il periodo di tempo rappresentato da tale punto dati.
+ `Minimum`: il valore minimo ottenuto da un'unica osservazione durante il periodo di tempo rappresentato da tale punto dati.
+ `Maximum`: il valore massimo ottenuto da un'unica osservazione durante il periodo di tempo rappresentato da tale punto dati.
+ `Average`: il valore medio di tutti i fattori durante il periodo di tempo rappresentato da tale punto dati.

## Impostazione di un allarme sui dati dei parametri Contributor Insights
<a name="ContributorInsights-GraphReportData-Alarm"></a>

Usando la funzione `INSIGHT_RULE_METRIC`, puoi impostare allarmi sui parametri generati da Contributor Insights. Ad esempio, puoi creare un allarme in base alla percentuale di connessioni TCP (transmission control protocol) che sono state rifiutate. Per iniziare a utilizzare questo tipo di allarme, puoi creare regole come quelle mostrate nei due esempi seguenti:

**Regola di esempio: "" 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"
}
```

**Regola di esempio: "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"
    }
}
```

Dopo aver creato le regole, puoi selezionare la scheda **Metriche** nella CloudWatch Console, dove puoi utilizzare i seguenti esempi di espressioni matematiche delle metriche per rappresentare graficamente i dati riportati da Contributor Insights:

**Esempio: espressioni matematiche dei parametri**

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

Nell'esempio, l'espressione matematica dei parametri `e3` restituisce tutte le connessioni TCP rifiutate. Se si desidera ricevere una notifica quando il 20% delle connessioni TCP viene rifiutato, puoi modificare l'espressione cambiando la soglia da `100` a `20`.

**Nota**  
Puoi impostare un allarme su un parametro che stai monitorando dalla sezione **Metrics** (Parametri). Nella scheda **Graphed metrics** (Parametri nel grafico), puoi selezionare l'icona **Create alarm** (Crea allarme) nella colonna **Actions** (Operazioni). L'icona **Create alarm** (Crea allarme) ha l'aspetto di una campanella. 

Per ulteriori informazioni sulla rappresentazione grafica di parametri e sull'utilizzo di funzioni matematiche dei parametri, consulta la seguente sezione: [Aggiungi un'espressione matematica a un grafico CloudWatch](using-metric-math.md#adding-metrics-expression-console).