PromQLクエリフォーマッター＆バリデーター

Prometheus PromQLクエリを即座にフォーマットおよび検証

PromQLクエリフォーマッター＆バリデーターは、あなたがPrometheusおよびその他の互換性のあるタイムシリーズデータベースに対して書いたクエリを整えます。メトリクス表現を貼り付けて、ツールは二項演算子の周囲のスペースを標準化し、クエリが長くなると集計、関数呼び出し、ラベルマッチャーをそれぞれの行に配置し、未バランスの括弧、不一致なブレース、欠落した期間、およびその他の文法問題を、ダッシュボードまたはアラートルールに貼り付ける前に指摘します。すべての処理はあなたのブラウザで行われるので、クエリは内部メトリクス名やラベルを暴露するため、あなたのデバイスに留まります。

使用方法

1. 入力エリアにあなたのPromQLクエリを貼り付け、またはファイルセレクターを使ってテキストファイルをアップロードしてください .promql または、ファイルセレクターを使ってテキストファイルをアップロードしてください。
2. 複数行展開用のインデント幅を選択します — 2スペース、4スペース、または文字列のタブを含む。
3. 最大行長を設定します。関数呼び出し、ラベルマッチャーのセットおよび低優先度の論理演算子（and, or, unless）は、フォーマットされた行がこの幅を超えると、別行に折り返されます。
4. トグル 常に折り返す もし、すべての集計、関数呼び出しの引数リストおよびラベルマッチャーのセットが長さに関係なくそれぞれの行に配置されたい場合に使用します。
5. トグル 記録ルールとして折り返す および、メトリクス名（例： job:http_errors:rate5m）を提供して、フォーマットされたクエリを即座に貼り付けることができるPrometheus記録ルールとしてYAMLに変換します。
6. フォーマットされた出力をコピーするか、または .promql ファイル。

機能

• PromQL対応のスペース処理 — 算術、比較および論理演算子の周囲に1つのスペースを挿入しつつ、ラベルマッチャーをブレースの内部に保持します。 { } braces.
• スマートな複数行レイアウト — 長いクエリは、まず、関数引数境界、そして個々のラベルマッチャーに折り返され、結果がスキャンしやすいように保たれます。 and / or / unless first, then at function argument boundaries, then at individual label matchers so the result remains easy to scan.
• 集計およびベクトルマッチングサポート — sum, avg, topk, quantile およびその他の by, without, on, ignoring, group_left と group_right モジュールを認識し、
• 期間およびサブクエリトークン解析 — 複合期間（例： 1h30m ）およびサブクエリ（例： [5m:1m] ）を1つの単位としてパースし、トークンの途中に分割されることを防ぎます。
• 大きなファイルを処理します — 非バランスの括弧、ブレース、開閉記号、不一致な開閉記号、無効なラベルマッチャーのボディ、無効なサブスクリプト範囲、未終了の文字列を検出し、それぞれの行番号とともに報告します。
• 記録ルールエクスポート — オプションで、フォーマットされたクエリをPrometheus YAML記録ルールブロックとして折り返し、複数行表現をYAMLリテラルブロックスケーラーで使用してインデントを保持します。

一般的な使用例

• Grafanaパネルエディタからコピーした一時的なPrometheusクエリを、ダッシュボードやアラートルールにコミットする前に整える。
• コードレビュー用にPromQL表現を準備する — 長いエラーレートまたは飽和クエリは、各ブランチが個別に配置されたときに読みやすい差分になります。
• 微妙な文法ミス（期間の欠落、余計なコンマ、閉じられていない { ラベルマッチャー編集後）を検出し、Prometheusインスタンスにリターンする必要なく、即座に検出します。
• 原始的なクエリをPrometheus記録ルールYAMLに変換して、事前に集計パイプラインに使用します。
• PromQLを教える — フォーマットされた出力により、操作の優先順位および集計グループ化が読者に即座に明らかになります。