PrometheusドキュメントPrometheusTweetこのページはPrometheus公式ドキュメント和訳+αの一部です。Prometheusは、監視対象のHTTPエンドポイントをスクレイプすることで監視対象からメトリクスを収集する監視プラットフォームである。このガイドでは、インストールの仕方、設定の仕方、Prometheusでリソースを監視する方法を示す。Prometheusをダウンロード、インストール、実行することになる。exporter(ホストとサービスについての時系列を出力するツール)をダウンロード、インストールする。最初のexporterは、Prometheus自体(メモリ使用、ガベージコレクションなどのホストレベルの様々なメトリクスを提供する)となる。Prometheusのダウンロード自分のプラットフォームに合った最新リリースをダウンロードし、展開する。Windows上ではprometheus.exe)という1つのバイナリである。--helpを渡すことで、バイナリを実行してオプションに関するヘルプを見ることができる。.Prometheusを起動する前に、設定をしよう。Prometheusの設定Prometheusの設定は、YAMLである。Prometheusをダウンロードすると、prometheus.ymlという設定例が付属している。簡潔にするため、このサンプルファイルのほとんどのコメントを削除してある(コメントは#で始まる行である)。['localhost:9090']このサンプル設定ファイルには、3つの設定のブロック、global、rule_files、scrape_configsがある。globalブロックは、Prometheusサーバーのグローバルな設定を制御する。ここでは2つの項目が示されている。1つ目のscrape_intervalは、どれぐらい頻繁にPrometheusが監視対象をスクレイプするかを制御する。これは、個別の監視対象についてこれを上書きすることもできる。この例では、グローバルな設定としては、15秒ごとにスクレイプすることになる。evaluation_intervalは、どれぐらい頻繁にPrometheusがルールを評価するかを制御する。Prometheusは、新しい時系列を作成したり、アラートを生成するためにルールを使う。rule_filesブロックは、Prometheusサーバーに読み込んで欲しいルールの場所を指定する。この例では、ルールはない。最後のブロックscrape_configsは、どんなリソースをPrometheusが監視するかを制御する。Prometheus自身もまた自分についてのデータをHTTPエンドポイントとして出力しているので、自分自身の状態を監視することができる。デフォルトの設定では、prometheusというジョブがあり、Prometheusサーバーが出力する時系列データをスクレイプする。そのジョブには、静的に設定された1つのターゲット、localhostのポート9090が含まれている。Prometheusは、ターゲットのパス/metricsでメトリクスが取得可能であることを想定している。したがって、このデフォルトジョブはURLhttp://localhost:9090/metricsをスクレイプする。ここで返される時系列データは、Prometheusサーバーの状態とパフォーマンスの詳細が含まれる。設定項目の完全な仕様については、設定のドキュメントを参照すること。Prometheusの起動ここで作成した設定ファイルでPrometheusを起動するには、Prometheusのバイナリを含むディレクトリに移動し、以下のコマンドを実行する。--config.file=prometheus.ymlこれでPrometheusが起動するはずである。http://localhost:9090で、Prometheus自体の状態を見ることができる。自分自身のHTTPエンドポイントからデータを収集するため約30秒待つ。Prometheusが出力しているメトリクスを確認することもできる。expressionブラウザの利用Prometheusが自分自身について収集したデータを見てみよう。Prometheusの組み込みexpressionブラウザーを利用するには、http://localhost:9090/graphに移動し、GraphタブのConsoleビューを選択する。http://localhost:9090/metricsから取得した通り、Prometheusが自分自身について出力したメトリクスの1つにpromhttp_metric_handler_requests_total(Prometheusサーバーが返した/metricsへのリクエストの数)がある。expressionコンソールに以下の式を入力してみよう。promhttp_metric_handler_requests_totalこれは、いくつかの異なる時系列を、promhttp_metric_handler_requests_totalというメトリック名、それぞれ異なるラベル、それぞれ記録された最新の値とともに返すはずである。これらのラベルは異なるレスポンスステータスを示している。HTTPコード200になったリクエストに興味があるだけなら、その情報を取得するために以下のクエリを使うことができる。promhttp_metric_handler_requests_total{code="200"}返された時系列の数を数えるために、以下のように入力することができる。count(promhttp_metric_handler_requests_total)クエリ言語についてさらに知りたい場合は、クエリ言語のドキュメントを参照すること。式をグラフ化するには、http://localhost:9090/graphに移動し、Graphタブを利用する。ステータスコード200を返すHTTPリクエストの秒間レートをグラフ化するために、以下の式を入力してみよう。rate(promhttp_metric_handler_requests_total{code="200"}[1m])グラフ幅のパラメーターや他の設定を試すことができる。他のターゲットの監視Prometheusだけからメトリクスを収集しても、Prometheusの能力をうまく示せたとは言えない。Prometheusに何ができるかもっとよく理解するためには、他のexporterについてのドキュメントを調べてみることを推奨する。Exporterを用いたLinuxホストのメトリクス監視が良いだろう。まとめこのガイドでは、Prometheusをインストールし、リソースを監視するようにPrometheusインスタンスを設定し、Prometheusのexpressionブラウザで時系列データを扱う基本を学んだ。Prometheusを学習し続けるには、次に何を探すべきか理解するために概要を見てみると良い。見る和訳活動の支援Prometheusドキュメント和訳が役に立った方は、以下QRコードからPayPayで活動を支援して頂けるとありがたいです。PrometheusドキュメントこのページはPrometheus公式ドキュメント和訳+αの一部です。PrometheusドキュメントこのページはPrometheus公式ドキュメント和訳+αの一部です。Prometheusドキ...このページはPrometheus公式ドキュメント和訳+αの一部です。PrometheusドキュメントこのページはPrometheus公式ドキュメント和訳+αの一部です。PrometheusドキュメントこのページはPrometheus公式ドキュメント和訳+αの一部です。KestrelServerOptions.Listen().月別アーカイブ参加グループプログラミングはてなブログをはじめよう!knj4484さんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。