@@ -203,6 +203,23 @@ changes can control the behaviour.
203
203
204
204
#. Restart the Management Server.
205
205
206
+ #. CloudStack creates the exchange ‘cloudstack-events’ which will receive messages containing CloudStack events; however will be no queues created.
207
+
208
+ To create a queue and bind with cloudstack-events the following steps are needed:
209
+
210
+ - Go to Queues tab and add a queue, e.g. 'cloudstack-queue’
211
+ - Go to Exchanges tab and Bind to queue cloudstack-queue with the desired ‘Routing key’.
212
+
213
+
214
+ #. Routing keys
215
+
216
+ The routing key is a list of words, delimited by a period ("."). CloudStack builds routing keys according to each event type, some examples are:
217
+
218
+ Some example of routing keys that match CloudStack events:
219
+ - A pound symbol (“#”) indicates a match on zero or more words; thus, it will match any possible set of words;
220
+ - Asterisk (“*”) matching any word and the period (“.”) delimiting example '\* .*.*.*.*'
221
+
222
+
206
223
Kafka Configuration
207
224
~~~~~~~~~~~~~~~~~~~
208
225
@@ -214,7 +231,20 @@ changes can control the behaviour.
214
231
which contains valid kafka configuration properties as documented in http://kafka.apache.org/documentation.html#newproducerconfigs
215
232
The properties may contain an additional ``topic `` property which if not provided will default to ``cloudstack ``.
216
233
While ``key.serializer `` and ``value.serializer `` are usually required for a producer to correctly start, they may be omitted and
217
- will default to ``org.apache.kafka.common.serialization.StringSerializer ``.
234
+ will default to ``org.apache.kafka.common.serialization.StringSerializer ``. A sample example which will be used by cloudstack for exporting of events
235
+
236
+ .. parsed-literal ::
237
+
238
+ cat /etc/cloudstack/management/kafka.producer.properties
239
+
240
+ bootstrap.servers=<localhost>:9092
241
+ acks=all
242
+ topic=cs
243
+ retries=1
244
+
245
+
246
+
247
+
218
248
219
249
#. Create the folder ``/etc/cloudstack/management/META-INF/cloudstack/core ``
220
250
0 commit comments