Hubs

Overview

Hubs provide features such as message brokering, Device authentication, Networks and Routes.

Devices and services can exchange messages when connected to the same Hub.

You can enable and disable your Hub anytime. When disabled, all Devices will be disconnected and the Hub will not be billed.

Plans

There are three IoT Hub plans available:

• Shared: this plan allows you to start using IoT Hub for free, on a shared message broker while still isolated from other users.
• Dedicated: with this plan, your Hub is located on a dedicated message broker with its own resources.
• High-availability (HA): your Hub is backed by a pair of dedicated message brokers, making sure your projects run on a resilient structure.

Certificate Authority

When you create a Hub, it comes with a Scaleway-generated Certificate Authority. The Hub Certificate Authority is used to authenticate connecting devices through mutual TLS authentication.

If you wish, you can replace the Hub’s certificate authority with your own. Your Device certificates will then have to be signed by this new authority.

Auto-Provisioning

Auto-provisioning happens when an unknown Device with a valid certificate (signed by the Hub’s certificate authority) connects to the Hub for the first time. The Device is authenticated and automatically added to the Hub’s Device list.

This feature can be enabled and disabled in the Hub Overview tab of the console.

A Hub event is sent every time a Device is auto-provisioned.

Events

Your IoT Hub generates Events when incidents that require your attention happen. These can be Devices violating the security policies you defined or routes with invalid targets, for example.

When such Events happen, the Hub publishes a message on itself. The topic of the message depends on the event itself, and on a prefix you previously configured. You can receive Events by subscribing to these topics.

Events can be enabled and disabled in the Hub Overview tab of the console. The prefixes can also be configured from the Overview tab.

Event messages will be published using topics under the prefix/source/identifier/severity format, where:

• prefix is the prefix you configured
• source tells which resource type triggered the event (hub, device, route, …)
• identifier is the resource identifier (hub ID, device ID, route ID, …)
• severity tells how important the event is (info, warning, error, …)

Metrics

Hubs generate 2 usage metrics:

• Message count: tells you how many messages are transited through your Hub. Any MQTT message, whether it is a data or a control message, is counted as a Hub message.
• Active devices: tells you how many different Devices have been connected to your Hub.

All metrics are provided within 5 available ranges:

• last 60 minutes: 1 per minute
• last 24 hours: 1 per hour
• last 7 days: 1 per 4 hours
• last 30 days: 1 per day
• last 365 days: 1 per month

The Hub metrics are available in the Hub Metrics tab of the console.

Limits and quotas

(1) Hub reserved memory is the total memory reserved per Hub to store the retained, in-flight and will messages.