Events

Event messages provide a way to send messages from a device to your application via Bosch IoT Hub with guaranteed delivery.

An IoT device sends an event message to the Bosch IoT Hub using an IoT protocol. The message will be queued to the persistent internal messaging infrastructure and an acknowledgement will be sent to the device. The application receives the message via the messaging endpoint of Bosch IoT Hub.

Bosch IoT Hub Events Communication Pattern for Event messages

Properties

Event messages provide a way to send messages from a device to an application with guaranteed delivery. Due to the fact that Bosch IoT Hub provides a message acknowledgement to the IoT device and it will queue up all messages until the application is ready to consume them, a message loss might only happen under unforeseen conditions.

There might be the case that messages queues in Bosch IoT Hub run full. E.g. the application might be down for maintenance or might be to slow to process all messages in time. Then Bosch IoT Hub will not accept any further event messages from devices. Depending on your use-case the device must take care of this situation and perform a retry or queue up events for later delivery.

Event messages are set with a time to live (TTL) that represents the storage time of the event. Events which are not consumed within the TTL will be discarded from the persistent storage. The storage time of the persisted messages varies depending on your service plan.

When to use events?

Events are the communication pattern of choice if reliability is crucial for your business or functional requirements. Due to the involved overhead for assured delivery and reliable processing and queuing this approach has drawbacks considering latency and throughput.

A typical example for event messages is a fire alarm. This type of incident will happen only very rarely. But if it happens it’s absolutely crucial that the message is send and processed successfully.

Delivery Modes

  • QoS1 AT_LEAST_ONCE

Provides guaranteed delivery, messages are either acknowledged or rejected. Bosch IoT Hub persists the event messages on highly durable storage which will even endure large-scale outages or disasters in the cloud datacenter. On the application side reliable protocols are used and messages will only be removed from the queues if the application has acknowledged its receipt. As the name states there might be more that one delivery of a message - the application must be capable of handling duplicate deliveries.

This does not provide confirmation of end-to-end delivery. That means that the device will see a successful post of the event even though the application has not yet received or processed the message. There might be the situation that the application is not online at this very point of time. In this case the Bosch IoT Hub will hold all messages available until the application is operational again and starts processing the persisted messages.