host_metrics 
Class: host_metrics The metrics associated with a host
Published in: XenServer 4.0 (rio) The metrics associated with a host 
Fields 
datetime 
last_updated 
[RO/runtime] 
Time at which this information was last updated
Published in: XenServer 4.0 (rio) Time at which this information was last updated 
bool 
live 
[RO/runtime] 
Pool master thinks this host is live
Published in: XenServer 4.0 (rio) Pool master thinks this host is live 
Removed
int 
memory_free 
[RO/runtime] 
Free host memory (bytes)
Default value: 0 Published in: XenServer 4.0 (rio) Deprecated in: XenServer 5.6 (midnight-ride) Will be disabled in favour of RRD Removed in: XenServer 6.1 (tampa) Disabled in favour of RRD 
int 
memory_total 
[RO/runtime] 
Total host memory (bytes)
Published in: XenServer 4.0 (rio) Total host memory (bytes) 
(string → string) map 
other_config 
[RW] 
additional configuration
Default value: {} Published in: XenServer 5.0 (orlando) additional configuration 
string 
uuid 
[RO/runtime] 
Unique identifier/object reference
Published in: XenServer 4.0 (rio) Unique identifier/object reference 
Messages
Hide implicit  
void 
add_to_other_config 
(session ref , host_metrics ref , string , string ) 
Add the given key-value pair to the other_config field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object string key Key to add string value Value to add Minimum role: pool-operator Published in: XenServer 5.0 (orlando) additional configuration 
host_metrics ref set 
get_all 
(session ref ) 
Return a list of all the host_metrics instances known to the system.
Parameters: session ref session_id Reference to a valid session Minimum role: read-only Result: references to all objects Published in: XenServer 4.0 (rio) The metrics associated with a host 
(host_metrics ref → host_metrics record) map 
get_all_records 
(session ref ) 
Return a map of host_metrics references to host_metrics records for all host_metrics instances known to the system.
Parameters: session ref session_id Reference to a valid session Minimum role: read-only Result: records of all objects Published in: XenServer 4.0 (rio) The metrics associated with a host 
host_metrics ref 
get_by_uuid 
(session ref , string ) 
Get a reference to the host_metrics instance with the specified UUID.
Parameters: session ref session_id Reference to a valid session string uuid UUID of object to return Minimum role: read-only Result: reference to the object Published in: XenServer 4.0 (rio) The metrics associated with a host 
datetime 
get_last_updated 
(session ref , host_metrics ref ) 
Get the last_updated field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Time at which this information was last updated 
bool 
get_live 
(session ref , host_metrics ref ) 
Get the live field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Pool master thinks this host is live 
Removed
int 
get_memory_free 
(session ref , host_metrics ref ) 
Get the memory/free field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Deprecated in: XenServer 5.6 (midnight-ride) Will be disabled in favour of RRD Removed in: XenServer 6.1 (tampa) Disabled in favour of RRD 
int 
get_memory_total 
(session ref , host_metrics ref ) 
Get the memory/total field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Total host memory (bytes) 
(string → string) map 
get_other_config 
(session ref , host_metrics ref ) 
Get the other_config field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 5.0 (orlando) additional configuration 
host_metrics record 
get_record 
(session ref , host_metrics ref ) 
Get a record containing the current state of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: all fields from the object Published in: XenServer 4.0 (rio) The metrics associated with a host 
string 
get_uuid 
(session ref , host_metrics ref ) 
Get the uuid field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object Minimum role: read-only Result: value of the field Published in: XenServer 4.0 (rio) Unique identifier/object reference 
void 
remove_from_other_config 
(session ref , host_metrics ref , string ) 
Remove the given key and its corresponding value from the other_config field of the given host_metrics. If the key is not in that Map, then do nothing.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object string key Key to remove Minimum role: pool-operator Published in: XenServer 5.0 (orlando) additional configuration 
void 
set_other_config 
(session ref , host_metrics ref , (string → string) map ) 
Set the other_config field of the given host_metrics.
Parameters: session ref session_id Reference to a valid session host_metrics ref self reference to the object (string → string) map value New value to set Minimum role: pool-operator Published in: XenServer 5.0 (orlando) additional configuration