ダッシュボード ウィジェットの作成と管理

このページでは、ダッシュボード ビューからのグラフの作成と編集に重点を置いて説明します。 グラフを作成するためのもう 1 つのツールである Metrics Explorer に関心をお持ちの場合は、Metrics Explorer の使用をご覧ください。

テキスト ボックスを除くすべてのダッシュボード ウィジェットに、数値または分布値を含むカスタム指標ログベースの指標などの指標タイプを表示できます。ダッシュボードのウィジェットでは、文字列型のデータをグラフ化することはできません。次のスクリーンショットは、カラーモードの折れ線グラフの例です。これらのグラフでは、各時系列に一意の色が割り当てられています。

カラーモードの折れ線グラフの例。

準備

認証で説明されているロールのいずれか 1 つがあることを確認します。

ダッシュボード エディタの選択

ダッシュボード エディタには、プレビュークラシックの 2 種類があります。

  • クラシック: このエディタでは、ダッシュボードは折れ線グラフに最適化され、グラフはグリッド パターンで表示されます。あるウィジェット タイプのグラフを別のウィジェット タイプに変換できます。たとえば、折れ線グラフを積み上げ棒グラフに変換することができます。スコアカード、ゲージ、テキスト ボックスは、表示できますが作成や変更はできません。

    このエディタを使用するには、ダッシュボードの詳細ウィンドウで [クラシック] を選択します。

    プレビュー エディタに切り替えるには、ダッシュボードの詳細ウィンドウで [クラシック] をクリックし、[ダッシュボード エディタをプレビュー] を選択します。

    プレビューの編集機能を選択します。

  • プレビュー: このエディタでは、豊富なウィジェットと、グラフの柔軟なサイズと位置のオプションを選択できます。このエディタを使用すると、スコアカード、ゲージ、テキスト ボックスを作成、編集できます。ただし、あるウィジェット タイプを別のウィジェット タイプに変換することはできません。たとえば、折れ線グラフを積み上げ棒グラフに変換することはできません。

    ダッシュボードにウィジェットを追加する際には、複数の構成オプションが用意されています。

    • ウィジェットをすばやく構成するには、基本モードを使用します。この選択肢には、最小限の構成オプションが用意されています。

    • すべてのウィジェット設定フィールドにアクセスするには、詳細モードを使用します。このモードでは、ほとんどの [集計] フィールドにアクセスできます。

    • クエリ言語を使用してウィジェットを構成するには、MQL モードを使用します。

    このエディタを使用するには、ダッシュボードの詳細ウィンドウで [プレビュー] を選択します。

    クラシック エディタに切り替えるには、ダッシュボードの詳細ウィンドウで [プレビュー] をクリックし、[クラシック ダッシュボード エディタを表示] を選択します。

    クラシック編集機能を選択します。

ダッシュボード ウィジェットの追加

グラフの設計プロセスには、次のようなタスクが含まれます。

  1. 表示する情報の種類とデータを表示する最適な方法を決定します。

    • ある時間間隔にわたって時系列データを表示する場合は、折れ線グラフ、積み上げ面グラフ、積み上げ棒グラフ、またはヒートマップ グラフを追加します。積み上げ棒グラフは、頻度の低いサンプル(1 日に 1 つのサンプルがある割り当て指標など)におすすめします。ヒートマップは、分布タイプの指標に使用することをおすすめします。これらのグラフでは、分布全体とオーバーレイのパーセンタイル ライン全体を表示できます。

      これらのグラフは、しきい値の表示、外れ値のみの表示、現在のデータと過去のデータの比較を行うように設定できます。

    • 最新の値がリスクゾーン、警告ゾーン、または想定範囲内にあるかどうかを確認するには、ゲージまたはスコアカードを追加します。これらのウィジェットは、Preview Editor または Cloud Monitoring API を使用して作成および変更できます。

    • ダッシュボードに関する情報やさまざまな状況での対応方法を追加する場合は、テキスト ボックスを追加します。このウィジェットは、Preview Editor または Cloud Monitoring API を使用して作成および編集できます。

    ウィジェットの種類の例については、ダッシュボード ウィジェットをご覧ください。

  2. グラフに表示するデータを特定します。詳細については、グラフ化するデータの選択をご覧ください。

