glance/doc/source/notifications.rst
annegentle a2b9bed75d Updates OpenStack LLC with OpenStack Foundation
Patchset addresses reviewer's comments, rebase against master,
and follows new guidance from Foundation:
http://wiki.openstack.org/Documentation/Copyright

Change-Id: I94367461505778973528eb8835d991f4fb796dab
2013-02-17 19:19:43 -08:00

2.5 KiB

Notifications

Notifications can be generated for each send, upload, update or delete image event. These can be used for auditing, troubleshooting, etc.

Strategies

  • logging

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

  • rabbit

    This strategy sends notifications to a rabbitmq queue. This can then be processed by other services or applications.

  • qpid

    This strategy is similar to rabbit. It sends notifications to an AMQP message queue via Qpid.

  • noop

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

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 bytes_sent - The number of bytes actually sent

  • image.upload

    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.