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à.

# Crea un CloudWatch grafico con un'espressione di ricerca
<a name="create-search-expression"></a>

Sulla CloudWatch console, puoi accedere alle funzionalità di ricerca quando aggiungi un grafico a una dashboard o utilizzando la vista **Metriche**. 

Non puoi creare un allarme in base a un'espressione **SEARCH**. Questo perché le espressioni di ricerca restituiscono più serie temporali e un allarme basato su un'espressione matematica può osservare solo una serie temporale.

**Per aggiungere un grafico con un'espressione di ricerca a un pannello di controllo esistente**

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, seleziona **Dashboards** (Pannelli di controllo), quindi seleziona un pannello di controllo.

1. Seleziona **Add widget** (Aggiungi widget).

1. Seleziona **Line** (Linea) o **Stacked area** (Area in pila), quindi seleziona **Configure** (Configura).

1. Nella scheda **Graphed metrics** (Parametri del grafico), scegli **Add a math expression** (Aggiungi un'espressione matematica).

1.  In **Details** (Dettagli), immetti l'espressione di ricerca desiderata. Ad esempio, **SEARCH('\$1AWS/EC2,InstanceId\$1 MetricName="CPUUtilization"', 'Average')** 

1. (Opzionale) Per aggiungere al grafico un'altra espressione di ricerca o un'espressione matematica, scegli **Add a math expression** (Aggiungi una espressione matematica)

1. (Facoltativo) Dopo aver aggiunto un'espressione di ricerca, è possibile specificare che un'etichetta dinamica venga visualizzata sulla legenda del grafico legenda per ogni parametro. Le etichette dinamiche visualizzano una statistica sul parametro e vengono aggiornate automaticamente quando il pannello di controllo o il grafico viene aggiornato. Per aggiungere un'etichetta dinamica, scegli **Graphed metrics** (Parametri definiti), quindi **Dynamic labels (Etichette dinamiche)**.

   Per impostazione predefinita, i valori dinamici aggiunti all'etichetta vengono visualizzati all'inizio dell'etichetta. È quindi possibile fare clic sul valore **Label** (Etichetta) per il parametro per modificare l'etichetta. Per ulteriori informazioni, consulta [Utilizzo di etichette dinamiche](graph-dynamic-labels.md).

1. (Opzionale) Per aggiungere un singolo parametro grafico, scegli la scheda **All metrics** (Tutti i parametri) e sposti su quello desiderato.

1. (Opzionale) Per modificare l'intervallo temporale mostrato sul grafico, scegli **custom** (personalizzato) nella parte superiore del grafico o uno dei periodi temporali a sinistra di **custom** (personalizzato).

1. <a name="horizontal-annotations"></a> (Facoltativo) Le annotazioni orizzontali consentono agli utenti del pannello di controllo di vedere rapidamente quando un parametro è aumentato fino a un determinato livello o se il parametro si trova all'interno di un intervallo predefinito. Per aggiungere un'annotazione orizzontale, scegli **Graph options** (Opzioni del grafico), **Add horizontal annotation** (Aggiungi annotazione orizzontale):

   1. In **Label** (Etichetta), immetti un'etichetta per l'annotazione.

   1. In **Value** (Valore), immetti un valore del parametro in cui è visualizzata l'annotazione orizzontale.

   1. In **Fill** (Riempi), specifica se utilizzare un'ombreggiatura di riempimento con questa annotazione. Ad esempio, seleziona `Above` o `Below` per l'area corrispondente da riempire. Se specifichi `Between`, viene visualizzato un altro campo `Value` e viene riempita l'area del grafico tra i due valori.

   1. Se il grafico include più parametri, in **Axis** (Asse), specificare se i numeri di `Value` fanno riferimento al parametro associato all'asse y sinistro o all'asse y destro.

      Puoi modificare il colore di riempimento di un'annotazione selezionando il quadrato colori nella colonna sinistra dell'annotazione. 

   Ripeti queste fasi per aggiungere più annotazioni orizzontali allo stesso grafico.

   Per nascondere un'annotazione, deseleziona la casella di controllo nella colonna sinistra per tale annotazione.

   Per cancellare un'annotazione, seleziona **x** nella colonna **Actions** (Operazioni).

1. <a name="vertical-annotations"></a> (Facoltativo) Le annotazioni verticali consentono di contrassegnare milestone in un grafico, ad esempio eventi operativi o l'inizio e la fine di una distribuzione. Per aggiungere un'annotazione verticale, scegli **Graph options** (Opzioni del grafico), quindi **Add vertical annotation** (Aggiungi annotazione verticale):

   1. In **Label** (Etichetta), immetti un'etichetta per l'annotazione. Per mostrare solo la data e l'orario dell'annotazione, lasciare il campo **Label** (Etichetta) vuoto.

   1. In **Date** (Data), specificare la data e l'ora in cui è visualizzata l'annotazione verticale.

   1. In **Fill** (Riempi), specificare se utilizzare un'ombreggiatura di riempimento prima o dopo un'annotazione verticale o tra due annotazioni verticali. Ad esempio, seleziona `Before` o `After` per l'area corrispondente da riempire. Se specifichi `Between`, viene visualizzato un altro campo `Date` e viene riempita l'area del grafico tra i due valori.

   Ripeti queste fasi per aggiungere più annotazioni verticali allo stesso grafico.

   Per nascondere un'annotazione, deseleziona la casella di controllo nella colonna sinistra per tale annotazione.

   Per cancellare un'annotazione, seleziona **x** nella colonna **Actions** (Operazioni).

1. Seleziona **Crea widget**.

1. Seleziona **Salva pannello di controllo**.

**Per utilizzare la vista Metrics (Parametri) per la rappresentazione grafica dei parametri cercati**

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, seleziona **Metrics** (Parametri), **All metrics** (Tutti i parametri).

1. Nel campo di ricerca, immetti il token da cercare: ad esempio, **cpuutilization t2.small**.

   Verranno visualizzati i risultati che corrispondono alla ricerca.

1. Per rappresentare graficamente tutti i parametri che corrispondono alla ricerca, scegli **Graph search (Ricerca del grafico)**.

   or

   Per perfezionare la ricerca, scegli uno degli spazi dei nomi visualizzati nei risultati di ricerca.

1. Se hai selezionato uno spazio dei nomi per limitare i risultati, puoi eseguire le operazioni descritte di seguito. 

   1. Per rappresentare graficamente uno o più parametri, seleziona la casella di controllo accanto a ciascun parametro. Per selezionare tutte i parametri, seleziona la casella di controllo nella riga dell'intestazione della tabella.

   1. Per delimitare la ricerca, passa il mouse su un nome parametro e scegli **Add to search** (Aggiungi alla ricerca) o **Search for this only** (Cerca solo questo).

   1. Per visualizzare la guida di un parametro, seleziona il nome parametro, quindi seleziona **What is this?** (Che cos'è questo?).

   I parametri selezionati vengono visualizzati nel grafico.

1. (Opzionale) Seleziona uno dei pulsanti nella barra di ricerca per modificare tale parte del termine di ricerca.

1. (Opzionale) Per aggiungere il grafico a un pannello di controllo, seleziona **Actions** (Operazioni), **Add to dashboard** (Aggiungi a pannello di controllo).