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.

# Tutoriel : Création d'un tableau de bord CloudWatch Lambda avec le nom de la fonction comme variable
<a name="cloudwatch_dashboard_variables_property"></a>

Les étapes de cette procédure montrent comment créer un tableau de bord flexible qui affiche divers graphiques de métriques à l'aide d'une variable de propriété. Cela inclut un menu déroulant dans le tableau de bord que vous pouvez utiliser pour changer les métriques de tous les graphiques entre les différentes fonctions Lambda. 

D'autres exemples d'utilisation de ce type de tableau de bord incluent l'utilisation en `InstanceId` tant que variable pour créer un tableau de bord de métriques avec une liste déroulante, par exemple IDs. Vous pouvez également créer un tableau de bord qui utilise `region` comme variable pour afficher le même ensemble de métriques provenant de différentes régions.

**Pour utiliser une variable de propriété de tableau de bord afin de créer un tableau de bord Lambda flexible**

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

1.  Dans le volet de navigation, sélectionnez **Tableaux de bord**, **Créer un tableau de bord**. 

1.  Saisissez un nom pour le tableau de bord, puis choisissez **Créer un tableau de bord**. 

1.  Ajoutez des widgets au tableau de bord qui affichent les métriques d'une fonction Lambda. Lorsque vous créez ces widgets, spécifiez **Lambda**, **Par nom de fonction** pour les métriques de widget. Pour la fonction, spécifiez l'une des fonctions Lambda que vous souhaitez inclure dans ce tableau de bord. 

   Pour en savoir plus sur l'ajout de widgets à un tableau de bord, consultez [Utilisation de widgets sur les CloudWatch tableaux de bord](create-and-work-with-widgets.md).

1. Après avoir ajouté les widgets, lorsque vous affichez le tableau de bord, choisissez **Actions**, **Variables**, **Créer une variable**.

1. Choisissez **Variable de propriété**.

1. Pour **Propriété modifiée par la variable**, sélectionnez **FunctionName**.

1. Pour **Type d'entrée**, pour ce cas d'utilisation, nous vous recommandons de choisir **Menu de sélection (liste déroulante)**. Cela crée un menu déroulant dans le tableau de bord dans lequel vous pouvez sélectionner le nom de la fonction Lambda pour laquelle afficher les métriques.

   S'il s'agissait d'un tableau de bord basculant entre deux ou trois valeurs uniquement pour une variable, **Bouton radio** serait un bon choix.

   Si vous préférez saisir ou coller des valeurs pour la variable, choisissez **Entrée de texte**. Cette option n'inclut pas de liste déroulante ni de boutons radio. 

1. Lorsque vous choisissez **Menu de sélection (liste déroulante)**, vous devez ensuite choisir de remplir le menu en saisissant des valeurs ou en utilisant une recherche de métriques. Pour ce cas d'utilisation, supposons que vous disposez d'un grand nombre de fonctions Lambda et que vous ne souhaitez pas toutes les saisir manuellement. Choisissez **Utiliser les résultats d'une recherche de métriques**, puis procédez comme suit :

   1. Choisissez **Requêtes prédéfinies**, **Lambda**, **Erreurs**. 

      (Le choix **des erreurs** n'ajoute pas la métrique **des erreurs** au tableau de bord. Cependant, il remplit rapidement la zone de sélection des **FunctionName**variables.)

   1. Choisissez **Par nom de fonction**, puis sélectionnez **Rechercher**.

      Sous le bouton **Rechercher**, vous verrez ensuite la case **FunctionName**sélectionnée. Un message indiquant le nombre de valeurs de **FunctionName**dimension trouvées pour remplir la zone de saisie s'affiche également.

1. (Facultatif) Pour ajouter d'autres paramètres, choisissez **Paramètres secondaires** et effectuez une ou plusieurs des opérations suivantes :
   + Pour personnaliser le nom de votre variable, saisissez-le dans **Nom de variable personnalisé**.
   + Pour personnaliser l'étiquette de la zone de saisie de variable, saisissez-la dans **Étiquette d'entrée**.
   + Pour définir la valeur par défaut de cette variable lorsque le tableau de bord est ouvert pour la première fois, saisissez la valeur par défaut dans **Valeur par défaut**.

1. Choisissez **Ajouter une variable**.

   Une boîte de sélection **FunctionName**déroulante apparaît en haut du tableau de bord. Vous pouvez sélectionner une fonction Lambda dans cette zone pour que tous les widgets utilisant la variable affichent des informations sur la fonction sélectionnée.

   Plus tard, si vous ajoutez d'autres widgets au tableau de bord qui surveillent les métriques Lambda avec la **FunctionName**dimension, ils utiliseront automatiquement la variable.