share facebook facebook2 twitter menu hatena pocket slack

2016.05.16 MON

Mackerel事始め agent-plugin Apache

WRITTEN BY大住 孝之

agent-pluginを使ってミドルウェアの監視設定を追加していきます。

confファイルのinclude設定

mackerel-agent.conf のコメント解除や直接追記も可能ですが、 監視対象それぞれで設定ファイルを分けたいので、 include設定を追加します。

$ cd /etc/mackerel-agent/mackerel-agent
$ sudo mkdir conf.d
$ sudo vi mackerel-agent.conf
# 以下を追記
include = "/etc/mackerel-agent/conf.d/*.conf"

プラグインの動作確認方法

共通して同じように使えると思います。

# パスの確認
$ which mackerel-plugin-XXX
/usr/local/bin/mackerel-plugin-XXX
# 値の取得確認(confに設定するcommand)
/usr/local/bin/mackerel-plugin-XXX
# オプションの確認
$ mackerel-plugin-XXX -h

mackerel-plugin-apache2

Apacheの監視設定を追加します。
Apacheのバージョンは2.2です。 mod_status が有効化されている事が前提です。

sudo vi /etc/mackerel-agent/conf.d/apache.conf
# 以下を追記
[plugin.metrics.apache2]
command = "/usr/local/bin/mackerel-plugin-apache2"
type = "metric"
  • command にはpluginのパスを指定します。
  • ポート等変更する場合はオプション指定します。
# パスの確認
$ which mackerel-plugin-apache2
/usr/local/bin/mackerel-plugin-apache2
# オプションの確認
$ mackerel-plugin-apache2 -h

取得状況の確認

mackerel-plugin-apache2 を実行することで値の取得を確認できます。

$ sudo /usr/local/bin/mackerel-plugin-apache2
apache2.workers.busy_workers    1.000000    1459133656
apache2.workers.idle_workers    230.000000  1459133656
apache2.bytes.bytes_sent    3.750000    1459133656
apache2.cpu.cpu_load    0.554053    1459133656
apache2.req.requests    3.750000    1459133656
apache2.scoreboard.score-_  230.000000  1459133656
apache2.scoreboard.score-.  793.000000  1459133656

有効化

mackerel-agent の再起動で有効化します。

# 設定確認
$ sudo service mackerel-agent configtestTesting configuration of mackerel-agent:                   [  OK  ]
# 再起動
$ sudo service mackerel-agent restart
Stopping mackerel-agent:                                   [  OK  ]
Starting mackerel-agent:
                                                           [  OK  ]

20160405195836

ダッシュボードへ反映

  • 置換文字列
__ORG__     = Organization
__SERVICE__ = Service
__ROLE___   = Role
__PERIOD__  = Period {m(分), h(時間), d(日), w(週), mo(月), y(年)}
# Apache
|:---|:---|:---|
| **# requests** | **# cpu_load** | **# bytes_sent** |
| [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.bytes.bytes_sent&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.bytes.bytes_sent) | [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.req.requests&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.req.requests) | [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.cpu.cpu_load&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.cpu.cpu_load) |
| **# busy_workers** | **# idle_workers** |  |
| [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.scoreboard.score-.&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.scoreboard.score-.) | [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.scoreboard.score-_&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.scoreboard.score-_) |  |
| **# score-** | **# score-_** |  |
| [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.workers.busy_workers&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.workers.busy_workers) | [![graph](https://mackerel.io/embed/orgs/__ORG__/services/__SERVICE__/__ROLE__.png?graph=custom.apache2.workers.idle_workers&stacked=false&simplified=false&period=__PERIOD__)](https://mackerel.io/orgs/__ORG__/services/__SERVICE__/__ROLE__/-/graph?name=custom.apache2.workers.idle_workers) |  |

20160405195837

元記事はこちら

Mackerel事始め agent-plugin Apache

大住 孝之

構築運用担当。 個性的な面々の中で無個性という個性を打ち出していこうと画策中。