メトリック仕様

サービス詳細及び、ホスト詳細画面で表示されるメトリックを解説します。

システムメトリック

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
  • 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 のソースコードは以下で公開されていますので、こちらも合わせてご確認ください。

github.com

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 を呼び出した結果から取得しています。
  • disk
    • WMI を使用して Win32_PerfFormattedData_PerfDisk_LogicalDisk クラスから情報を取得しています。
  • interface
    • Windows Performance Data Helper API によって情報を取得しています。
  • filesystem
    • Win32 API である以下の関数を呼び出した結果から取得、計算しています。
      • GetLogicalDriveStringsW
      • QueryDosDeviceW
      • GetVolumeInformationW
      • GetDiskFreeSpaceExW

mackerel-agent のソースコードは以下で公開されていますので、こちらも合わせてご確認ください。

github.com

ユーザー定義のメトリック（カスタムメトリック）

  • custom.foo(.bar)*.*
    • 名前の最後のドットまでが共通するメトリックがひとつのグラフにまとめられ表示されます。

mackerel-agentから送信するカスタムメトリックには、プレフィックスとしてcustom.が付与されます（バージョン 0.6.1 より）。 mackerel-agentのアップデートにより標準メトリックが追加されることがありますので、APIを直接使用する場合も、custom.を付与することを推奨します。ホストのカスタムメトリックを投稿するも参照して下さい。