ダッシュボードには最大で 25 のウィジェットを配置できます。

ダッシュボードにウィジェットを追加する一般的な手順

このセクションでは、ウィジェットをダッシュボードに追加する方法について説明します。ウィジェットの構成については、ダッシュボード ウィジェットの構成をご覧ください。

プレビュー エディタ

ダッシュボードにウィジェットを追加する際の手順は、次のとおりです。

  1. Cloud Console で [モニタリング] を選択するか、次のボタンをクリックします。

    [モニタリング] に移動

  2. Monitoring のナビゲーション パネルで、 [ダッシュボード] をクリックします。

    • 新しいダッシュボードを作成する場合は、[ダッシュボードを作成] をクリックします。
    • 既存のダッシュボードを更新するには、[最近のダッシュボード] の下に表示されたダッシュボード タイルをクリックするか、すべてのダッシュボードのリストでダッシュボードを見つけて、その名前をクリックします。
  3. ダッシュボードのツールバーに [プレビュー] と表示され、[編集] 切り替えボタンが [オン] の位置にあることを確認します。

  4. ダッシュボードに追加する [グラフ ライブラリ] のウィジェットをクリックします。ライブラリからグラフ領域にウィジェットをドラッグすることもできます。

    事前構成済みのウィジェットが表示されます。ただし、この構成は変更できます。

    次のスクリーンショットは、折れ線グラフとその構成ペインを示しています。

    ダッシュボードに追加された折れ線グラフの例。

    ポインタを使用して、ダッシュボードでウィジェットのサイズと位置を変更できます。

  5. ウィジェットの設定ペインを使用してウィジェットを構成します。ダッシュボードが編集モードになっており、ウィジェットが選択されると、構成パネルが表示されます。

    • ウィジェットをすばやく構成するには、基本モードを使用します。この選択肢には、最小限の構成オプションが用意されています。基本構成は、常に他のモードで表すことができます。

    • すべてのウィジェット設定フィールドにアクセスするには、詳細モードを使用します。このモードでは、ほとんどの [集計] フィールドにアクセスできます。このモードはすべてのウィジェット タイプで使用できるわけではありません。

      高度な構成は、シンプルな基本モードでは表示できない可能性があります。

    • クエリ言語を使用してウィジェットを構成するには、MQL モードを使用します。このモードでは、クエリエディタにアクセスできます。MQL を使用する場合、その構成は他のモードで表できません。MQL の詳細については、MQL の概要をご覧ください。

  6. [Save dashboard] をクリックします。

  7. (省略可)ダッシュボード ツールバーで、[Add chart] をクリックしてグラフ ライブラリを有効にしてから、ダッシュボードに追加するウィジェットごとに前の手順を繰り返します。

クラシック エディタ

折れ線グラフ、積み上げ面グラフ、棒グラフ、ヒートマップをダッシュボードに追加する手順は次のとおりです。

  1. Cloud Console で [モニタリング] を選択するか、次のボタンをクリックします。

    [モニタリング] に移動

  2. Monitoring のナビゲーション パネルで、 [ダッシュボード] をクリックします。

    • 新しいダッシュボードを作成する場合は、[ダッシュボードを作成] をクリックします。
    • 既存のダッシュボードを更新するには、[最近のダッシュボード] の下に表示されたダッシュボード タイルをクリックするか、すべてのダッシュボードのリストでダッシュボードを見つけて、その名前をクリックします。
  3. ダッシュボードのツールバーに [クラシック] と表示されていることを確認します。

  4. ダッシュボードの詳細ビューで、[グラフを追加] をクリックします。ワークスペースの編集権限がある場合、このボタンはダッシュボード ツールバーに表示されます。

  5. グラフを構成します。

  6. [Save] をクリックします。

ダッシュボード ウィジェットの構成

このセクションでは、ダッシュボード ウィジェットを構成する方法について説明します。

グラフの構成

このセクションでは、グラフの構成方法について説明します。Google Cloud Console を使用してダッシュボードにグラフを追加する方法については、ウィジェットをダッシュボードに追加する一般的な手順をご覧ください。Cloud Monitoring API の使用に関心がある場合は、XyChart ウィジェットを含むダッシュボードをご覧ください。

