Prometheusのベストプラクティス: 正しいメトリックとラベルの設計 🚀

10月 8, 2026

—

こんにちは！今日は、モニタリングシステムの核であるPrometheusを使用する上で最も重要かつ基本的な部分である「メトリック名とラベルの設計」についてお話ししたいと思います。アプリケーションの状態を正確かつ効率的に把握するためには、最初からメトリックを正しく設計することが非常に重要です。

HTTPリクエスト数を追跡する一般的なシナリオを通して、どの方法が最適か一緒に見ていきましょう。🤔

###

❌ よくある間違い: すべての情報を名前に含める

アプリケーションで処理されたHTTPリクエストを、メソッド（GET、POST）とステータスコード（200、404、500）別に追跡したいと仮定しましょう。最も直感的に思いつく方法は、おそらくこのような形でしょう。

http_requests_get_200_total
http_requests_post_500_total
http_requests_get_404_total
...

一見すると明確に見えますが、この方式にはPrometheusの強力な機能を十分に活用できなくする致命的な欠点があります。それは、まさに 「メトリック爆発（Metric Explosion）」 💣 現象です。

HTTPメソッドとステータスコードのすべての組み合わせごとに新しいメトリックが生成されます。もしここにユーザーIDやエンドポイントパスのような他の属性まで追加されたらどうなるでしょうか？管理すべきメトリックの数は指数関数的に増加し、システムに大きな負担をかけることになります。また、「ステータスコードが500のすべてのリクエストの合計」のような単純な集計クエリでさえ、非常に複雑で煩雑になります。🤯

###

✅ Prometheus方式: ラベルで次元を付与する！

Prometheusが推奨する最も理想的な方法は、まさにこれです。

http_requests_total{method="GET", code="200"}

この方式がなぜ優れているのか、一つずつ見ていきましょう。

1. 意味のあるメトリック名 📝

httprequeststotal という名前は、2つの部分に分けることができます。

http_requests: 測定対象が「HTTPリクエスト」であることを明確に示します。基本名は、できるだけ一般的で包括的にすることが推奨されます。
_total: このメトリックが「カウンター（Counter）」タイプであることを示す標準的な接尾辞です。カウンターは、継続的に累積増加する値を意味します。📈 このように接尾辞を通じてメトリックのタイプを明示することで、誰でもこのメトリックの特性を容易に把握できます。

2. 強力で柔軟なラベル ✨

ここでの核心は、まさに {method=”GET”, code=”200″} の部分、つまり ラベル（Label） です。ラベルは、メトリックに多次元的な属性（Dimension）を付与する役割を果たします。

属性の分離: method や code のように多様な値を持つことができる属性を、メトリック名から分離してラベルにします。
柔軟なクエリ: ラベルを使用すると、PromQLを通じてデータを自由に切り分け、フィルタリングし、集計することができます。例えば、5分間のステータスコード別のリクエスト率を見たい場合、以下のような簡単なクエリ一つで十分です。

# ステータスコード(code)別にグループ化し、5分間の1秒あたりのリクエストレートを計算
sum by (code) (rate(http_requests_total[5m]))

もし最初の方式のようにメトリック名を使用していたら、httprequests…200total、httprequests…500total など、すべてのメトリックを + で足し合わせなければならない恐ろしい状況が発生していたでしょう。😱

###

🤔 他の誤った例

なぜ他の方式が良くないのかも簡単に触れておきましょう。

http_requests{method=”GET”, code=”200″, status=”total”}
_total 接尾辞がすでにカウンターであることを示しているのに、 status=”total” というラベルを追加するのは不必要な重複です。メトリックはできるだけ簡潔で明確に保つのが良いでしょう。
applicationhttprequests(method=’GET’, code=’200′)
これはPrometheusのメトリックおよびラベルの構文自体に合わない表記法です。括弧 () やシングルクォーテーション ” は使用しません。❌

###

💡 まとめ

Prometheusメトリックを設計する際に覚えておくべき核心原則は以下の通りです。

メトリック名は測定対象を示すように一般化してください。
多様な値を持つことができる属性（次元）はラベルとして分離してください。
カウンターメトリックには _total のような標準接尾辞を使用してください。

これらの原則をしっかり守るだけで、はるかに柔軟で、拡張可能で、強力なモニタリングシステムを構築できます。皆さんのPrometheusの旅に、この記事が少しでも役立つことを願っています！💪