PromQL のコードエディタを使用する

このページでは、PromQL に対してコードエディタを使用する方法について説明します。このエディタは Google Cloud コンソールで使用でき、有効な PromQL クエリを作成するための候補やその他のツールを提供します。

このページでは PromQL 言語については説明しません。PromQL に関することは、オープンソース ドキュメントをご覧ください。導入として、以下のリソースが役に立ちます。

コードエディタにアクセスする

PromQL には、次に挙げる Google Cloud コンソールのページからアクセスできます。

  • Metrics Explorer
  • ダッシュボードの作成時にウィジェットを追加する

Metrics Explorer の使用時にコードエディタを開くには、次の手順を行います。

  1. Google Cloud コンソールで、[Metrics Explorer] ページに移動します。

    Metrics Explorer に移動

    検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

  2. クエリビルダー ペインのツールバーで、[MQL] または [MQL] という名前のボタンを選択します。
  3. [言語] で [PromQL] が選択されていることを確認します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。
  4. クエリが完了したら、凡例を構成したり、データの表示方法を変更したりできます。詳しくは次のページをご覧ください。

コードエディタを使用する

コードエディタを使用するには、テキスト フィールドにクエリを入力して [Run Query] をクリックします。

予測入力

クエリを入力すると、エディタに構文的に有効な完了のリストが表示されます。Control+Space を押すとオートコンプリート メニューを手動で表示できます。Escape を押すと非表示にできます。

オプションのリスト内を移動するには、矢印キーを使用します。Enter を押すと、選択した項目が挿入されます。

使用可能なすべての選択肢に共通のプレフィックスを挿入するには、Tab を押します。

検索と置換

エディタは、検索と置換の機能をサポートしています。クエリ内のキーワードを検索し、必要に応じて置換するには、Control+F(Mac では Command+F)を押します。次のスクリーンショットで、その機能を示します。

コードエディタは検索置換機能をサポートしています。

エディタ コントロール

エディタの 2 つのコントロールで、クエリの操作方法が決定されます。

デフォルトでは、[Run Query] をクリックした場合にのみクエリが実行されます。エディタは、クエリの入力と同時にクエリを自動的に実行するように設定できますが、デフォルトではこのオプションが無効にされています。

自動実行オプションを有効にするには、[Auto-run] トグルを使用します。このオプションが有効になると、エディタは次のように動作します。

  • [Run Query] ボタンは表示されません。
  • 入力時にエラー メッセージが継続して表示されます。
  • カーソルが、不完全ではあるもののエラーのないクエリの末尾にある場合は、エディタのコントロール バーに黄色の三角形が表示されます。表示スペースがある場合は、[不完全なクエリ] というテキストも表示されます。

    エディタは、不完全なクエリの評価を試みません。

コードエディタとグラフ領域の間にはグラブバーもあります。このバーを使用して、2 つの領域の相対的なサイズを変更します。

グラフを保存する

グラフの保存方法は、グラフを作成したコンテキストによって異なります。

  • Metrics Explorer から。
  • カスタム ダッシュボードの作成、編集の一環として。

Metrics Explorer からグラフを保存する

Metrics Explorer のコードエディタから、グラフをダッシュボードに保存することもできます。グラフを保存するには:

  1. Google Cloud コンソールで、[Metrics Explorer] ページに移動します。

    Metrics Explorer に移動

    検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

  2. クエリビルダー ペインのツールバーで、[MQL] または [MQL] という名前のボタンを選択します。
  3. [言語] で [PromQL] が選択されていることを確認します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。
  4. エディタにクエリを入力します。
  5. コードエディタの自動実行オプションを有効にしていない場合は、グラフを保存する前に [Run Query] をクリックしてクエリを実行します。デフォルトでは、カスタム ダッシュボードは定期的に変更を保存します。最初にクエリを実行しない場合、コードエディタは最後に実行したクエリを保存します。

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

  7. グラフの保存を続行するには:

    1. グラフにわかりやすいタイトルを付けます。
    2. 新しいグラフを表示する目的のダッシュボードを選択します。
    3. ダイアログで [Save]をクリックします。

カスタム ダッシュボードにグラフを保存する

新しいグラフをダッシュボードに保存する手順は次のとおりです。

  1. グラフにわかりやすいタイトルを付けます。

  2. コードエディタの自動実行オプションを有効にしていない場合は、グラフを保存する前に [Run Query] をクリックしてクエリを実行します。デフォルトでは、カスタム ダッシュボードは定期的に変更を保存します。最初にクエリを実行しない場合、コードエディタは最後に実行したクエリを保存します。

  3. ダッシュボードで自動保存を有効にしていない場合は、[保存] をクリックします。

Google Cloud コンソールは、カスタム ダッシュボードのページレベルのフィルタをサポートしています。これらのフィルタでは、カスタム ダッシュボードの PromQL グラフがサポートされています。

コードエディタを終了する

クエリを保存せずにコードエディタを終了するには、他のセレクタタブのいずれかをクリックします。エディタ内のクエリテキストは破棄されますが、クリップボードへの保存を選択することも可能です。