6 Commits

Author SHA1 Message Date
Mario Villaplana
cb2971ba27 Add notification documentation to administrator's guide
This moves the description of available notifications in ironic to the
administrator's guide and briefly describes how to configure
notifications. It also documents the message bus topic ironic
notifications are emitted on, since previously that required looking at
code to find out.

Related-Bug: #1526408
Change-Id: I4d5dfe92d2c2646a7cc803fa6ea7ade723aba310
2016-11-17 20:22:27 +00:00
Yuriy Zveryanskyy
d5e24cf6f8 Trivial fix of notifications doc
Fix "properties" field in the examples and add small note.

Change-Id: Id63e8d95fc7f2ba1cf956eff657b3a2d902d9f93
2016-10-19 11:11:47 +03:00
Mario Villaplana
ff32b51bbf Add power state change notifications
This adds optional notifications emitted when ironic changes a node's power
state or when ironic detects a change in a node's power state.

These notifications can be consumed by any external service listening to the
message bus to perform functions like tracking node power state changes over
time or automatically responding to anomalous power states.

The event_types of the new notifications are:

* baremetal.node.power_set.{start,end,error}
* baremetal.node.power_state_corrected.success

This also adds a new NodePayload class for notification payloads related
to nodes.

Change-Id: I82702e7f959d666bb02b59d1fc53ab50b519cb74
Closes-Bug: 1526408
2016-10-17 15:39:18 +00:00
Ruby Loo
996fffb992 Notification event types have status 'error'
Fixes the documentation to indicate that the notification
event types can have status 'error'. 'fail' is incorrect.
(11fcf6b710/ironic/objects/notification.py (L48))

Change-Id: I13c3f40430a4d7f8c07fdd9861b2d8712b8247a6
2016-09-19 11:25:32 -04:00
Mario Villaplana
77c7a710fc Replace "phase" with "status" in notification base
The notification spec is being updated to rename "phase" to "status" and make
it a required field. This updates the notification base code and docs to
reflect this modification. Version for the notification EventType base class is
also bumped.

Change-Id: I11b6ea44a01d2a830b592784ccc63a1de9bf2ec1
Depends-On: Ib25bd5a3a600c13f7b265d86ad253af3dfa5552f
2016-09-15 22:53:12 +00:00
Mario Villaplana
2cc70ea93a Add notification base classes and docs
This adds base classes and documentation for creating notifications.

Partial-Bug: 1526408

Change-Id: Ib1b1fa819e8ff0b93afacd0b3de6e6762168e230
2016-08-23 21:46:16 +00:00