Difference between revisions of "ServicePluginDocumentation"
Line 27: | Line 27: | ||
=== Listing Available Services === | === Listing Available Services === | ||
+ | |||
+ | <pre><nowiki> | ||
$ nova service-list | $ nova service-list | ||
Line 37: | Line 39: | ||
| 4 | console | squeeze | False | 0 | None | | | 4 | console | squeeze | False | 0 | None | | ||
+----+-----------+---------+----------+--------------+---------------------+ | +----+-----------+---------+----------+--------------+---------------------+ | ||
+ | </nowiki></pre> | ||
+ | |||
=== Showing Service Info === | === Showing Service Info === | ||
+ | |||
+ | <pre><nowiki> | ||
$ nova service-show 1 | $ nova service-show 1 | ||
Line 53: | Line 59: | ||
| updated_at | 2012-02-01 19:15:39 | | | updated_at | 2012-02-01 19:15:39 | | ||
+--------------+------------------------------------------+ | +--------------+------------------------------------------+ | ||
+ | </nowiki></pre> | ||
+ | |||
=== Addition Service Details === | === Addition Service Details === | ||
+ | |||
+ | <pre><nowiki> | ||
$ nova service-details 1 | $ nova service-details 1 | ||
Line 72: | Line 82: | ||
| vcpus_used | 0 | | | vcpus_used | 0 | | ||
+------------------------+-------+ | +------------------------+-------+ | ||
+ | </nowiki></pre> | ||
+ | |||
=== List Servers Belonging to Compute Resource === | === List Servers Belonging to Compute Resource === | ||
+ | |||
+ | <pre><nowiki> | ||
$ nova service-servers 1 | $ nova service-servers 1 | ||
Line 82: | Line 96: | ||
| flag | 0 | | | flag | 0 | | ||
+------------------------+-------+ | +------------------------+-------+ | ||
+ | </nowiki></pre> | ||
+ | |||
=== Displaying Service Version === | === Displaying Service Version === | ||
+ | |||
+ | <pre><nowiki> | ||
$ nova service-version 1 | $ nova service-version 1 | ||
2012.1-dev | 2012.1-dev | ||
+ | </nowiki></pre> |
Revision as of 19:29, 1 February 2012
Services Extension Documentation
Description
The services extension for Nova is a tool to provide additional visibility into a running Nova installation, providing metrics, version information, and a breakdown of instances by hostmachine.
Installation
Server-Side
To use the service plugin, you must install the server-side extension into the nova/api/openstack/compute/contrib directory and then restart the API server.
Client-Side
To use the service plugin from novaclient, you must install the novaclient extension. The easiest way to do this is to run::
pip install rax_services_python_novaclient_ext.
Usage
Listing Available Services
$ nova service-list +----+-----------+---------+----------+--------------+---------------------+ | ID | topic | host | disabled | report_count | updated_at | +----+-----------+---------+----------+--------------+---------------------+ | 1 | compute | squeeze | False | 704782 | 2012-02-01 19:14:28 | | 2 | scheduler | squeeze | False | 714968 | 2012-02-01 19:14:34 | | 3 | network | squeeze | False | 714983 | 2012-02-01 19:14:26 | | 4 | console | squeeze | False | 0 | None | +----+-----------+---------+----------+--------------+---------------------+
Showing Service Info
$ nova service-show 1 +--------------+------------------------------------------+ | Property | Value | +--------------+------------------------------------------+ | disabled | False | | host | squeeze | | href | http://10.127.4.222:8774/v1.1/services/1 | | id | 1 | | report_count | 704789 | | topic | compute | | updated_at | 2012-02-01 19:15:39 | +--------------+------------------------------------------+
Addition Service Details
$ nova service-details 1 +------------------------+-------+ | Property | Value | +------------------------+-------+ | cpu_info | 8 | | hypervisor_type | xen | | hypervisor_version | 0 | | local_gb | 265 | | local_gb_used | 23 | | memory_mb | 32767 | | memory_mb_used | 2216 | | memory_mb_used_servers | 256 | | vcpus | 0 | | vcpus_used | 0 | +------------------------+-------+
List Servers Belonging to Compute Resource
$ nova service-servers 1 +------------------------+-------+ | Property | Value | +------------------------+-------+ | flag | 0 | +------------------------+-------+
Displaying Service Version
$ nova service-version 1 2012.1-dev