プレビュー エディタ

折れ線グラフ、積み上げ面グラフ、棒グラフ、またはヒートマップ グラフを構成する手順は次のとおりです。

基本モードでのグラフの構成

  1. 表示する時系列データを選択します。

    • [リソースタイプ] と [指標] を変更するには、メニューから選択します。[リソースタイプ] メニューには、指標データが存在するすべてのモニタリング対象リソースが一覧表示されます。[指標] メニューは、[リソースタイプ] での選択によって異なります。

      • メニューで特定のエントリを検索するには、スクロールバーを使用するか、メニューの「Filter エリアにテキストを入力します。テキストを入力すると、メニュー エントリは、入力されたテキストが含まれるエントリに限られます。

      • まだデータが存在しないリソースタイプまたは指標にアクセスする場合は、デフォルトの動作を変更する必要があります。

        • 任意のリソースタイプを選択できるようにするには、[リソースタイプ] メニューを展開して [有効な場合のみ表示] をオフにします。

        • データが存在しない指標も含めて、選択したリソースタイプのすべての指標を表示するには、[Metric] メニューを展開して、[Only show active] をオフにします。

        • 任意の指標を選択できるようにするには、[Resource type] メニューで「Close をクリックして、目的のエントリを見つけます。リソースタイプで「Close」をクリックすると、[Metric] メニューに指標がすべて表示されます。

        • Cloud Monitoring API で使用するリソースタイプ、指標、フィルタ設定を表示または編集するには、[リソースタイプ] メニューの [ダイレクト フィルタ モード] をクリックします。

    • フィルタを追加するには、[フィルタを追加] をクリックし、ラベルとラベルの値を選択します。複数のフィルタを追加できます。たとえば、1 つのゾーンのデータを表示するには、フィルタを適用します。詳細については、グラフ化するデータの選択をご覧ください。

  2. すべての時系列を表示する、またはラベル値で時系列をグループ化するかを決定します。

    • すべての時系列を表示するには、[グループ化済み] をオフのままにします。
    • ラベル値で時系列をグループ化するには、[グループ化済み] をオンにしてから [グループ条件] メニューを使用してグループ化するラベルを選択します。選択したら、[OK] をクリックします。
  3. データポイントを組み合わせる方法を決定します。

    • ラジオボタンにパーセンタイルのみが表示されている場合は、分布値を持つ指標が選択されています。ラジオボタンを使用して、表示する分布のパーセンタイルを選択します。

    • ラジオボタンに meanminmax が記載されている場合は、数値を持つ指標が選択されています。このボタンを使用すると、グラフ作成プロセスの一環として、データポイントの組み合わせ方法を指定できます。たとえば、グラフに 60 個のデータポイントが表示され、データは 1 分あたり 1 ポイント書き込まれる場合、グラフには 1 時間分のデータを表示できます。3 時間分のデータを表示するには、データポイントを 180 から 60 に減らす必要があります。このセレクタが mean の場合、グラフの各ポイントは、元の時系列の 3 つのポイントの平均値です。

  4. (省略可)グラフでのデータの表示方法を構成するには、[設定] をクリックします。

    グラフの凡例については、凡例の構成をご覧ください。

