メトリックプラグイン - mackerel-plugin-linux

mackerel-plugin-linux は Linux の情報を毎分集計し、メトリックとして投稿するプラグインです。

監視できるメトリック

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Users	linux.users.users	-	-	ログイン中のユーザ数

who コマンドの結果を参照。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Interrupts	linux.interrupts.interrupts	○	-	システムで発生した割り込み数

/proc/stat の intr の値を参照。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Context Switches	linux.context_switches.context_switches	○	-	コンテキストスイッチの回数

/proc/stat の ctxt の値を参照。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Forks	linux.forks.forks	○	-	フォーク（fork）の回数

/proc/stat の processes の値を参照。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
<device> IO Time	linux.disk.elapsed.iotime_<device>	○	-	このブロックデバイスがアクティブになっていた合計時間（ミリ秒）
<device> IO Time Weighted	linux.disk.elapsed.iotime_weighted_<device>	○	-	全リクエストの合計待機時間（ミリ秒）

/sys/block/<device>/stat の io_ticks および time_in_queue の値を参照。<device> はデバイス名に置き換えられます。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
<device> Read	linux.disk.rwtime.tsreading_<device>	○	-	読み取りリクエストの合計待機時間（ミリ秒）
<device> Write	linux.disk.rwtime.tswriting_<device>	○	-	書き込みリクエストの合計待機時間（ミリ秒）

/sys/block/<device>/stat の read ticks および write ticks の値を参照。<device> はデバイス名に置き換えられます。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Established	linux.ss.ESTAB	-	○	ESTAB の数
Syn Sent	linux.ss.SYN-SENT	-	○	SYN-SENT の数
Syn Received	linux.ss.SYN-RECV	-	○	SYN-RECV の数
Fin Wait 1	linux.ss.FIN-WAIT-1	-	○	FIN-WAIT-1 の数
Fin Wait 2	linux.ss.FIN-WAIT-2	-	○	FIN-WAIT-2 の数
Time Wait	linux.ss.TIME-WAIT	-	○	TIME-WAIT の数
Close	linux.ss.UNCONN	-	○	UNCONN の数
Close Wait	linux.ss.CLOSE-WAIT	-	○	CLOSE-WAIT の数
Last Ack	linux.ss.LAST-ACK	-	○	LAST-ACK の数
Listen	linux.ss.LISTEN	-	○	LISTEN の数
Closing	linux.ss.CLOSING	-	○	CLOSING の数
Unknown	linux.ss.UNKNOWN	-	○	UNKNOWN の数

ss コマンドの結果を State ごとにカウント。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Swap In	linux.swap.pswpin	○	-	スワップインしたページ数
Swap Out	linux.swap.pswpout	○	-	スワップアウトしたページ数

/proc/vmstat の pswpin および pswpout の値を参照。

オプション	省略形	説明	デフォルト値
--tempfile	-t	tempfile の保存先ファイルパスの指定
--type	-p	取得するメトリックの絞り込み all, users, proc_stat, diskstats, netstat, swap のいずれかを指定	all
--version	-v	プラグインのバージョンを表示
--help	-h	ヘルプを表示

tempfile には集計結果が記録されます。デフォルトでは /var/tmp/mackerel-agent/ 配下に mackerel-plugin-linux-<ハッシュ文字列> の形式で作成されます。

[plugin.metrics.linux]
command = ["mackerel-plugin-linux"]