Prometheus の Apache Exporter を使ってみる。

Prometheus の Apache Exporter をインストール・設定してみましたので、その内容をメモします。

環境

Prometheus

  • CentOS 7.7
  • Prometheus 2.15.2
  • IPアドレス : 192.168.0.1

Exporter

  • CentOS 7.7
  • Apache Exporter 0.7.0
  • httpd 2.4.39
  • IPアドレス : 192.168.0.2

Prometheus のインストール

既に、インストール済みの想定。

Apache Exporter

Apache Exporter は Githubで管理されています。

Prometheus exporter for Apache. Contribute to Lusitaniae/apache_exporter development by creating an account on GitHub.

以下のページに記載がありますが、Prometheus の Offical の Exporter ではありません。

An open-source monitoring system with a dimensional data model, flexible query language, efficient time series database and modern alerting approach.

ダウンロード

まずは、以下から最新バージョンをダウンロードします。
2020年01月18日時点で、バージョン 0.7.0 が最新でした。

Prometheus exporter for Apache. Contribute to Lusitaniae/apache_exporter development by creating an account on GitHub.

Linux(64bit) で使う場合は、「linux-amd64」となっているものを選びましょう。

$ wget https://github.com/Lusitaniae/apache_exporter/releases/download/v0.7.0/apache_exporter-0.7.0.linux-amd64.tar.gz

インストール

ダウンロードしたら、アーカイブを展開して任意のディレクトリに配置します。
今回は「/usr/local/」に配置することにしました。

# tar zxvf apache_exporter-0.7.0.linux-amd64.tar.gz
# mv -i apache_exporter-0.7.0.linux-amd64 /usr/local/apache_exporter-0.7.0
# cd /usr/local/
# chown prometheus:prometheus apache_exporter-0.7.0
# ln -s apache_exporter-0.7.0 apache_exporter

自動起動の設定

systemd の管理下に入れて、自動起動できるように設定します。

# vi /usr/lib/systemd/system/prometheus_apache_exporter.service

serviceファイルはこんな感じで。

[Unit]
Description=Apache Exporter for Prometheus

[Service]
Type=simple
Restart=always
User=prometheus
ExecStart=/usr/local/apache_exporter/apache_exporter
ExecReload=/bin/kill -HUP $MAINPID
TimeoutStopSec=20s
SendSIGKILL=no

[Install]
WantedBy=multi-user.target

serviceファイルを作成したら、daemon-reloadして認識させます。

# systemctl daemon-reload
# systemctl list-unit-files | grep prometheus_apache_exporter
prometheus_apache_exporter.service              disabled

そして、自動起動を有効化します。

# systemctl enable prometheus_apache_exporter.service
Created symlink from /etc/systemd/system/multi-user.target.wants/prometheus_apache_exporter.service to /usr/lib/systemd/system/prometheus_apache_exporter.service.
# systemctl list-unit-files | grep prometheus_apache_exporter
prometheus_apache_exporter.service              enabled

プロセス起動

自動起動の設定が終わったら、手動起動します。

# systemctl start prometheus_apache_exporter.service

では、確認してみましょう。

# ps -ef | grep apache_exporter
prometh+  2663     1  0 06:44 ?        00:00:00 /usr/local/apache_exporter/apache_exporter
# netstat -anp | grep -i listen
tcp6       0      0 :::9117                 :::*                    LISTEN      2663/apache_exporte

無事に起動しました。Listenポートは9117になっていますね。

Apache の Server Status の確認

httpd の Server Status が未設定の場合は、有効化しておきます。
以下のドキュメントを参考にしてください。

※Server Status の具体的な設定方法は、また別途まとめようと思います。

httpd で Server Status の応答を確認してみます。

# curl localhost/server-status
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html><head>
<title>Apache Status</title>
</head><body>
<h1>Apache Server Status for localhost (via 127.0.0.1)</h1>

