Event consumers

An event consumer tells INVERS which vehicle events to send to your tool and how to deliver them. When an event occurs — a rental ends, a fault lamp activates, a charging state changes — INVERS forwards it to the queue your tool is listening to.

To access this feature, go to Developers > Event Consumers in FleetControl.

Note

This page covers managing event consumers in FleetControl. If you’re setting up an automation tool to receive events, see Connect your automation tool. For full technical reference, see the INVERS Developer Docs.

Create an event consumer

1. Select Add Consumer.
2. Enter a name — for example, the name of the automation tool or workflow this consumer serves.
3. Enable the topics you want to subscribe to. Each topic is a category of events (for example, rental events, vehicle state updates, or maintenance events). For descriptions of each topic, see the event list in the Developer Docs.
4. Select Add to create the event consumer.

After creation, copy the consumer credentials (username and password). You’ll need them to configure your automation tool.

Keep the queue active during setup

A topic is automatically unsubscribed if no tool is connected and reading from it for three consecutive days. This can happen during implementation if you set up an event consumer but haven’t yet published or activated your workflow. If a topic gets unsubscribed, re-enable it under Change Subscriptions and reconnect your tool.

Change subscriptions

To change which topics an event consumer receives, select Change Subscriptions, toggle the topics on or off, and select Save.

Recognize consumer issues

Tags next to a consumer or topic name indicate a problem. No tag means the consumer is operating normally.

Warning

One or more topics have reported problems. Open the consumer and check each topic for a warning status. Select Show Metrics on the affected topic to see details and suggested solutions.

Suspended

The consumer has been deactivated by INVERS due to infrastructure impact. Contact support to reactivate it.

Not connected

No tool is currently connected to this queue. Check that the consumer credentials are correctly configured in your automation tool.

Topic metrics

Select Show Metrics on a topic to see the status of its queue.

Metric	Description
Events Ready	Events waiting to be received, including requeued events
Events Unacked	Events received but not yet acknowledged by your tool
Consumers	Number of active connections to this queue
Events Redelivered Rate	Rate of events being resent due to failed processing (events/second)
Events Unacked Rate	Rate of change in unacknowledged events over the past 15 minutes — values above 0 suggest your tool is processing too slowly
Consumer Utilisation	Percentage of time your tool was ready to receive new events (100% = no waiting)

More actions

To rename or delete an event consumer, select the consumer and choose … > Edit Name or Delete.