Python client library for Watcher API
Project description
python-watcherclient
Client for resource optimization service for OpenStack.
OpenStack Watcher provides a flexible and scalable resource optimization service for multi-tenant OpenStack-based clouds. Watcher provides a complete optimization loop-including everything from a metrics receiver, complex event processor and profiler, optimization processor and an action plan applier. This provides a robust framework to realize a wide range of cloud optimization goals, including the reduction of data center operating costs, increased system performance via intelligent virtual machine migration, increased energy efficiency and more!
Free software: Apache license
Installation
Install the prerequisite packages
On Ubuntu (tested on 14.04-64)
sudo apt-get install python-dev libssl-dev python-pip git-core libmysqlclient-dev libffi-dev
On Fedora-based distributions e.g., Fedora/RHEL/CentOS/Scientific Linux (tested on CentOS 6.5)
sudo yum install python-virtualenv openssl-devel python-pip git gcc libffi-devel mysql-devel postgresql-devel
On openSUSE-based distributions (SLES 12, openSUSE 13.1, Factory or Tumbleweed)
sudo zypper install gcc git libmysqlclient-devel libopenssl-devel postgresql-devel python-devel python-pip
Install the Watcher client
You can install the Watcher CLI with the following command:
sudo pip install python-watcherclient
You can also use the OpenStack client with Watcher (our watcher plugin for OpenStack client is included in the python-watcherclient package). To install it, you have just to run this command:
sudo pip install python-openstackclient
Configuration
Create a creds file containing your OpenStack credentials:
export OS_IDENTITY_API_VERSION=3
export OS_AUTH_URL=http://<your-keystone-server>:5000/v3
export OS_PROJECT_DOMAIN_ID=default
export OS_USER_DOMAIN_ID=default
export OS_USERNAME=admin
export OS_PASSWORD=<your-password>
export OS_PROJECT_NAME=<your-project-name>
Source these credentials into your current shell session:
# source creds
You should be able to launch the following command which gets the list of previously created Audit Templates:
# watcher audittemplate list
or:
# openstack optimize audittemplate list +--------------------------------+------+----------------------+----------+ | UUID | Name | Goal | Strategy | +--------------------------------+------+----------------------+----------+ +--------------------------------+------+----------------------+----------+
You can view the entire list of available Watcher commands and options using this command:
# watcher help
or:
# openstack help optimize
Troubleshootings
If any watcher command fails, you can obtain more details with the –debug option :
# watcher --debug audittemplate list
or:
# openstack --debug optimize audittemplate list
Install the openstack CLI :
# pip install python-openstackclient
Make sure that your Openstack credentials are correct. If so, you should be able to verify that the watcher user has been declared in your Openstack keystone :
# openstack user list
and that the watcher endpoints have been declared as well :
# openstack endpoint list
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python-watcherclient-4.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a15bc207c9583163b64ea27927191e8478eaacb3d31e064e2f1ef326e31c833d |
|
MD5 | ae192c1cbe674d8946be7c45245e3964 |
|
BLAKE2b-256 | 4f2e85caf363e9a3997a673a033a0d987112a3905a0376c0ed0c994a729d85c4 |
Hashes for python_watcherclient-4.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35eefa04964da7eaabc66b3ef8c5e068f3d45ec705554eba461d99348f37cf58 |
|
MD5 | 42ccb7844c7eae96fcb88a173a2b4f93 |
|
BLAKE2b-256 | b6a1d8951d731de9de4d71212f74e04dc9da523d4452582f6ef1b6c830b330a7 |