<dl><dt>Server Version: Apache/2.4.39 ()</dt>
<dt>Server MPM: prefork</dt>
<dt>Server Built: Apr  4 2019 18:09:28
</dt></dl><hr /><dl>
<dt>Current Time: Saturday, 18-Jan-2020 07:27:09 JST</dt>
<dt>Restart Time: Saturday, 18-Jan-2020 07:00:22 JST</dt>
<dt>Parent Server Config. Generation: 1</dt>
<dt>Parent Server MPM Generation: 0</dt>
<dt>Server uptime:  26 minutes 47 seconds</dt>
<dt>Server load: 0.00 0.00 0.00</dt>
<dt>Total accesses: 173 - Total Traffic: 1.2 MB - Total Duration: 10961</dt>
<dt>CPU Usage: u4.79 s.42 cu0 cs0 - .324% CPU load</dt>
<dt>.108 requests/sec - 811 B/second - 7.4 kB/request - 63.3584 ms/request</dt>
<dt>1 requests currently being processed, 8 idle workers</dt>
</dl><pre>___W_____.......................................................
................................................................
................................................................
................................................................
</pre>
<p>Scoreboard Key:<br />
"<b><code>_</code></b>" Waiting for Connection,
"<b><code>S</code></b>" Starting up,
"<b><code>R</code></b>" Reading Request,<br />
"<b><code>W</code></b>" Sending Reply,
"<b><code>K</code></b>" Keepalive (read),
"<b><code>D</code></b>" DNS Lookup,<br />
"<b><code>C</code></b>" Closing connection,
"<b><code>L</code></b>" Logging,
"<b><code>G</code></b>" Gracefully finishing,<br />
"<b><code>I</code></b>" Idle cleanup of worker,
"<b><code>.</code></b>" Open slot with no current process<br />
</p>


<table border="0"><tr><th>Srv</th><th>PID</th><th>Acc</th><th>M</th><th>CPU
</th><th>SS</th><th>Req</th><th>Dur</th><th>Conn</th><th>Child</th><th>Slot</th><th>Client</th><th>Protocol</th><th>VHost</th><th>Request</th></tr>

<tr><td><b>0-0</b></td><td>3767</td><td>0/18/18</td><td>_
<tr><td><b>1-0</b></td><td>3768</td><td>0/19/19</td><td>_
</td><td>0.48</td><td>80</td><td>0</td><td>775</td><td>0.0</td><td>0.12</td><td>0.12
</td><td>localhost</td><td>http/1.1</td><td nowrap>localhost:80</td><td nowrap>GET /server-status/?auto HTTP/1.1</td></tr>
</table>
 <hr /> <table>
 <tr><th>Srv</th><td>Child Server number - generation</td></tr>
 <tr><th>PID</th><td>OS process ID</td></tr>
 <tr><th>Acc</th><td>Number of accesses this connection / this child / this slot</td></tr>
 <tr><th>M</th><td>Mode of operation</td></tr>
<tr><th>CPU</th><td>CPU usage, number of seconds</td></tr>
<tr><th>SS</th><td>Seconds since beginning of most recent request</td></tr>
 <tr><th>Req</th><td>Milliseconds required to process most recent request</td></tr>
 <tr><th>Dur</th><td>Sum of milliseconds required to process all requests</td></tr>
 <tr><th>Conn</th><td>Kilobytes transferred this connection</td></tr>
 <tr><th>Child</th><td>Megabytes transferred this child</td></tr>
 <tr><th>Slot</th><td>Total megabytes transferred this slot</td></tr>
 </table>
</body></html>

大丈夫そうですね。

Apache Exporter の動作確認

Apache Exporter が動作しているホストで、curlコマンドを使って応答を確認します。

# curl http://localhost:9117/metrics | grep apache | grep -v ^#
apache_accesses_total 64
apache_cpuload 0.269795
apache_exporter_build_info{branch="HEAD",goversion="go1.12.6",revision="6195241a96c02af175ba2842dfd883682133b066",version="0.7.0"} 1
apache_scoreboard{state="closing"} 0
apache_scoreboard{state="dns"} 0
apache_scoreboard{state="graceful_stop"} 0
apache_scoreboard{state="idle"} 8
apache_scoreboard{state="idle_cleanup"} 0
apache_scoreboard{state="keepalive"} 0
apache_scoreboard{state="logging"} 0
apache_scoreboard{state="open_slot"} 247
apache_scoreboard{state="read"} 0
apache_scoreboard{state="reply"} 1
apache_scoreboard{state="startup"} 0
apache_sent_kilobytes_total 247
apache_up 1
apache_uptime_seconds_total 682
apache_workers{state="busy"} 1
apache_workers{state="idle"} 8

Prometheus 側の設定

prometheus.ymlの修正

Prometheus が apache_exporter 経由でデータを収集できるように、 prometheus.yml に設定を追加します。
「scrape_configs:」の中に、以下のような感じでapache_exporter用の設定を追加します。

  - job_name: 'httpd-status'

    # metrics_path defaults to '/metrics'
    # scheme defaults to 'http'.

    static_configs:
    - targets: ['192.168.0.2:9117']

設定を変更したら、prometheusを再起動します。

# sysmtectl restart prometheus.server
スポンサーリンク

シェアする

  • このエントリーをはてなブックマークに追加

フォローする

スポンサーリンク