サービス詳細及び、ホスト詳細画面で表示されるメトリックを解説します。
システムメトリック
mackerel-agent をインストール・起動することで自動的に収集・投稿されるメトリック群です。
Linux
loadavg, cpu, memory, disk, interface, filesystem の6種類のグラフが表示され、それぞれ以下のメトリック名の値が描画されます。
- loadavg(折れ線)
loadavg1
loadavg5
loadavg15
- cpu(積み上げ)
cpu.user.percentage
cpu.iowait.percentage
cpu.system.percentage
cpu.idle.percentage
cpu.nice.percentage
cpu.irq.percentage
cpu.softirq.percentage
cpu.steal.percentage
cpu.guest.percentage
- memory(積み上げ。
memory.total
、swap_total
swap_used
とswap_cached
は折れ線)- Kernel 3.14以降のLinux
memory.used
memory.available
memory.total
memory.swap_used
memory.swap_cached
memory.swap_total
- それ以外のLinux
memory.free
memory.buffers
memory.cached
memory.used
memory.total
memory.swap_used
memory.swap_cached
memory.swap_total
- Kernel 3.14以降のLinux
- disk(折れ線)
disk.*.reads.delta
disk.*.writes.delta
- interface(折れ線)
interface.*.rxBytes.delta
(受信バイト数)interface.*.txBytes.delta
(送信バイト数)
- filesystem(折れ線)
filesystem.*.size
filesystem.*.used
また、mackerel-agent を用いた場合の上記それぞれのメトリックの取得元は、以下の通りです。
- loadavg
/proc/loadavg
の内容をパースすることで取得。
- cpu
/proc/stat
の内容をパースすることで取得。
- memory
/proc/meminfo
の内容をパースすることで取得。
- disk
/proc/diskstats
の内容をパースすることで取得。
- interface
/proc/net/dev
の内容をパースすることで取得。
- filesystem
df
コマンドの実行結果をパースすることで取得。
mackerel-agent のソースコードは以下で公開されていますので、こちらも合わせてご確認ください。
Windows
processor queue length, cpu, memory, disk, interface, filesystem の6種類のグラフが表示され、それぞれ以下のメトリック名の値が描画されます。
- processor queue length(折れ線)
processor_queue_length
- cpu(積み上げ)
cpu.user.percentage
cpu.system.percentage
cpu.idle.percentage
- memory(積み上げ。
memory.total
、pagefile_free
とpagefile_total
は折れ線)memory.free
memory.used
memory.total
memory.pagefile_free
memory.pagefile_total
- disk(折れ線)
disk.*.reads.delta
disk.*.writes.delta
- interface(折れ線)
interface.*.rxBytes.delta
(受信バイト数)interface.*.txBytes.delta
(送信バイト数)
- filesystem(折れ線)
filesystem.*.size
filesystem.*.used
また、mackerel-agent を用いた場合の上記それぞれのメトリックの取得元は、以下の通りです。
- processor queue length
- Windows Performance Data Helper API によって情報を取得しています。
- cpu
- Windows Performance Data Helper API によって情報を取得しています。
- memory
- Win32 API である
GlobalMemoryStatusEx
を呼び出した結果から取得しています。
- Win32 API である
- disk
- WMI を使用して
Win32_PerfFormattedData_PerfDisk_LogicalDisk
クラスから情報を取得しています。
- WMI を使用して
- interface
- Windows Performance Data Helper API によって情報を取得しています。
- filesystem
- Win32 API である以下の関数を呼び出した結果から取得、計算しています。
GetLogicalDriveStringsW
QueryDosDeviceW
GetVolumeInformationW
GetDiskFreeSpaceExW
- Win32 API である以下の関数を呼び出した結果から取得、計算しています。
mackerel-agent のソースコードは以下で公開されていますので、こちらも合わせてご確認ください。
ユーザー定義のメトリック(カスタムメトリック)
custom.foo(.bar)*.*
- 名前の最後のドットまでが共通するメトリックがひとつのグラフにまとめられ表示されます。
mackerel-agentから送信するカスタムメトリックには、プレフィックスとしてcustom.
が付与されます(バージョン 0.6.1 より)。 mackerel-agentのアップデートによりシステムメトリックが追加されることがありますので、APIを直接使用する場合も、custom.
を付与することを推奨します。ホストのカスタムメトリックを投稿するも参照して下さい。