詳細モードでのグラフの構成

  1. 表示する時系列データを選択します。

    • [リソースタイプ] と [指標] を変更するには、メニューから選択します。[リソースタイプ] メニューには、指標データが存在するすべてのモニタリング対象リソースが一覧表示されます。[指標] メニューは、[リソースタイプ] での選択によって異なります。

      • メニューで特定のエントリを検索するには、スクロールバーを使用するか、メニューの「Filter エリアにテキストを入力します。テキストを入力すると、メニュー エントリは、入力されたテキストが含まれるエントリに限られます。

      • まだデータが存在しないリソースタイプまたは指標にアクセスする場合は、デフォルトの動作を変更する必要があります。

        • 任意のリソースタイプを選択できるようにするには、[リソースタイプ] メニューを展開して [有効な場合のみ表示] をオフにします。

        • データが存在しない指標も含めて、選択したリソースタイプのすべての指標を表示するには、[Metric] メニューを展開して、[Only show active] をオフにします。

        • 任意の指標を選択できるようにするには、[Resource type] メニューで「Close をクリックして、目的のエントリを見つけます。リソースタイプで「Close」をクリックすると、[Metric] メニューに指標がすべて表示されます。

        • Cloud Monitoring API で使用するリソースタイプ、指標、フィルタ設定を表示または編集するには、[リソースタイプ] メニューの [ダイレクト フィルタ モード] をクリックします。

    • フィルタを追加するには、[フィルタを追加] をクリックし、ラベルとラベルの値を選択します。複数のフィルタを追加できます。たとえば、1 つのゾーンのデータを表示するには、フィルタを適用します。詳細については、グラフ化するデータの選択をご覧ください。

  2. 時系列の前処理方法を選択します。

    前処理オプションは、選択した指標の種類がデルタまたは累積の場合に表示されます。使用できる具体的なオプションは、指標の値の型によって異なります。

    一般に、この設定はデフォルト値のままにしておくことができます。

    前処理オプションが利用可能な場合は、ラジオボタンを使って、データの整列前に元データの処理方法を指定します。次の例では、選択内容が Delta に設定されています。

    累積の指標値の前処理オプションを表示します。

    deltarate の違いは単位です。rate を選択すると、データは delta 指標に変換され、その値がサンプリング レートで除算されます。たとえば、delta が選択されていて y-axis の単位が MiB の場合、rate を選択すると単位は MiB/秒に変更されます。詳細と例については、種類、タイプ、変換をご覧ください。

  3. アライメント パラメータを選択します。

    通常、これらのフィールドはデフォルト値のままにしておくことができます。詳細については、アライメント: 系列内の正則化をご覧ください。

  4. すべての時系列を表示する、またはラベル値で時系列をグループ化するかを決定します。

    • すべての時系列を単一の時系列に結合するには、[グループ条件] が空になっていることを確認し、[Group by function] メニューを使用して時系列を結合する方法を選択します。

    • すべての時系列を表示するには、次のいずれかを行います。

      • [グループ条件] が空になっていることを確認し、[Group by function] で [none] を選択します。
      • [グループ条件] メニューをクリックして [すべて追加] を選択し、[Group by function] メニューから選択します。 数値を格納する指標の場合は、Group-by 関数を選択しても、表示内容が異なるグラフが生成されない場合があります。
    • 時系列を特定のラベル値でグループ化するには、[Group by] をクリックし、グループ化に使用するラベルを選択します。時系列の結合方法を指定するには、[Group by function] メニューを使用して関数を選択します。

    アライメントとグループ化に関する一般的な情報については、データの表示方法の選択をご覧ください。

  5. (省略可)グラフでのデータの表示方法を構成するには、[設定] をクリックします。

    グラフの凡例については、凡例の構成をご覧ください。

クラシック エディタ

折れ線グラフ、積み上げ面グラフ、棒グラフ、またはヒートマップ グラフを構成する手順は次のとおりです。

  1. グラフに表示するデータを指定します。

    1. [Metric] タブが選択されていることを確認します。

      [指標選択] タブを表示します。

    2. [Find resource type and metric] ボックスに入力します。メニューから値を選択するか、名前を入力します。

    3. (省略可)[フィルタ] フィールドを使用してデータのサブセットを選択します。

    4. (省略可)デフォルトの集計設定を変更します。[集計] フィールドは、複数の時系列の結合方法および各時系列の処理方法を定義します。

      • ラベルで時系列をグループ化するには、[Group By] フィールドを使用します。このフィールドの値を選択すると、[Aggregator] フィールドの値が自動的に選択されます。
      • 複数の時系列の結合方法を指定するには、[Aggregator] フィールドを設定します。
      • 個々の時系列の処理アルゴリズムを構成するには、[詳細オプション] をクリックします。

    これらのフィールドの詳細については、グラフ化するデータの選択をご覧ください。

  2. (省略可)グラフのデフォルトの表示オプションは、カラーモードで表示される折れ線グラフです。ただし、次の両方の設定を変更することもできます。

    • グラフモードを変更するには、[表示オプション] タブを選択し、メニューから選択します。使用可能なオプションは、グラフの表示スタイルに基づいて動的に設定されます。選択内容の詳細については、表示オプションをご覧ください。

    • グラフの表示スタイルを変更するには、[Line] をクリックしてプルダウン メニューを展開します。選択すると、その選択がプルダウン メニューの隣に表示されます。すべてのグラフの種類の例については、グラフの種類をご覧ください。

  3. (省略可)1 つのグラフに複数の指標を表示できます。別の指標を表示するには、[Add Metric] をクリックし、上記の 2 つの手順を繰り返します。グラフには最大 10 個の指標を表示できます。

  4. (省略可)[グラフのタイトル] を更新します。デフォルトでは、選択した指標に基づいてグラフのタイトルが生成されます。作成したグラフのタイトルを変更するには、グラフ ツールバーで [編集] を選択します。

  5. [Save] をクリックします。

