Skip to content

Event subscription⚓︎

Info

This page contains superficial documentation for the Event Subscription feature. If you are an developer or want more technical insights, please read the developer documentation.

This feature allows you to manage your access credentials for integrating our message queues into your systems. Furthermore, you can use it to subscribe to specific events from your fleet, in order to utilize the data for your own applications. Event Subscription is located in Administration > Event Subscription. The Event Subscription permission is required to access this feature.

Consumers⚓︎

A consumer contains a set of topics, that you can subscribe and unsubscribe to and from. Each topic describes a set of events. Subscribing to a topic creates a message queue that you can consume the topic’s events from. Use consumers to organize and administrate your subscribed topis. We recommend you create a consumer for each application consuming events.

Add new consumer⚓︎

To add a new consumer, select Add Consumer in the top left.

![Add consumer]Add consumer

Choose an appropriate name such as the application this consumer represents. Finally, select Confirm to create the consumer.

Choose name

Consumer states⚓︎

Consumers have states indicating problems with a topic or the entire consumer. Consumer states are visible in the top left, next to the consumer’s name. Note that a consumer without a status is operating normally. States only appear once a problem is detected.

States

Warnings⚓︎

The Warnings status indicates that one or more topics have reported problems. Open the consumer and check each topic for a Warnings status. To find out what the problem is, open the topic’s metrics. Read the Warnings box for information on problems and possible solutions.

Suspended⚓︎

Consumers showing the status Suspended have been deactivated by INVERS. This is done when a consumer places extreme loads on our message queues. Contact INVERS support to have the consumer reactivated.

Actions⚓︎

With a consumer open, you can execute Actions from the drop-down menu on the top right.

Actions

Edit name⚓︎

Use this action to change the name of your consumer.

Delete⚓︎

Use this action to delete a consumer.

Topics⚓︎

Topics are sets of events that you can consume via a message queue. To start consuming events, you first have to subscribe to the topic. Additionally, you have to set up an application that consumes the events sent in the message queue.

Subscriptions⚓︎

To subscribe to a topic, open a consumer from the left. Under Topics on the right, tick the boxes of all topics you would like to subscribe to. Finally, select Change Subscriptions, verify your changes and press Confirm.

When you unsubscribe from a topic that you were previously consuming events from, all events in the message queue are deleted and you will no longer receive any events belonging to this topic.

Metrics⚓︎

While you are subscribed to a topic, you can select Metrics in its row to see the status of the topic’s message queue. The following metrics are available:

Events ready

The number of events that were added to the message queue in the last 15 minutes but not yet consumed.

Events unacked

The number of events that were not yet acknowledged by the consuming application.

Consumers

The number of consumers that are subscribed to this topic.

Events redelivered rate

The ratio of events that were negatively acknowledged by your consuming application.

Events unacked rate

The ratio of events that were not yet acknowledged by the consuming application.

Consumer utilisation

The percentage of events your consuming applications are able to process.