Cette page s’adresse aux personnes qui planifient ou exploitent une installation comptant de nombreux appareils : des centaines, voire des milliers, dans une même organisation. Elle explique les limites qui s’appliquent à l’organisation dans son ensemble, comment éviter que tous les appareils ne se connectent ou ne remontent leurs données dans la même seconde, et comment modifier de nombreux appareils en toute sécurité. Chaque fonctionnalité a sa propre page ; cette page renvoie vers elles au lieu de les répéter.
Limites qui s’appliquent à l’ensemble de l’organisation
Chaque appareil dispose de ses propres limites de débit définies par son profil d’appareil (voir Profils d’appareils). Votre forfait ajoute des limites pour l’organisation dans son ensemble. Avec de nombreux appareils, ce sont généralement celles que vous atteignez en premier.
| Limite | Ce qui se passe lorsqu’elle est atteinte |
|---|---|
| Appareils | Un nouvel appareil est refusé, quelle que soit la manière de l’ajouter : Nouvel appareil, import, revendication, auto-enregistrement ou passerelle annonçant un nouvel enfant. Les appareils en quarantaine sont comptés. Les appareils existants continuent de fonctionner. |
| Messages par seconde, points de données par minute | Les messages au-delà de la limite sont acquittés puis rejetés. En HTTP, la réponse est 429 avec un en-tête Retry-After. La connexion reste ouverte : une limite d’organisation ne déconnecte jamais un appareil. Les propriétaires et administrateurs reçoivent au plus une notification par heure. |
| Appareils connectés simultanément (uniquement si votre forfait le prévoit) | Une nouvelle connexion est refusée avec CONNACK 5. Un appareil qui se reconnecte, ou qui reprend sa propre session, n’est pas compté deux fois. |
| Messages par mois | Rien n’est bloqué. Les messages au-delà du quota sont acceptés et facturés en dépassement. |
Les valeurs de votre forfait figurent sur Forfaits et option IoT et Limites et quotas. Le décompte mensuel se trouve sur la page Utilisation ; voir Utilisation et quotas et Quota de messages et utilisation.
Répartir les remontées dans le temps
Les messages par seconde de l’organisation sont comptés dans des fenêtres d’une seconde, et non en moyenne. Six cents appareils qui remontent chacun une fois par minute produisent en moyenne 10 messages par seconde. S’ils remontent tous à la seconde 0 de la minute, 600 messages arrivent dans la même seconde, et chaque message au-delà de la limite par seconde de l’organisation est rejeté.
- Attribuez à chaque appareil son propre décalage à l’intérieur de son intervalle de remontée, choisi une fois pour toutes (par exemple dérivé de son numéro de série), au lieu de remonter à la minute ou à l’heure pleine de l’horloge.
- Regroupez les mesures. Un message contenant plusieurs enregistrements compte pour un seul message ; des messages séparés comptent chacun pour un. Les points de données sont toujours comptés par valeur.
- Gardez à l’esprit les limites par appareil lorsque des données mises en mémoire tampon sont envoyées après une panne. Les mesures rejouées doivent aussi respecter le débit de rejeu du profil, qui vaut par défaut la moitié de la limite de télémétrie par seconde. Voir MQTT.
Échelonner les connexions
De nombreux appareils se connectent au même moment après une coupure de courant sur un site, une panne réseau ou un déploiement de firmware qui redémarre une vague d’appareils. Hermetry se protège contre les inondations de connexions, et les mêmes protections ralentissent les appareils qui arrivent tous en même temps.
| Protection (valeurs par défaut) | Ce que voit l’appareil |
|---|---|
| Sur chaque nœud de broker, 64 connexions au maximum depuis une même adresse publique peuvent être en cours d’authentification au même moment (256 depuis un même réseau /24 IPv4 ou /48 IPv6) | Les connexions supplémentaires sont fermées immédiatement, avant la négociation TLS |
| Une connexion doit terminer TLS et s’authentifier dans un délai de 5 secondes | La connexion est fermée |
| Plus de 10 échecs de connexion (jeton ou mot de passe incorrect) depuis une même adresse en 5 minutes bloquent cette adresse pendant 60 secondes | CONNACK 3, ou connexion fermée, pour chaque appareil derrière cette adresse |
| Un appareil dont la session est reprise plus de 5 fois en 60 secondes depuis deux réseaux différents | Le réseau le plus récent reçoit CONNACK 3 pendant 60 secondes |
| La plateforme n’est pas prête, ou est sous charge et retient les organisations qui envoient bien plus que leur part | CONNACK 3 (HTTP 503) ; les appareils connectés sont ralentis, et non déconnectés, et conservent leurs données |
Bonnes pratiques :
- Attendez un délai aléatoire de 0 à 30 secondes avant la première connexion après un démarrage ou une mise à jour du firmware. Une vague entière d’appareils n’arrive ainsi pas en un seul pic.
- Temporisez avec de la gigue (jitter) à chaque connexion refusée ou perdue. Les calendriers sont décrits sur Reconnexion et temporisation.
- Corrigez rapidement les identifiants erronés. Derrière une même adresse NAT, quelques appareils mal configurés peuvent faire bloquer l’adresse pour tous les appareils qui s’y trouvent.
- Donnez à chaque appareil son propre identifiant. Deux appareils partageant un même identifiant se disputent la session ; voir Identifiants des appareils.
- Surveillez l’onglet Journal de quelques appareils après une reconnexion massive : il affiche chaque refus et chaque déconnexion avec sa raison.
Ajouter des appareils en masse
Ajoutez de nombreux appareils à partir d’un fichier CSV sur la page Imports. Un fichier contient jusqu’à 1 000 lignes. La limite d’appareils de votre forfait est vérifiée pour l’ensemble du fichier avant toute écriture ; un fichier qui ne rentre pas est donc refusé en totalité.
Les jetons d’accès et mots de passe MQTT des nouveaux appareils sont proposés une seule fois, dans un seul fichier, pendant 15 minutes après l’import, et uniquement à la personne qui l’a lancé. Décidez avant l’import comment ces identifiants parviendront aux appareils. Les étapes sont décrites dans Importer des appareils en masse.
Les appareils qui s’enregistrent eux-mêmes avec une clé de provisionnement d’un profil sont placés en quarantaine et comptent dans votre limite d’appareils pendant leur attente. Pour les appareils fabriqués en volume, privilégiez les appareils pré-provisionnés. Voir Quarantaine des appareils auto-enregistrés et Ajouter et revendiquer des appareils.
Déployer le firmware par vagues
Une affectation à tous les appareils d’un profil, ou à une liste d’appareils, peut être envoyée par vagues : d’abord une petite vague test (canari) d’appareils en ligne, puis des vagues plus grandes, chacune avec un seuil de succès et un temps d’attente. Le déploiement se met en pause automatiquement lorsqu’une vague se dégrade au-delà de ce que vous autorisez. Voir Déploiement du firmware par vagues.
- Testez d’abord une nouvelle image sur quelques appareils que vous pouvez atteindre physiquement, avec les affectations One device.
- Conservez un temps d’attente suffisamment long pour que les problèmes apparaissent. Un appareil qui redémarre en boucle a besoin de temps pour échouer.
- Chaque appareil d’une vague redémarre après l’installation et se reconnecte. Le délai de démarrage aléatoire du firmware (ci-dessus) évite que cela ne devienne un pic unique.
- Les appareils sur des liaisons facturées à l’usage peuvent attendre au lieu de se mettre à jour. Ils ne comptent pas comme échecs à la clôture d’une vague.
Modifier les réglages par vagues
Les appareils qui acceptent des réglages à distance sont modifiés en masse à l’aide d’une référence (baseline) et d’une tâche de réglages. Une tâche fonctionne aussi par vagues avec un seuil de succès. Voir Réglages à distance des appareils et Bonnes pratiques pour les réglages à distance.
| Limite | Valeur |
|---|---|
| Tâches en cours ou en pause simultanément | 5 par organisation |
| Appareils dans une tâche | 5,000 |
| Appareils auxquels une tâche envoie des modifications par minute | 200 |
| Vagues par défaut | 1 %, puis 10 %, puis le reste |
| Modifications de réglages uniques (onglet Réglages et API) | 600 par minute et par organisation |
La première vague d’une tâche de réglages est une coupe aléatoire fixe des appareils sélectionnés, et non les appareils en ligne en premier. Ses appareils ne répondent que lorsqu’ils sont en ligne ; lancez donc une tâche lorsque la plupart d’entre eux sont connectés.
Avant de monter en charge
- Vérifiez les limites de votre forfait en nombre d’appareils, de débit de messages et d’appareils connectés par rapport au nombre d’appareils et à la fréquence de remontée de chacun.
- Assurez-vous que le firmware répartit ses remontées, attend un délai aléatoire avant sa première connexion et temporise avec de la gigue (jitter).
- Réglez les limites de débit des profils d’appareils sur ce que les appareils envoient réellement, avec une marge.
- Réglez les seuils d’alerte de quota sur la page Usage, et abonnez-vous aux webhooks
usage.thresholdetusage.overagesi vos propres systèmes doivent en être informés. - Planifiez les changements de firmware et de réglages par vagues, en commençant par les appareils que vous pouvez atteindre.

