View a markdown version of this page

Explore でのクエリ管理 - Amazon Managed Grafana
クエリ履歴Prometheus 固有の機能

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Explore でのクエリ管理

このドキュメントのトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けです。

Grafana バージョン 12.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 12 での作業。

Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 10 での作業」を参照してください。

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 8 での作業」を参照してください。

クエリのデバッグを支援するために、Explore ではクエリリクエストとレスポンス、クエリ統計を「クエリインスペクター」を使用して調査できます。この機能は、パネルインスペクタータスク「クエリのパフォーマンス検査」、「クエリリクエストとレスポンスデータの検査」と類似しています。

クエリ履歴

クエリ履歴は、Explore で使用したクエリのリストです。履歴は Grafana データベースに保存され、他のユーザーと共有されません。履歴内のクエリの保持期間は 2 週間です。2 週間以上経過したクエリは自動的に削除されます。履歴を開いて操作するには、Explore の [クエリ履歴] ボタンを選択します。

注記

スター付き (お気に入り) クエリは 2 週間の保持期間の対象ではなく、削除されません。

クエリ履歴の表示

クエリ履歴を使用すると、クエリの履歴を表示できます。個々のクエリごとに、次のことができます。

  • クエリを実行する

  • コメントを作成および/または編集します。

  • クエリをクリップボードにコピーする。

  • クエリを含む短縮リンクをクリップボードにコピーする。

  • クエリをスター付き (お気に入り) にする。

お気に入りのクエリを管理する

[クエリ履歴] タブにあるスター付きのすべてのクエリは、[スター付き] リストに表示されます。これにより、お気に入りのクエリにすばやくアクセスし、ゼロから入力することなくこれらのクエリを再利用できます。

[クエリ履歴の並べ替え]

デフォルトでは、クエリ履歴には最新のクエリが表示されます。履歴は日付またはデータソース名で、昇順または降順に並べ替えることができます。

クエリ履歴を並べ替えるには

  1. [クエリの並べ替え順序] フィールドを選択します。

  2. 以下のオプションのいずれかを選択します。

    • 新しい順

    • [古い順]

クエリ履歴のフィルタリング

クエリ履歴とスター付きタブで、クエリ履歴を特定のデータソースに対してフィルタリングできます。

データソースに対する履歴のフィルタリング

  1. [特定のデータソースのクエリをフィルタリング] フィールドを選択します。

  2. 履歴をフィルタリングするデータソースを選択します。複数のデータソースを選択することもできます。

[クエリ履歴] タブでは、スライダーを使用して日付でクエリをフィルタリングすることもできます。

  • 垂直スライダーを使用して、クエリを日付でフィルタリングします。

  • 上部のハンドルをドラッグして開始日を設定します。

  • 上部のハンドルをドラッグして終了日を設定します。

クエリ履歴の検索

クエリとコメントをまたいで履歴を検索できます。クエリ履歴タブとスター付きタブでクエリを検索できます。

クエリ履歴で検索するには

  1. [クエリ検索] フィールドを選択します。

  2. 検索する用語を検索フィールドに入力します。

クエリ履歴設定

[設定] タブでクエリ履歴をカスタマイズできます。オプションについては、以下の表を参照してください。

設定 デフォルトの値
デフォルトのアクティブタブを変更する [クエリ履歴] タブ
注記

クエリ履歴設定は全体に及び、分割モードで両方のパネルに適用されます。

Prometheus 固有の機能

Explore には、Prometheus のカスタムクエリエクスペリエンスが搭載されています。クエリを実行すると、実際にはグラフ用の通常の Prometheus クエリとテーブル用のインスタントクエリの 2 つのクエリが実行されます。インスタントクエリは、グラフに表示されるデータの適切な要約を示す各時系列の最後の値を返します。

メトリクスエクスプローラー

クエリフィールドの左側で [メトリクス] を選択すると、メトリクスエクスプローラーが開きます。エクスプローラーには、メトリクスがプレフィックスごとにグループ化された階層メニューが示されます。例えば、すべてのアラートマネージャーメトリクスは alertmanager プレフィックスの下にグループ化されます。これは、利用可能なメトリクスを単に確認したい場合に有効です。

クエリフィールド

クエリフィールドは、メトリクス名、関数の自動補完機能に対応しており、標準の Prometheus クエリエディタとほぼ同じように動作します。Enter キーを押して新しい行を作成し、Shift+Enter キーを押してクエリを実行できます。

Ctrl+Space キーを押すとオートコンプリートメニューが開きます。オートコンプリートメニューには新たに [履歴] セクションが追加されており、最近実行されたクエリの一覧が表示されます。

クエリフィールドの下に提案が表示される場合があり、そのフィールドでクエリを選択すると、提案された変更でクエリを更新します。

  • カウンター (指数関数的に増加するメトリクス) では、レート関数が提案されます。

  • バケットの場合、ヒストグラム関数が候補として表示されます。

  • 記録ルールの場合、ルールを展開できます。

テーブルをフィルタリング

テーブルパネルのラベル列にあるフィルターボタンを選択すると、クエリ式にフィルターを追加することができます。複数のクエリに対してフィルターを追加することもでき、フィルターはすべてのクエリに追加されます。