• View
• Edit
• History
• Print

mod_ibmams

Description

The Power6/7 Active Memory Sharing (AMS) extensions (maximum of 9 metrics) are contained in a separate DSO module (written in C) called mod_ibmams. If installed, this DSO module is loaded during runtime/startup of gmond.

This DSO can be used to monitor the AMS properties of the running AIX instance.

Platform availability:

• Power6 and Power7 systems only
• AIX: minimum AIX V6.1 TL03 level or higher required
• Linux:
  • SLES 11 or higher required
  • RHEL 6 or higher required

Config file: /etc/ganglia/conf.d/ibmams.conf

Available metrics

The following 9 additional metrics are available:

1. ams_hpi
   • Number of hypervisor page-ins
2. ams_hpit
   • Time spent in hypervisor page-ins (in seconds)
3. ams_hypv_pagesize
   • Hypervisor page size in KB
4. ams_io_hwm
   • High water mark of I/O memory entitlement used (in bytes)
5. ams_io_me
   • I/O memory entitlement of the partition (in bytes)
6. ams_io_mu
   • I/O memory entitlement of the partition in use (in bytes)
7. ams_pmem
   • Amount of physical memory currently backing partition's logical memory (in bytes)
8. ams_pool_id
   • AMS pool id of the pool the LPAR belongs to
9. ams_var_mem_weight
   • Variable memory capacity weight

Config file example

modules {
  module {
    name = "ibmams_module"
    path = "modibmams.so"
  }
}

collection_group {
  collect_every = 180
  time_threshold = 1200
  metric {
    name = "ams_pool_id"
    title = "AMS Pool ID"
    value_threshold = 1
  }
  metric {
    name = "ams_hypv_pagesize"
    title = "AMS Hypervisor page size"
    value_threshold = 1
  }
  metric {
    name = "ams_var_mem_weight"
    title = "AMS Memory Capacity Weight"
    value_threshold = 1
  }
}

collection_group {
  collect_every = 15
  time_threshold = 180
  metric {
    name = "ams_iohwm"
    title = "AMS high water mark I/O Memory Entitlement"
    value_threshold = 1
  }
  metric {
    name = "ams_iome"
    title = "AMS I/O Memory Entitlement"
    value_threshold = 1
  }
  metric {
    name = "ams_iomu"
    title = "AMS I/O Memory Entitlement in use"
    value_threshold = 1
  }
}

collection_group {
  collect_every = 5
  time_threshold = 15
  metric {
    name = "ams_hpi"
    title = "AMS number of Hypervisor page-ins"
    value_threshold = 0.0000001
  }
  metric {
    name = "ams_hpit"
    title = "AMS time spent in Hypervisor page-ins"
    value_threshold = 0.0000001
  }
  metric {
    name = "ams_pmem"
    title = "AMS Physical Backing Memory"
    value_threshold = 1
  }
}

Change History AIX

• Version 1.1: Feb 12, 2010
  • added checks for possible libperfstat counter resets
  • change unit for ams_hypv_pagesize_func() from KB to Bytes
• Version 1.0: Jun 19, 2009
  • initial version

Change History Linux

• Version 1.0: Oct 12, 2009
  • initial version