Jump to: navigation, search

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