Doctor User Guide

1. Doctor capabilities and usage

1.1. Immediate Notification

Immediate notification can be used by creating ‘event’ type alarm via OpenStack Alarming (Aodh) API with relevant internal components support.

See, upstream spec document:

An example of a consumer of this notification can be found in the Doctor repository. It can be executed as follows:

git clone -b stable/colorado
cd doctor/tests
python "$CONSUMER_PORT" > consumer.log 2>&1 &

1.2. Consistent resource state awareness

Resource state of compute host can be changed/updated according to a trigger from a monitor running outside of OpenStack Compute (Nova) by using force-down API.

See for more detail.

1.3. Valid compute host status given to VM owner

The resource state of a compute host can be retrieved by a user with the OpenStack Compute (Nova) servers API.

See for more detail.