PromQL アシスタントを使用する - Managed Service for Grafana - Alibaba Cloud ドキュメントセンター

PromQL アシスタントは、Grafana に統合されたインテリジェントアシスタントで、Prometheus Query Language (PromQL) ステートメントの作成を支援します。PromQL アシスタントは、自然言語を PromQL に変換できます。PromQL アシスタントを使用すると、Prometheus データを効率的にクエリし、アラートルールを簡単に設定できます。これにより、ドキュメントを読んだり、PromQL を学習したりする必要がなくなります。このトピックでは、PromQL アシスタントの使用方法について説明します。

重要

PromQL アシスタントは、すべての共有 Grafana ワークスペースで使用できます。Managed Service for Grafana をアクティブ化していない場合は、ログイン不要のデモを使用して PromQL アシスタントを使用できます。

デモ

アプリケーション監視メトリクスに PromQL を使用する場合、アプリケーションパフォーマンス管理 (APM) データソースを使用してログインせずに Grafana にアクセスすることができます。
コンテナメトリクスに PromQL を使用する場合、コンテナデータソースを使用してログインせずに Grafana にアクセスすることができます。

PromQL アシスタントの機能

自然言語を PromQL に変換する
自然言語を使用して、クエリする Prometheus データを記述できます。PromQL アシスタントは、関連するメトリクス名、Prometheus 演算子、PromQL ステートメント、および対応する説明を自動的に取得できます。
PromQL コメントを自動生成する
PromQL アシスタントは、PromQL ステートメントの注釈を自動的に生成し、PromQL ステートメントにコメントを追加します。

手順

Managed Service for Grafana console にログインします。左側のナビゲーションペインで、ワークスペース管理 をクリックします。
共有 Grafana ダッシュボードにログインし、右下隅にあるロボットをクリックします。
表示されるパネルに、クエリ用の PromQL ステートメントの説明を質問として入力します。たとえば、「平均応答時間が最も長い上位 10 個のアプリケーションをクエリする PromQL ステートメントを作成します。」のように記述します。クエリの一般的な PromQL ステートメントの説明については、このトピックのPromQL のシナリオとサンプルの質問セクションを参照してください。
重要
入力する質問にキーワード PromQL が含まれていることを確認してください。
説明
PromQL アシスタントは、質問を英語で入力した場合にのみ、英語で結果を返します。
送信をクリックします。PromQL アシスタントが質問に基づいて PromQL ステートメントを返すまで数秒待ちます。
説明
PromQL アシスタントから提供された回答に満足できない場合は、Text2 Promql フィードバックを送信 をクリックします。
PromQL ステートメントを受け取ったら、Grafana の Explore に PromQL ステートメントを貼り付けます。ダッシュボードのデータソースに、クエリするメトリクスが含まれていることを確認してください。

ビデオチュートリアル

次のビデオは、PromQL アシスタントの使用方法の例を示しています。

Text2 PromQL でサポートされている Q&A シナリオ

Text2 PromQL は、20 以上の一般的な PromQL ステートメント生成シナリオをサポートしています。詳細については、このトピックのPromQL のシナリオとサンプルの質問セクションを参照してください。PromQL をクリックすると、サポートされているシナリオとサンプルの質問を表示できます。

Promql ウィジェットをクリックすると、PromQL アシスタントは一般的な PromQL ステートメントを生成するためのサポートされているシナリオを返します。

PromQL のシナリオとサンプルの質問

このセクションでは、コンテナサービスと Application Real-Time Monitoring Service (ARMS) で一般的に使用されるメトリクスについて説明し、クエリ用の PromQL ステートメントの説明の例を示します。

コンテナサービス関連のメトリクス

コンテナサービス用 Prometheus インスタンスによって監視される Grafana ダッシュボードを使用することをお勧めします。詳細については、ACKクラスターの監視を参照してください。

