b2235bf3fb
Execluded all XML files in the directory doc/common/tables because they are autogenerated. The XML root element of Docbook XML files should match the following format: <ELEMENT xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="THE_XML_ID_OF_THE_ELEMENT"> Change-Id: If12091be81ec8b2e6e53bfcb4c3a883a65e24736
120 lines
7.0 KiB
XML
120 lines
7.0 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
version="5.0"
|
|
xml:id="usage_statistics">
|
|
<title>Show usage statistics for hosts and instances</title>
|
|
<para>You can show basic
|
|
statistics on resource usage for hosts and instances.</para>
|
|
<note>
|
|
<para>For more sophisticated
|
|
monitoring, see the <link
|
|
xlink:href="https://launchpad.net/ceilometer"
|
|
>ceilometer</link> project.
|
|
You can also use tools, such as <link
|
|
xlink:href="http://ganglia.info/">Ganglia</link> or
|
|
<link xlink:href="http://graphite.wikidot.com/"
|
|
>Graphite</link>, to gather more detailed data.</para>
|
|
</note>
|
|
<section xml:id="host_usage_statistics">
|
|
<title>Show host usage statistics</title>
|
|
<para>The following examples show the host usage statistics for a host
|
|
called <filename>devstack</filename>.</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>List the hosts and the nova-related services that run on
|
|
them:</para><screen><prompt>$</prompt> <userinput>nova host-list</userinput>
|
|
<computeroutput>+-----------+-------------+----------+
|
|
| host_name | service | zone |
|
|
+-----------+-------------+----------+
|
|
| devstack | conductor | internal |
|
|
| devstack | compute | nova |
|
|
| devstack | cert | internal |
|
|
| devstack | network | internal |
|
|
| devstack | scheduler | internal |
|
|
| devstack | consoleauth | internal |
|
|
+-----------+-------------+----------+</computeroutput></screen></listitem>
|
|
<listitem><para>Get a summary of resource usage of all of the instances running on
|
|
the host:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova host-describe devstack</userinput>
|
|
<computeroutput>+-----------+----------------------------------+-----+-----------+---------+
|
|
| HOST | PROJECT | cpu | memory_mb | disk_gb |
|
|
+----------+----------------------------------+-----+-----------+---------+
|
|
| devstack | (total) | 2 | 4003 | 157 |
|
|
| devstack | (used_now) | 3 | 5120 | 40 |
|
|
| devstack | (used_max) | 3 | 4608 | 40 |
|
|
| devstack | b70d90d65e464582b6b2161cf3603ced | 1 | 512 | 0 |
|
|
| devstack | 66265572db174a7aa66eba661f58eb9e | 2 | 4096 | 40 |
|
|
+----------+----------------------------------+-----+-----------+---------+</computeroutput></screen>
|
|
<para>The <literal>cpu</literal> column shows the sum of
|
|
the virtual CPUs for instances running on the host.</para>
|
|
<para>The <literal>memory_mb</literal> column shows the sum of the
|
|
memory (in MB) allocated to the instances that run on the
|
|
host.</para>
|
|
<para>The <literal>disk_gb</literal> column shows the sum of the
|
|
root and ephemeral disk sizes (in GB) of the instances that
|
|
run on the host.</para>
|
|
<para>The row that has the value <literal>used_now</literal> in the
|
|
<literal>PROJECT</literal> column shows the sum of the
|
|
resources allocated to the instances that run on the host,
|
|
plus the resources allocated to the virtual machine of the
|
|
host itself.</para>
|
|
<para>The row that has the value <literal>used_max</literal> row in
|
|
the <literal>PROJECT</literal> column shows the sum of the
|
|
resources allocated to the instances that run on the
|
|
host.</para></listitem>
|
|
</itemizedlist>
|
|
<note>
|
|
<para>These values are computed by using information about the flavors of the
|
|
instances that run on the hosts. This command does not query the
|
|
CPU usage, memory usage, or hard disk usage of the physical
|
|
host.</para>
|
|
</note>
|
|
</section>
|
|
<section xml:id="instance_usage_statistics">
|
|
<title>Show instance usage statistics</title>
|
|
<itemizedlist>
|
|
<listitem><para>Get CPU, memory, I/O, and network statistics for an
|
|
instance.</para>
|
|
<orderedlist><listitem><para>List instances:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova list</userinput>
|
|
<computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+
|
|
| ID | Name | Status | Task State | Power State | Networks |
|
|
+--------------------------------------+----------------------+--------+------------+-------------+------------------+
|
|
| 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 | myCirrosServer | ACTIVE | None | Running | private=10.0.0.3 |
|
|
| 8a99547e-7385-4ad1-ae50-4ecfaaad5f42 | myInstanceFromVolume | ACTIVE | None | Running | private=10.0.0.4 |
|
|
+--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen></listitem>
|
|
<listitem><para>Get diagnostic statistics:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova diagnostics myCirrosServer</userinput>
|
|
<computeroutput>+------------------+----------------+
|
|
| Property | Value |
|
|
+------------------+----------------+
|
|
| vnet1_rx | 1210744 |
|
|
| cpu0_time | 19624610000000 |
|
|
| vda_read | 0 |
|
|
| vda_write | 0 |
|
|
| vda_write_req | 0 |
|
|
| vnet1_tx | 863734 |
|
|
| vnet1_tx_errors | 0 |
|
|
| vnet1_rx_drop | 0 |
|
|
| vnet1_tx_packets | 3855 |
|
|
| vnet1_tx_drop | 0 |
|
|
| vnet1_rx_errors | 0 |
|
|
| memory | 2097152 |
|
|
| vnet1_rx_packets | 5485 |
|
|
| vda_read_req | 0 |
|
|
| vda_errors | -1 |
|
|
+------------------+----------------+</computeroutput></screen></listitem></orderedlist></listitem>
|
|
<listitem><para>Get summary statistics for each tenant:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova usage-list</userinput>
|
|
<computeroutput>Usage from 2013-06-25 to 2013-07-24:
|
|
+----------------------------------+-----------+--------------+-----------+---------------+
|
|
| Tenant ID | Instances | RAM MB-Hours | CPU Hours | Disk GB-Hours |
|
|
+----------------------------------+-----------+--------------+-----------+---------------+
|
|
| b70d90d65e464582b6b2161cf3603ced | 1 | 344064.44 | 672.00 | 0.00 |
|
|
| 66265572db174a7aa66eba661f58eb9e | 3 | 671626.76 | 327.94 | 6558.86 |
|
|
+----------------------------------+-----------+--------------+-----------+---------------+</computeroutput></screen></listitem></itemizedlist>
|
|
</section>
|
|
</section>
|