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