Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'un CloudWatch graphique avec une expression de recherche
<a name="create-search-expression"></a>

Sur la CloudWatch console, vous pouvez accéder à la fonctionnalité de recherche lorsque vous ajoutez un graphique à un tableau de bord ou en utilisant la vue **Metrics**. 

Vous ne pouvez pas créer une alerte basée sur une expression **SEARCH**. En effet, les expressions de recherche renvoient plusieurs séries temporelles et une alerte basée sur une expression mathématique ne peut regarder qu'une seule série temporelle.

**Pour ajouter un graphique avec une expression de recherche à un tableau de bord existant**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, choisissez **Dashboards (Tableaux de bord)**, puis sélectionnez un tableau de bord.

1. Sélectionnez **Add widget (Ajouter un widget)**.

1. Choisissez **Line (Ligne)** ou **Stacked area (Zone empilée)**, puis **Configure (Configurer)**.

1. Dans l'onglet **Graphed metrics (Graphique des métriques)**, choisissez **Add a math expression (Ajouter une expression mathématique)**.

1.  Pour **Details (Détails)**, saisissez l'expression de recherche que vous souhaitez. Par exemple, **SEARCH('\$1AWS/EC2,InstanceId\$1 MetricName="CPUUtilization"', 'Average')** 

1. (Facultatif) Pour ajouter une autre expression de recherche ou expression mathématique au graphique, choisissez **Add a math expression (Ajouter une expression mathématique)**

1. (Facultatif) Une fois que vous avez ajouté une expression de recherche, vous pouvez spécifier une étiquette dynamique à faire apparaître sur la légende du graphique pour chaque métrique. Les étiquettes dynamiques affichent une statistique sur la métrique et se mettent automatiquement à jour lorsque le tableau de bord ou le graphique est actualisé. Pour ajouter une étiquette dynamique, choisissez **Graphed metrics (Graphique des métriques)**, puis **Dynamic labels (Étiquettes dynamiques)**.

   Par défaut, les valeurs dynamiques que vous ajoutez à l'étiquette apparaissent au début de l'étiquette. Vous pouvez ensuite cliquer sur la valeur **Label (Étiquette)** de la métrique pour modifier l'étiquette. Pour de plus amples informations, veuillez consulter [Utiliser des étiquettes dynamiques](graph-dynamic-labels.md).

1. (Facultatif) Pour ajouter une seule métrique au graphique, choisissez l'onglet **All metrics (Toutes les métriques)** et explorez jusqu'à trouver la métrique voulue.

1. (Facultatif) Pour modifier l'intervalle de temps indiqué sur le graphique, choisissez **custom (personnalisé)** en haut du graphique, ou choisissez l'une des périodes situées à gauche de **custom (personnalisé)**.

1. <a name="horizontal-annotations"></a> (Facultatif) Les annotations horizontales permettent aux utilisateurs du tableau de bord de voir rapidement quand une métrique a des pics à un certain niveau, ou si la métrique se trouve dans une plage prédéfinie. Pour ajouter une annotation horizontale, choisissez **Graph options (Options de graphique)**, puis **Add horizontal annotation (Ajouter une annotation horizontale)** :

   1. Pour **Label (Étiquette)**, saisissez une étiquette pour l'annotation.

   1. Pour **Value (Valeur)**, saisissez la valeur de métrique où apparaît l'annotation horizontale.

   1. Pour **Fill (Remplissage)**, spécifiez s'il faut utiliser un ombrage de remplissage avec cette annotation. Par exemple, choisissez `Above` ou `Below` pour que la zone correspondante soit remplie. Si vous spécifiez `Between`, un autre champ `Value` apparaît et la zone du graphique entre les deux valeurs est remplie.

   1. Pour **Axis (Axe)**, spécifiez si les nombres dans `Value` font référence à la métrique associée à l'axe des Y de gauche ou à l'axe des Y de droite si le graphique comprend plusieurs métriques.

      Vous pouvez modifier la couleur de remplissage d'une annotation en choisissant le carré de couleur dans la colonne de gauche de cette annotation. 

   Répétez ces étapes pour ajouter plusieurs annotations horizontales au même graphique.

   Pour masquer une annotation, décochez la case dans la colonne de gauche de cette annotation.

   Pour supprimer une annotation, choisissez **x** dans la colonne **Actions**.

1. <a name="vertical-annotations"></a> (Facultatif) Les annotations verticales vous aident à indiquer les étapes importantes dans un graphique, par exemple les événements opérationnels ou le début et la fin d'un déploiement. Pour ajouter une annotation verticale, choisissez **Graph options (Options de graphique)**, puis **Add vertical annotation (Ajouter des annotations verticales)** :

   1. Pour **Label (Étiquette)**, saisissez une étiquette pour l'annotation. Pour afficher seulement la date et l'heure sur l'annotation, ne renseignez pas le champ **Label (Étiquette)**.

   1. Pour **Date**, spécifiez la date et l'heure de l'affichage de l'annotation verticale.

   1. Pour **Fill (Remplir)**, indiquez si l'ombrage de remplissage doit être utilisé avant ou après une annotation verticale, ou entre deux annotations verticales. Par exemple, choisissez `Before` ou `After` pour que la zone correspondante soit remplie. Si vous spécifiez `Between`, un autre champ `Date` apparaît et la zone du graphique entre les deux valeurs est remplie.

   Répétez ces étapes pour ajouter plusieurs annotations verticales au même graphique.

   Pour masquer une annotation, décochez la case dans la colonne de gauche de cette annotation.

   Pour supprimer une annotation, choisissez **x** dans la colonne **Actions**.

1. Choisissez **Create widget (Créer un widget)**.

1. Choisissez **Save dashboard (Enregistrer le tableau de bord)**.

**Pour utiliser l'affichage des métriques afin de tracer les métriques recherchées**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, sélectionnez **Métriques**, **Toutes les métriques**.

1. Dans le champ de recherche, saisissez les jetons à rechercher : par exemple, **cpuutilization t2.small**.

   Les résultats correspondant à votre recherche s'affichent.

1. Pour représenter graphiquement toutes les métriques correspondant à votre recherche, choisissez **Graph search (Tracer la recherche)**.

   or

   Pour affiner votre recherche, choisissez l'un des espaces de noms qui apparaît dans vos résultats de recherche.

1. Si vous avez sélectionné un espace de noms pour affiner vos résultats, vous pouvez effectuer les opérations suivantes : 

   1. Pour représenter graphiquement une ou plusieurs métriques, cochez la case en regard de chaque métrique. Pour sélectionner toutes les métriques, cochez la case dans la ligne d’en-tête du tableau.

   1. Pour affiner votre recherche, passez la souris sur un nom de métrique et **Add to search (Ajouter à la recherche)** ou **Search for this only (Rechercher uniquement ceci)**.

   1. Pour afficher l'aide relative à une métrique, sélectionnez le nom de la métrique, puis **What is this? (De quoi s'agit-il ?)**.

   Les métriques sélectionnées apparaissent sur le graphique.

1. (Facultatif) Sélectionnez l'un des boutons dans la barre de recherche pour modifier cette partie du terme recherché.

1. (Facultatif) Pour ajouter le graphique à un tableau de bord, choisissez **Actions**, puis **Add to dashboard (Ajouter au tableau de bord)**.