Notifications

Notifications can be generated for several events in the image lifecycle. These can be used for auditing, troubleshooting, etc.

Notification Drivers

• log

  This driver uses the standard Python logging infrastructure with the notifications ending up in file specified by the log_file configuration directive.

• messaging

  This strategy sends notifications to a message queue configured using oslo.messaging configuration options.

• noop

  This strategy produces no notifications. It is the default strategy.

Notification Types

• image.create

  Emitted when an image record is created in Glance. Image record creation is independent of image data upload.

• image.prepare

  Emitted when Glance begins uploading image data to its store.

• image.upload

  Emitted when Glance has completed the upload of image data to its store.

• image.activate

  Emitted when an image goes to active status. This occurs when Glance knows where the image data is located.

• image.send

  Emitted upon completion of an image being sent to a consumer.

• image.update

  Emitted when an image record is updated in Glance.

• image.delete

  Emitted when an image deleted from Glance.

• task.create

  Emitted when a new task is created.

• task.delete

  Emitted when a task is deleted.

• task.run

  Emitted when a task is picked up by the executor to be run.

• task.processing

  Emitted when a task is sent over to the executor to begin processing.

• task.success

  Emitted when a task is successfully completed.

• task.failure

  Emitted when a task fails.

• image.member.create

  Emitted when an image member is created (member added to an image).

• image.member.update

  Emitted when an image member is updated (e.g. status change).

• image.member.delete

  Emitted when an image member is removed from an image.

• metadef_namespace.create

  Emitted when a metadata definition namespace is created.

• metadef_namespace.update

  Emitted when a metadata definition namespace is updated.

• metadef_namespace.delete

  Emitted when a metadata definition namespace is deleted.

• metadef_namespace.delete_objects

  Emitted when all objects in a metadata definition namespace are deleted.

• metadef_namespace.delete_properties

  Emitted when all properties in a metadata definition namespace are deleted.

• metadef_namespace.delete_tags

  Emitted when all tags in a metadata definition namespace are deleted.

• metadef_object.create

  Emitted when a metadata definition object is created.

• metadef_object.update

  Emitted when a metadata definition object is updated.

• metadef_object.delete

  Emitted when a metadata definition object is deleted.

• metadef_property.create

  Emitted when a metadata definition property is created.

• metadef_property.update

  Emitted when a metadata definition property is updated.

• metadef_property.delete

  Emitted when a metadata definition property is deleted.

• metadef_resource_type.create

  Emitted when a metadata definition resource type is created or associated with a namespace.

• metadef_resource_type.delete

  Emitted when a metadata definition resource type association is deleted.

• metadef_tag.create

  Emitted when a metadata definition tag is created.

• metadef_tag.update

  Emitted when a metadata definition tag is updated.

• metadef_tag.delete

  Emitted when a metadata definition tag is deleted.

Content

Every message contains a handful of attributes.

• message_id

  UUID identifying the message.

• publisher_id

  The hostname of the glance instance that generated the message.

• event_type

  Event that generated the message.

• priority

  One of WARN, INFO or ERROR.

• timestamp

  UTC timestamp of when event was generated.

• payload

  Data specific to the event type.

Payload

• image.send

  The payload for INFO, WARN, and ERROR events contain the following:

  image_id

  ID of the image (UUID)

  owner_id

  Tenant or User ID that owns this image (string)

  receiver_tenant_id

  Tenant ID of the account receiving the image (string)

  receiver_user_id

  User ID of the account receiving the image (string)

  destination_ip

  The receiver’s IP address to which the image was sent (string)

  bytes_sent

  The number of bytes actually sent

• image.create

  For INFO events, it is the image metadata. WARN and ERROR events contain a text message in the payload.

• image.prepare

  For INFO events, it is the image metadata. WARN and ERROR events contain a text message in the payload.

• image.upload

  For INFO events, it is the image metadata. WARN and ERROR events contain a text message in the payload.

• image.activate

  For INFO events, it is the image metadata. WARN and ERROR events contain a text message in the payload.

• image.update

  For INFO events, it is the image metadata. WARN and ERROR events contain a text message in the payload.

• image.delete

  For INFO events, it is the image id. WARN and ERROR events contain a text message in the payload.

• task.create

  For INFO events, it is the task dict with result and message as None. WARN and ERROR events contain a text message in the payload.

• task.delete

  For INFO events, it is the task dict with deleted set to True and deleted_at set to the deletion timestamp. WARN and ERROR events contain a text message in the payload.

• task.run

  The payload for INFO, WARN, and ERROR events contain the following:

  task_id

  ID of the task (UUID)

  owner

  Tenant or User ID that created this task (string)

  task_type

  Type of the task. Example, task_type is “import”. (string)

  status,

  status of the task. Status can be “pending”, “processing”, “success” or “failure”. (string)

  task_input

  Input provided by the user when attempting to create a task. (dict)

  result

  Resulting output from a successful task. (dict)

  message

  Message shown in the task if it fails. None if task succeeds. (string)

  expires_at

  UTC time at which the task would not be visible to the user. (string)

  created_at

  UTC time at which the task was created. (string)

  updated_at

  UTC time at which the task was latest updated. (string)

  The exceptions are:-

  For INFO events, it is the task dict with result and message as None. WARN and ERROR events contain a text message in the payload.

• task.processing

  For INFO events, it is the task dict with result and message as None. WARN and ERROR events contain a text message in the payload.

• task.success

  For INFO events, it is the task dict with message as None and result is a dict. WARN and ERROR events contain a text message in the payload.

• task.failure

  For INFO events, it is the task dict with result as None and message is text. WARN and ERROR events contain a text message in the payload.

• image.member.create

  For INFO events, it is the image member metadata (e.g. image_id, member_id, status, created_at, updated_at). WARN and ERROR events contain a text message in the payload.

• image.member.update

  For INFO events, it is the image member metadata. WARN and ERROR events contain a text message in the payload.

• image.member.delete

  For INFO events, it is the image member metadata. WARN and ERROR events contain a text message in the payload.

• metadef_namespace.create

• metadef_namespace.update

• metadef_namespace.delete

• metadef_namespace.delete_objects

• metadef_namespace.delete_properties

• metadef_namespace.delete_tags

  For INFO events, the payload is the relevant metadata definition namespace or operation context (e.g. namespace, display_name, visibility, created_at, updated_at). WARN and ERROR events contain a text message in the payload.

• metadef_object.create

• metadef_object.update

• metadef_object.delete

  For INFO events, the payload is the metadata definition object (e.g. namespace, name, description, properties). WARN and ERROR events contain a text message in the payload.

• metadef_property.create

• metadef_property.update

• metadef_property.delete

  For INFO events, the payload is the metadata definition property (e.g. namespace, name, type, title, description). WARN and ERROR events contain a text message in the payload.

• metadef_resource_type.create

• metadef_resource_type.delete

  For INFO events, the payload is the metadata definition resource type or association (e.g. namespace, name, prefix, properties_target). WARN and ERROR events contain a text message in the payload.

• metadef_tag.create

• metadef_tag.update

• metadef_tag.delete

  For INFO events, the payload is the metadata definition tag (e.g. namespace, name, created_at, updated_at). WARN and ERROR events contain a text message in the payload.