# チュートリアル: 関数名を変数として使用した CloudWatch Lambda ダッシュボードの作成
<a name="cloudwatch_dashboard_variables_property"></a>

この手順のステップでは、プロパティ変数を使用して、さまざまなメトリクスグラフを表示する柔軟なダッシュボードを作成する方法を示します。これには、異なる Lambda 関数間ですべてのグラフのメトリクスを切り替えるために使用できるダッシュボード上のドロップダウン選択ボックスが含まれます。

このタイプのダッシュボードに関するユースケースの他の例には、インスタンス ID のドロップダウンを備えたメトリクスのダッシュボードを作成する変数として `InstanceId` を使用することが含まれます。あるいは、異なるリージョンの同じ一連のメトリクスを表示する変数として `region` を使用するダッシュボードを作成することもできます。

**ダッシュボードプロパティ変数を使用して柔軟な Lambda ダッシュボードを作成するには**

1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。

1.  ナビゲーションペインで [**ダッシュボード**]、[**Create dashboard**] の順に選択します。

1.  ダッシュボードの名前を入力し、**[ダッシュボードを作成]** を選択します。

1.  Lambda 関数のメトリクスを表示するウィジェットをダッシュボードに追加します。これらのウィジェットを作成する際には、ウィジェットのメトリクスに **[Lambda]**、**[関数名別]** を指定します。関数には、このダッシュボードに含めるいずれかの Lambda 関数を指定します。

   ダッシュボードへのウィジェットの追加の詳細については、「[CloudWatch ダッシュボードでのウィジェットの使用](create-and-work-with-widgets.md)」を参照してください。

1. ウィジェットを追加した後、ダッシュボードを表示しながら、**[アクション]**、**[変数]**、**[変数を作成]** の順に選択します。

1. **[プロパティ変数]** を選択します。

1. **[変数が変更するプロパティ]** で、**[FunctionName]** を選択します。

1. このユースケースでは、**[入力タイプ]** で **[メニューを選択 (ドロップダウン)]** を選択することをお勧めします。これにより、ダッシュボードにドロップダウンメニューが作成され、メトリクスを表示する Lambda 関数名を選択できます。

   これが、ある変数について、2 つまたは 3 つの異なる値を切り替えるダッシュボード用である場合は、**[ラジオボタン]** が適切な選択になります。

   変数の値を入力または貼り付けたい場合は、**[テキスト入力]** を選択します。このオプションにはドロップダウンリストやラジオボタンは含まれません。

1. **[メニューを選択 (ドロップダウン)]** を選択した場合は、メニューを設定するために、値を入力するか、またはメトリクス検索を使用するかを選択する必要があります。このユースケースでは、多数の Lambda 関数があり、それらのすべてを手動で入力することを望んでいないと仮定します。**[メトリクス検索の結果を使用]** を選択し、次の操作を実行します。

   1. **[事前構築済みのクエリ]**、**[Lambda]**、**[エラー]** を選択します。

      (**[エラー]** を選択しても、ダッシュボードには **[エラー]** メトリクスは追加されません。ただし、**[FunctionName]** 変数選択ボックスにはすぐに値が入力されます。)

   1. **[関数名別]** を選択し、**[検索]** を選択します。

      **[検索]** ボタンの下に、**[FunctionName]** が選択されていることが表示されます。また、入力ボックスにデータを入力するための値として見つかった、**[FunctionName]** ディメンションの値の数に関するメッセージも表示されます。

1. (オプション) その他の設定については、**[二次設定]** を選択し、次の 1 つ以上を実行します。
   + 変数の名前をカスタマイズするには、**[カスタム変数名]** に名前を入力します。
   + 変数入力フィールドのラベルをカスタマイズするには、**[入力ラベル]** にラベルを入力します。
   + ダッシュボードを最初に開いたときにこの変数のデフォルト値を設定するには、**[デフォルト値]** でデフォルト値を入力します。

1. **[変数を追加]** を選択します。

   **[FunctionName]** ドロップダウン選択ボックスがダッシュボードの上部近くに表示されます。このボックスで Lambda 関数を選択すると、その変数を使用するすべてのウィジェットで、選択した関数に関する情報が表示されます。

   後で、**[FunctionName]** ディメンションで Lambda メトリクスを監視するウィジェットをダッシュボードにさらに追加すると、それらのウィジェットは自動的にその変数を使用します。