シナリオ	キーワード PromQL を含むサンプルの質問
ノードリソース関連のクエリ	Q: 各 Kubernetes ノードの CPU 使用率をクエリする PromQL ステートメントを作成します。 Q: 次の Kubernetes ノードのメモリ使用量をクエリする PromQL ステートメントを作成します: 172.16.xx.xx:9100。 Q: クラスタ内のノードが異常になった場合にアラートをトリガーする PromQL ステートメントを作成します。 Q: 異常なノードをクエリする PromQL ステートメントを作成します。
ポッドリソース関連のクエリ	Q: ポッドが 5 分以内に 2 回以上再起動された場合にアラートをトリガーする PromQL ステートメントを作成します。 Q: 次のポッドの可用性をクエリする PromQL ステートメントを作成します: `namespace="arms", deployment="arms-pop-malaysia"`。 Q: Kubernetes クラスタで例外が最も多いポッドをクエリする PromQL ステートメントを作成します。 Q: 失敗したジョブをクエリする PromQL ステートメントを作成します。
コンテナリソース関連のクエリ	Q: デフォルトの名前空間で CPU 使用率が最も高いコンテナをクエリする PromQL ステートメントを作成します。 Q: 次の名前空間とポッドの各コンテナのメモリ使用量をクエリする PromQL ステートメントを作成します: `namespace="default", pod_name="arms-xtrace"`。 Q: メモリ使用率が最も高い上位 5 つのコンテナをクエリする PromQL ステートメントを作成します。
Lingjun ダッシュボードのメトリクス関連のクエリ	Q: Lingjun ダッシュボードの各ノードの GPU 使用率をクエリする PromQL ステートメントを作成します。 Q: Lingjun ダッシュボードの各クラスタの GPU 使用率をクエリする PromQL ステートメントを作成します。

ARMS 関連のメトリクス

アプリケーションパフォーマンス監視のために ARMS によってデフォルトで生成された Grafana ダッシュボードで、PromQL ステートメントを使用してデータをクエリすることをお勧めします。