ゲージまたはスコアカードの構成

このセクションでは、ゲージまたはスコアカードの構成方法について説明します。Google Cloud Console を使用してこれらのウィジェットのいずれかをダッシュボードに追加する方法については、ダッシュボードにウィジェットを追加する一般的な手順をご覧ください。Cloud Monitoring API の使用に関心がある場合は、基本的な Scorecard を含むダッシュボードをご覧ください。

プレビュー エディタ

ゲージまたはスコアカードを構成するには、次の手順に従います。

  1. ウィジェットを選択して、構成ペインを有効にします。

  2. 表示する時系列データを選択します。

    • [リソースタイプ] と [指標] を変更するには、メニューから選択します。[リソースタイプ] メニューには、指標データが存在するすべてのモニタリング対象リソースが一覧表示されます。[指標] メニューは、[リソースタイプ] での選択によって異なります。

      • メニューで特定のエントリを検索するには、スクロールバーを使用するか、メニューの「Filter エリアにテキストを入力します。テキストを入力すると、メニュー エントリは、入力されたテキストが含まれるエントリに限られます。

      • まだデータが存在しないリソースタイプまたは指標にアクセスする場合は、デフォルトの動作を変更する必要があります。

        • 任意のリソースタイプを選択できるようにするには、[リソースタイプ] メニューを展開して [有効な場合のみ表示] をオフにします。

        • データが存在しない指標も含めて、選択したリソースタイプのすべての指標を表示するには、[Metric] メニューを展開して、[Only show active] をオフにします。

        • 任意の指標を選択できるようにするには、[Resource type] メニューで「Close をクリックして、目的のエントリを見つけます。リソースタイプで「Close」をクリックすると、[Metric] メニューに指標がすべて表示されます。

        • Cloud Monitoring API で使用するリソースタイプ、指標、フィルタ設定を表示または編集するには、[リソースタイプ] メニューの [ダイレクト フィルタ モード] をクリックします。

    • フィルタを追加するには、[フィルタを追加] をクリックし、ラベルとラベルの値を選択します。複数のフィルタを追加できます。たとえば、1 つのゾーンのデータを表示するには、フィルタを適用します。詳細については、グラフ化するデータの選択をご覧ください。

  3. 選択した時系列を単一の値に結合する方法を指定します。

    ラジオボタンを使用して、さまざまな時系列のデータを結合する方法を指定します。平均データを計算するには、[mean] を選択します。

  4. ゲージまたはスコアカードの警告レベルとしきい値レベルを構成します。

    • ゲージの場合は、指標の最小値と最大値を入力します。ゲージに割合が表示されたら、これらの値をそれぞれ 0 と 1 に設定します。

    • スコアカードの場合は、Spark Chart View を設定します。すべてのオプションで最新のものが表示されます。

      • 折れ線グラフ: 折れ線グラフを表示します。
      • 棒グラフ: 棒グラフを表示します。
      • アイコン: 緑色、黄色、または赤色のアイコンを表示します。
      • 値: 値だけを表示します。
    • ゲージとスコアカードの場合は、警告と危険しきい値を構成します。

      • 危険しきい値の上限: 値がこのしきい値を超えている場合は赤に設定されます。
      • 警告しきい値の上限: 値がこのしきい値を超えている場合は、黄色に設定されます。
      • 危険しきい値の下限: 値がこのしきい値未満の場合は赤色に設定されます。
      • 警告しきい値の下限: 値がこのしきい値未満の場合は、黄色に設定されます。

      たとえば、次のスクリーンショットは、[警告しきい値の上限] と [危険しきい値の上限] のしきい値が設定されたゲージの構成を示しています。

      ゲージの構成を示すグラフ。

      測定値が警告しきい値と危険しきい値より小さい場合のゲージの例を以下に示します。

      ゲージの例。

      細い外側の弧には有効な値の範囲と危険ゾーンおよび警告ゾーンが表示されます。太い内側の弧は現在の値を示します。

