2013-05-17 18:48:55 +01:00
|
|
|
|
|
|
|
# Copyright 2011 OpenStack Foundation.
|
|
|
|
# All Rights Reserved.
|
|
|
|
# Copyright 2013 Red Hat, Inc.
|
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
|
|
# not use this file except in compliance with the License. You may obtain
|
|
|
|
# a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
# License for the specific language governing permissions and limitations
|
|
|
|
# under the License.
|
|
|
|
|
2016-09-11 21:07:02 -04:00
|
|
|
"""
|
|
|
|
Notification drivers for sending notifications via messaging.
|
|
|
|
|
|
|
|
The messaging drivers publish notification messages to notification
|
|
|
|
listeners.
|
|
|
|
|
2021-11-23 16:58:05 +01:00
|
|
|
In case of the rabbit backend the driver will block the notifier's thread
|
|
|
|
until the notification message has been passed to the messaging transport.
|
|
|
|
There is no guarantee that the notification message will be consumed by a
|
|
|
|
notification listener.
|
|
|
|
|
|
|
|
In case of the kafka backend the driver will not block the notifier's thread
|
|
|
|
but return immediately. The driver will try to deliver the message in the
|
|
|
|
background.
|
2016-09-11 21:07:02 -04:00
|
|
|
|
|
|
|
Notification messages are sent 'at-most-once' - ensuring that they are not
|
|
|
|
duplicated.
|
|
|
|
|
|
|
|
If the connection to the messaging service is not active when a notification is
|
2021-11-23 16:58:05 +01:00
|
|
|
sent the rabbit backend will block waiting for the connection to complete.
|
|
|
|
If the connection fails to complete, the driver will try to re-establish that
|
2016-09-11 21:07:02 -04:00
|
|
|
connection. By default this will continue indefinitely until the connection
|
|
|
|
completes. However, the retry parameter can be used to have the notification
|
2021-11-23 16:58:05 +01:00
|
|
|
send fail. In this case an error is logged and the notifier's thread is resumed
|
|
|
|
without any error.
|
|
|
|
|
|
|
|
If the connection to the messaging service is not active when a notification is
|
|
|
|
sent the kafka backend will return immediately and the backend tries to
|
|
|
|
establish the connection and deliver the messages in the background.
|
|
|
|
|
2016-09-11 21:07:02 -04:00
|
|
|
"""
|
|
|
|
|
2013-06-16 12:30:49 +01:00
|
|
|
import logging
|
|
|
|
|
2015-01-02 14:24:57 -05:00
|
|
|
import oslo_messaging
|
|
|
|
from oslo_messaging.notify import notifier
|
2013-05-17 18:48:55 +01:00
|
|
|
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
|
|
|
|
|
|
|
2015-09-24 11:20:35 -04:00
|
|
|
class MessagingDriver(notifier.Driver):
|
2013-05-17 18:48:55 +01:00
|
|
|
|
2013-06-23 13:21:42 +01:00
|
|
|
"""Send notifications using the 1.0 message format.
|
|
|
|
|
|
|
|
This driver sends notifications over the configured messaging transport,
|
|
|
|
but without any message envelope (also known as message format 1.0).
|
|
|
|
|
|
|
|
This driver should only be used in cases where there are existing consumers
|
|
|
|
deployed which do not support the 2.0 message format.
|
|
|
|
"""
|
|
|
|
|
2013-08-01 23:32:17 +01:00
|
|
|
def __init__(self, conf, topics, transport, version=1.0):
|
2013-05-17 18:48:55 +01:00
|
|
|
super(MessagingDriver, self).__init__(conf, topics, transport)
|
2013-08-01 23:32:17 +01:00
|
|
|
self.version = version
|
2013-05-17 18:48:55 +01:00
|
|
|
|
2014-05-06 13:47:12 +02:00
|
|
|
def notify(self, ctxt, message, priority, retry):
|
2013-06-24 12:02:46 +01:00
|
|
|
priority = priority.lower()
|
2013-05-17 18:48:55 +01:00
|
|
|
for topic in self.topics:
|
2015-01-02 14:24:57 -05:00
|
|
|
target = oslo_messaging.Target(topic='%s.%s' % (topic, priority))
|
2013-05-17 18:48:55 +01:00
|
|
|
try:
|
2013-08-01 23:32:17 +01:00
|
|
|
self.transport._send_notification(target, ctxt, message,
|
2014-05-06 13:47:12 +02:00
|
|
|
version=self.version,
|
|
|
|
retry=retry)
|
2013-05-17 18:48:55 +01:00
|
|
|
except Exception:
|
2019-04-11 10:47:24 +02:00
|
|
|
LOG.exception("Could not send notification to %(topic)s. "
|
|
|
|
"Payload=%(message)s",
|
|
|
|
{'topic': topic, 'message': message})
|
2013-05-17 18:48:55 +01:00
|
|
|
|
|
|
|
|
|
|
|
class MessagingV2Driver(MessagingDriver):
|
|
|
|
|
2013-06-23 13:21:42 +01:00
|
|
|
"Send notifications using the 2.0 message format."
|
|
|
|
|
2013-05-17 18:48:55 +01:00
|
|
|
def __init__(self, conf, **kwargs):
|
2013-08-01 23:32:17 +01:00
|
|
|
super(MessagingV2Driver, self).__init__(conf, version=2.0, **kwargs)
|