シナリオ	キーワード PromQL を含むサンプルの質問
平均応答時間関連のクエリ	Q: 各 API 操作の平均応答時間をクエリする PromQL ステートメントを作成します。 Q: アプリケーション A の各 API 操作の平均応答時間をクエリする PromQL ステートメントを作成します。 Q: アプリケーション A で平均応答時間が最も長い上位 10 個の API 操作をクエリする PromQL ステートメントを作成します。 Q: 平均応答時間が最も長い上位 10 個のアプリケーションをクエリする PromQL ステートメントを作成します。
エラー率関連のクエリ	Q: 前の 1 分間のアプリケーション A の各 API 操作のエラー率をクエリする PromQL ステートメントを作成します。 Q: ARMS でエラー率が最も高い上位 10 個のアプリケーションをクエリする PromQL ステートメントを作成します。 Q: アプリケーション A でエラー率が最も高い上位 10 個の API 操作をクエリする PromQL ステートメントを作成します。 Q: 過去 2 時間におけるアプリケーション A のマシン (IP アドレス: 195.128.xx.xx) でエラー率が最も高い上位 5 つの API 操作をクエリする PromQL ステートメントを作成します。
呼び出し回数関連のクエリ	Q: Redis データベースの 1 秒あたりのクエリ数 (QPS) をクエリする PromQL ステートメントを作成します。 Q: Dubbo サービスの QPS をクエリする PromQL ステートメントを作成します。 Q: アプリケーション A の各 API 操作の QPS をクエリする PromQL ステートメントを作成します。 Q: 前の 1 時間における各アプリケーションの API 呼び出し回数をクエリし、マシンごとにグループ化する PromQL ステートメントを作成します。 Q: 前の 5 分間の ARMS におけるアプリケーション A の各 API 操作への呼び出し回数をクエリする PromQL ステートメントを作成します。 Q: 前の 5 分間のアプリケーション A における payment/coupon タグが付いた API 操作への呼び出し回数をクエリする PromQL ステートメントを作成します。 Q: 呼び出し回数が最も多い上位 10 個の API 操作をクエリする PromQL ステートメントを作成します。 Q: アプリケーション A で呼び出し回数が最も多い上位 5 つの API 操作をクエリする PromQL ステートメントを作成します。
エラー数関連のクエリ	Q: 前の 5 分間の各 API 操作のエラー数をクエリする PromQL ステートメントを作成します。 Q: 前の 5 分間に IP アドレスが 10.26.xx.xx のマシンで発生した HTTP リクエストエラーの総数をクエリする PromQL ステートメントを作成します。 Q: 前の 1 時間にエラー数が最も多かった API 操作をクエリする PromQL ステートメントを作成します。 Q: 前の 10 分間に IP アドレスが 10.26.xx.xx で ClothService サービスがデプロイされているマシンで発生した呼び出しエラーの総数をクエリする PromQL ステートメントを作成します。
低速 SQL クエリ関連のクエリ	Q: 前の 10 分間に生成された低速 SQL クエリをクエリする PromQL ステートメントを作成します。 Q: 前の 10 分間のアプリケーション A で最も多くの低速 SQL クエリを引き起こした API 操作をクエリする PromQL ステートメントを作成します。 Q: アプリケーション A で最も多くの低速 SQL クエリを引き起こした上位 10 個の API 操作をクエリする PromQL ステートメントを作成します。 Q: 前の 1 時間に生成された低速 SQL クエリをクエリする PromQL ステートメントを作成します。
データベース関連のクエリ	Q: 前の 1 分間に Redis データベースで呼び出しに失敗した API 操作をクエリする PromQL ステートメントを作成します。 Q: 前の 1 分間に MySQL データベースで呼び出しに失敗した上位 5 つの API 操作をクエリする PromQL ステートメントを作成します。
HTTP ステータスコード関連のクエリ	Q: 4xx または 5xx エラーの数をカウントする PromQL ステートメントを作成します。 Q: 400 および 500 エラーの数をカウントする PromQL ステートメントを作成します。 Q: アプリケーション A に対して 4xx が返されたリクエストの数をクエリする PromQL ステートメントを作成します。
Java 仮想マシン (JVM) でのフルガベージコレクション (GC) 関連のクエリ	Q: 前日に発生したフル GC の回数をクエリする PromQL ステートメントを作成します。 Q: 前の 1 時間に各マシンで発生したフル GC の回数をクエリする PromQL ステートメントを作成します。 Q: アプリケーション A でフル GC が発生したマシンをクエリする PromQL ステートメントを作成します。 Q: フル GC が 5 回以上発生したマシンをクエリする PromQL ステートメントを作成します。
JVM でのフル GC によって消費された時間関連のクエリ	Q: 各マシンでフル GC によって消費された時間をクエリする PromQL ステートメントを作成します。 Q: フル GC が最も多くの時間を消費した上位 5 つのマシンをクエリする PromQL ステートメントを作成します。 Q: フル GC が 1 秒以上消費されたサービスをクエリする PromQL ステートメントを作成します。
QPS 増加関連のクエリ	Q: 10 分以内にアクセスリクエスト数が増加したアプリケーションをクエリする PromQL ステートメントを作成します。 Q: 前日にアクセスリクエスト数が最も増加したアプリケーションをクエリする PromQL ステートメントを作成します。 Q: 前の 1 週間でアプリケーション A のアクセスリクエスト数が最も急速に増加した API 操作をクエリする PromQL ステートメントを作成します。
増分メトリクス関連のクエリ	Q: `arms_mysql_requests_error_count` メトリクスを監視し、メトリクス値が急激に増加した場合にアラートを送信する PromQL ステートメントを作成します。 Q: `jvm_threads_live_threads` メトリクスの増分を監視する PromQL ステートメントを作成します。
ARMS コンソールのエラー数関連のクエリ	Q: エラー数が昨日のエラー数と比較して増加または減少しているかどうかを確認する PromQL ステートメントを作成します。
ARMS コンソールのリクエスト数関連のクエリ	Q: リクエスト数が前の 1 時間のリクエスト数と比較して増加または減少しているかどうかをクエリする PromQL ステートメントを作成します。
ARMS コンソールの例外数関連のクエリ	Q: 例外数が昨日の例外数と比較して増加または減少しているかどうかを確認する PromQL ステートメントを作成します。
ARMS コンソールで消費された平均時間関連のクエリ	Q: アプリケーションによって消費された平均時間が前の 1 時間と比較して増加または減少しているかどうかを確認する PromQL ステートメントを作成します。 Q: アプリケーションによって消費された平均時間の増加または減少をクエリする PromQL ステートメントを作成します。
ARMS コンソールのフル GC 関連のクエリ	Q: フル GC の影響を受けたアプリケーションをクエリする PromQL ステートメントを作成します。 Q: フル GC の影響を受けた API 操作をクエリする PromQL ステートメントを作成します。
ARMS コンソールの低速 SQL クエリ関連のクエリ	Q: 低速 SQL クエリが関係するアプリケーションをクエリする PromQL ステートメントを作成します。 Q: 低速 SQL クエリを引き起こした API 操作をクエリする PromQL ステートメントを作成します。
新しい例外またはエラー関連のクエリ	Q: エラー数が増加しているアプリケーションをクエリする PromQL ステートメントを作成します。 Q: エラー数が増加しているマシンをクエリする PromQL ステートメントを作成します。 Q: アプリケーション A でエラー数が増加している API 操作をクエリする PromQL ステートメントを作成します。
CPU 使用率関連のクエリ	Q: 各マシンの CPU 使用率をクエリする PromQL ステートメントを作成します。 Q: 前の 5 分間で CPU 使用率が最も高い上位 5 つのマシンをクエリする PromQL ステートメントを作成します。 Q: 前の 5 分間でアプリケーション A の CPU 使用率が 70% を超えたマシンをクエリする PromQL ステートメントを作成します。 Q: 前の 5 分間で CPU 使用率が最も急速に増加した上位 5 つのマシンをクエリし、CPU 使用率をリストする PromQL ステートメントを作成します。