クラシック エディタ

クラシック エディタの使用時には、スコアカードとゲージを表示できます。スコアカードまたはゲージを作成または変更するには、プレビュー エディタまたは Cloud Monitoring API を使用する必要があります。

テキスト ボックスの構成

このセクションでは、テキスト ボックスの構成方法について説明します。Google Cloud Console を使用してテキスト ボックスをダッシュボードに追加する方法については、ダッシュボードにウィジェットを追加する一般的な手順をご覧ください。Cloud Monitoring API の使用に関心がある場合は、Text ウィジェットを含むダッシュボードをご覧ください。

プレビュー エディタ

テキスト ボックス ウィジェットは、限定された一連の Markdown コマンドをサポートしています。

  • ヘッダーを作成するには、# を使用します。さまざまなレベルのヘッダーに複数のハッシュ記号を使用できます。

      # Header
      ## Second heading
      ### Third heading
    
  • 斜体のフォントを表示するには、*italic* または _italic_ を使用します。

  • 太字フォントを表示するには、**bold** または __bold__ を使用します。

  • リンクを追加するには、[link text](absolute URL) を使用します。link text には任意の値を使用できますが、絶対 URL を使用する必要があります。

    たとえば、cloud.google.com にリンクする [cloud.google.com](https://cloud.google.com/) を記述できます。

クラシック エディタ

クラシック エディタの使用時には、テキスト ボックスを表示することはできます。テキスト ボックスを作成または変更するには、プレビュー エディタまたは Cloud Monitoring API を使用する必要があります。

ウィジェットの種類の変更

プレビュー エディタ

ウィジェット タイプは変更できません。たとえば、折れ線グラフを選択すると、ヒートマップ チャートには変換できません。

クラシック エディタ

グラフのウィジェットの種類を変更するには、次の手順に従います。

  1. グラフのツールバーで、[編集] を選択します。
  2. 現在のグラフスタイルが表示されているプルダウン メニューから必要なプロットタイプを選択します。デフォルトのスタイルは線です。

選択したグラフモードと互換性のないプロットタイプを選択すると、グラフモードがカラーモードに戻ります。たとえば、X 線モードで表示されている折れ線グラフで、プロットタイプを積み上げ棒グラフとして選択すると、グラフモードが自動的にカラーモードに切り替わります。グラフモードの詳細については、表示オプションの設定をご覧ください。

ダッシュボード ウィジェットの編集

プレビュー エディタ

ウィジェットを編集するには、次のようにします。

  1. ダッシュボードのツールバーに [プレビュー] と表示され、[編集] 切り替えボタンが [オン] の位置にあることを確認します。
  2. 編集するウィジェットを選択します。この操作を行うと、ウィジェットの構成ペインが有効になります。グラフを変更する場合は、表示オプションの設定でグラフの外観の構成方法を参照してください。
  3. [Save dashboard] をクリックします。

クラシック エディタ

グラフの構成を編集するには、グラフ ツールバーで [その他のオプション] をクリックして [編集] を選択します。

グラフ ツールバーとグラフの外観の構成の詳細については、表示オプションの設定をご覧ください。

ダッシュボード ウィジェットの削除

プレビュー エディタ

ウィジェットを削除するには、次のようにします。

  1. ダッシュボードのツールバーに [プレビュー] と表示され、[編集] 切り替えボタンが [オン] の位置にあることを確認します。
  2. 削除するウィジェットを選択します。
  3. 構成ツールバーで [削除] を選択します。
  4. [Save dashboard] をクリックします。

クラシック エディタ

グラフを削除するには、グラフのツールバーで [その他のオプション] をクリックし、[削除] を選択します。

次のステップ