glance/doc/source/notifications.rst
Russell Bryant 2fa1ed0da1 Implement blueprint add-qpid-support.
This patch implements a new notification strategy that sends
notifications to a message queue via Qpid.

Change-Id: Ie2640139dcf735e428af63e9e87b3667a2b22eb5
2012-02-10 15:36:13 -05: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.