9.3. メトリクスのクエリー
Red Hat OpenShift Service on AWS モニタリングダッシュボードを使用すると、Prometheus Query Language (PromQL) クエリーを実行して、プロット上に視覚化されたメトリクスを調べることができます。この機能により、クラスターの状態と、モニターしているユーザー定義のワークロードに関する情報が提供されます。
dedicated-admin として、ユーザー定義プロジェクトに関するメトリクスに対して、一度に 1 つ以上の namespace をクエリーできます。
開発者として、メトリクスのクエリー時にプロジェクト名を指定する必要があります。選択したプロジェクトのメトリクスを表示するには、必要な権限が必要です。
9.3.1. クラスター管理者としてのすべてのプロジェクトのメトリクスのクエリー
dedicated-admin またはすべてのプロジェクトの表示パーミッションを持つユーザーとして、メトリクス UI ですべてのデフォルト Red Hat OpenShift Service on AWS およびユーザー定義プロジェクトのメトリクスにアクセスできます。
専任の管理者のみが、Red Hat OpenShift Service on AWS モニタリングで提供されるサードパーティーの UI にアクセスできます。
メトリクス UI には、すべてのプロジェクトの CPU、メモリー、帯域幅、ネットワークパケットなどの定義済みクエリーが含まれています。カスタム Prometheus クエリー言語 (PromQL) クエリーを実行することもできます。
前提条件
-
dedicated-adminロールまたはすべてのプロジェクトの表示パーミッションを持つユーザーとしてクラスターにアクセスできる。 -
OpenShift CLI (
oc) がインストールされている。
手順
- Red Hat OpenShift Service on AWS Web コンソールの 管理者 パースペクティブで、監視 をクリックし、メトリクス タブに移動します。
1 つ以上のクエリーを追加するには、次のいずれかのアクションを実行します。
オプション 説明 既存のクエリーを選択します。
[クエリーの選択] ドロップダウンリストから、既存のクエリーを選択します。
カスタムクエリーを作成します。
Prometheus Query Language (PromQL) クエリーを Expression フィールドに追加します。
PromQL 式を入力すると、オートコンプリートの提案がドロップダウンリストに表示されます。これらの提案には、関数、メトリクス、ラベル、および時間トークンが含まれます。キーボードの矢印を使用して、これらの提案された項目の 1 つを選択し、Enter キーを押して、その項目を式に追加します。提案されたアイテムの上にマウスポインターを移動すると、そのアイテムの簡単な説明が表示されます。
複数のクエリーを追加します。
クエリーの追加を クリックします。
既存のクエリーを複製します。
オプションメニューをクリックします
をクリックし、クエリーの複製 を選択します。
クエリーの実行を無効にします。
オプションメニューをクリックします
をクリックし、[クエリーを無効にする] を選択します。
作成したクエリーを実行するには、[クエリーの実行] をクリックします。クエリーからのメトリクスはプロットで可視化されます。クエリーが無効な場合は、UI にエラーメッセージが表示されます。
注記- 時系列グラフを描画する場合、大量のデータに対して操作するクエリーはタイムアウトしたり、ブラウザーに過負荷をかけたりする可能性があります。これを回避するには、グラフを非表示 をクリックし、メトリクステーブルのみを使用してクエリーを調整します。次に、使用できるクエリーを確認した後に、グラフを描画できるようにプロットを有効にします。
- デフォルトでは、クエリーテーブルに、すべてのメトリクスとその現在の値をリスト表示する拡張ビューが表示されます。クエリーの展開ビューを最小化するには、下矢印 (˅) をクリックします。
- オプション: ページ URL には、実行したクエリーが含まれます。このクエリーのセットを再度使用できるようにするには、この URL を保存します。
視覚化されたメトリクスを調べます。最初に、有効な全クエリーの全メトリクスがプロットに表示されます。次のいずれかのアクションを実行して、表示するメトリクスを選択します。
オプション 説明 クエリーからすべてのメトリクスを非表示にします。
オプションメニューをクリックします
クエリーの すべてのシリーズを非表示 をクリックします。
特定のメトリクスを非表示にします。
クエリーテーブルに移動し、メトリクス名の近くにある色付きの四角形をクリックします。
プロットを拡大し、時間範囲を変更します。
次のいずれかの操作を実行します。
- プロットを水平にクリックし、ドラッグして、時間範囲を視覚的に選択します。
- メニューを使用して時間範囲を選択します。
時間範囲をリセットします。
ズームをリセットを クリックします。
特定の時点でのすべてのクエリーの出力を表示します。
興味のあるポイントのプロットにマウスを移動します。クエリーの出力はポップアップに表示されます。
プロットを非表示にします。
グラフを非表示 をクリックします。
関連情報
- PromQL クエリーの作成の詳細は、Prometheus クエリーに関するドキュメント を参照してください。
9.3.2. 開発者が行うユーザー定義プロジェクトのメトリクスのクエリー
ユーザー定義のプロジェクトのメトリクスには、開発者またはプロジェクトの表示権限を持つユーザーとしてアクセスできます。
メトリクス UI には、CPU、メモリー、帯域幅、ネットワークパケットなどの定義済みクエリーが含まれています。これらのクエリーは選択したプロジェクトに制限されます。プロジェクトに対してカスタム Prometheus クエリー言語 (PromQL) クエリーを実行することもできます。
開発者は Developer パースペクティブのみを使用でき、Administrator パースペクティブは使用できません。開発者は、1 度に 1 つのプロジェクトのメトリクスのみをクエリーできます。開発者は Red Hat OpenShift Service on AWS モニタリングで提供されるサードパーティーの UI にアクセスできません。
前提条件
- 開発者として、またはメトリクスで表示しているプロジェクトの表示権限を持つユーザーとしてクラスターへのアクセスがある。
- ユーザー定義プロジェクトのモニタリングが有効化されている。
- ユーザー定義プロジェクトにサービスをデプロイしている。
-
サービスのモニター方法を定義するために、サービスの
ServiceMonitorカスタムリソース定義 (CRD) を作成している。
手順
- Red Hat OpenShift Service on AWS Web コンソールの 開発者 パースペクティブで、観察 をクリックし、メトリクス タブに移動します。
- Project: 一覧でメトリクスで表示するプロジェクトを選択します。
1 つ以上のクエリーを追加するには、次のいずれかのアクションを実行します。
オプション 説明 既存のクエリーを選択します。
[クエリーの選択] ドロップダウンリストから、既存のクエリーを選択します。
カスタムクエリーを作成します。
Prometheus Query Language (PromQL) クエリーを Expression フィールドに追加します。
PromQL 式を入力すると、オートコンプリートの提案がドロップダウンリストに表示されます。これらの提案には、関数、メトリクス、ラベル、および時間トークンが含まれます。キーボードの矢印を使用して、これらの提案された項目の 1 つを選択し、Enter キーを押して、その項目を式に追加します。提案されたアイテムの上にマウスポインターを移動すると、そのアイテムの簡単な説明が表示されます。
複数のクエリーを追加します。
クエリーの追加を クリックします。
既存のクエリーを複製します。
オプションメニューをクリックします
をクリックし、クエリーの複製 を選択します。
クエリーの実行を無効にします。
オプションメニューをクリックします
をクリックし、[クエリーを無効にする] を選択します。
作成したクエリーを実行するには、[クエリーの実行] をクリックします。クエリーからのメトリクスはプロットで可視化されます。クエリーが無効な場合は、UI にエラーメッセージが表示されます。
注記- 時系列グラフを描画する場合、大量のデータに対して操作するクエリーはタイムアウトしたり、ブラウザーに過負荷をかけたりする可能性があります。これを回避するには、グラフを非表示 をクリックし、メトリクステーブルのみを使用してクエリーを調整します。次に、使用できるクエリーを確認した後に、グラフを描画できるようにプロットを有効にします。
- デフォルトでは、クエリーテーブルに、すべてのメトリクスとその現在の値をリスト表示する拡張ビューが表示されます。クエリーの展開ビューを最小化するには、下矢印 (˅) をクリックします。
- オプション: ページ URL には、実行したクエリーが含まれます。このクエリーのセットを再度使用できるようにするには、この URL を保存します。
視覚化されたメトリクスを調べます。最初に、有効な全クエリーの全メトリクスがプロットに表示されます。次のいずれかのアクションを実行して、表示するメトリクスを選択します。
オプション 説明 クエリーからすべてのメトリクスを非表示にします。
オプションメニューをクリックします
クエリーの すべてのシリーズを非表示 をクリックします。
特定のメトリクスを非表示にします。
クエリーテーブルに移動し、メトリクス名の近くにある色付きの四角形をクリックします。
プロットを拡大し、時間範囲を変更します。
次のいずれかの操作を実行します。
- プロットを水平にクリックし、ドラッグして、時間範囲を視覚的に選択します。
- メニューを使用して時間範囲を選択します。
時間範囲をリセットします。
ズームをリセットを クリックします。
特定の時点でのすべてのクエリーの出力を表示します。
興味のあるポイントのプロットにマウスを移動します。クエリーの出力はポップアップに表示されます。
プロットを非表示にします。
グラフを非表示 をクリックします。
関連情報
- PromQL クエリーの作成の詳細は、Prometheus クエリーに関するドキュメント を参照してください。
