Diagnostiquer et résoudre les problèmes dans votre environnement Azure Time Series Insights Gen1
Remarque
Le service Time Series Insights va être mis hors service le 7 juillet 2024. Prévoyez de migrer les environnements existants vers des solutions alternatives dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.
Attention
Il s’agit d’un article Gen1.
Cet article décrit les problèmes que vous pouvez rencontrer dans votre environnement Azure Time Series Insights. Il présente les causes éventuelles et les solutions pour les résoudre.
Vidéo
En savoir plus sur les atténuations et les défis courants d’Azure Time Series Insights
Problème : aucune donnée n’est affichée
Si aucune donnée n’apparaît dans l’Explorateur Azure Time Series Insights, examinez ces causes courantes.
Raison A : les données sources de l’événement ne sont pas au format JSON
Azure Time Series Insights ne prend en charge que les données JSON. Pour obtenir des exemples de données JSON, consultez Structures JSON prises en charge.
Raison B : il manque une autorisation nécessaire pour la clé de la source de l’événement
Pour un hub IoT dans Azure IoT Hub, vous devez fournir la clé qui dispose des autorisations de connexion de service. Sélectionnez la stratégie iothubowner ou service. Les deux disposent d’autorisations de connexion de service.
Pour un Event Hub dans Azure Event Hubs, vous devez fournir la clé disposant des autorisations d’écoute. Les stratégies read et manage fonctionnent toutes les deux, car elles disposent toutes deux d’autorisations d’écoute.
Raison C : le groupe de consommateurs fourni n’est pas exclusif à Azure Time Series Insights
Lorsque vous inscrivez un hub IoT ou un Event Hub, il est important de définir le groupe de consommateurs que vous souhaitez utiliser pour lire les données. Ce groupe de consommateurs ne peut pas être partagé. Si le groupe de consommateurs est partagé, le hub IoT ou l’Event Hub sous-jacent déconnecte de manière automatique et aléatoire l’un des lecteurs. Fournissez un groupe de consommateurs unique auprès duquel Azure Time Series Insights lira les informations.
Raison D : l’environnement vient d’être approvisionné
Les données s’afficheront dans votre explorateur Azure Time Series Insights quelques minutes après la création initiale de l’environnement et de ses données.
Problème : certaines données sont affichées, mais d’autres sont manquantes
Lorsque les données n’apparaissent que partiellement et qu’elles semblent avoir du retard, examinez ces possibles problèmes.
Raison A : votre environnement est sujet à des limitations
La limitation est un problème courant lors du provisionnement des environnements après la création d’une source d’événement qui comporte des données. Azure IoT Hub et Azure Events Hubs stockent les données jusqu’à sept jours. Azure Time Series Insights commence toujours par l’événement le plus ancien dans la source de l’événement (premier entré, premier sorti ou FIFO).
Par exemple, si 5 millions d’événements se trouvent dans une source de l’événement lorsque vous vous connectez à un S1 (environnement Azure Time Series Insights à une unité), Azure Time Series Insights lit environ 1 million d’événements par jour. Azure Time Series Insights peut donc subir cinq jours de latence. En réalité, l’environnement est limité.
Si votre source de l’événement comporte des événements antérieurs, vous pouvez aborder la limitation de l’une des deux façons suivantes :
- Modifiez les limites de rétention de votre source de l’événement pour vous débarrasser des anciens événements que vous ne souhaitez pas voir apparaître dans Azure Time Series Insights.
- Configurez une plus grande taille d’environnement (nombre d’unités) pour augmenter le débit des anciens événements. Dans l’exemple précédent, si vous augmentez l’environnement S1 à cinq unités pendant un jour, l’environnement doit rattraper le retard en un seul jour. Si votre production d’événement stable compte un million d’événements par jour maximum, vous pouvez réduire la capacité d’événements à une unité après qu’Azure Time Series Insights ait rattrapé son retard.
Les limitations sont appliquées en fonction de la capacité et du type de référence SKU de l’environnement. Cette capacité est répartie entre les différentes sources d’événements de l’environnement. Si la source d’événements pour votre hub IoT/Event Hub envoie des données au-delà des limites définies, vous allez constater un ralentissement et un décalage.
La figure suivante montre un environnement Azure Time Series Insights ayant une référence SKU S1 et une capacité de 3 unités. Cet environnement peut recevoir 3 millions d’événements par jour.
Supposons qu’un environnement ingère les messages à partir d’un Event Hub. Il a un taux d’entrée quotidien d’environ 67 000 messages. Cela représente environ 46 messages par minute.
- Si chaque message de l’Event Hub est aplati dans un seul événement Azure Time Series Insights, aucune limitation ne se produit.
- Si chaque message de l’Event Hub est aplati dans 100 événements Azure Time Series Insights, 4 600 événements devraient être ingérés toutes les minutes.
Un environnement de référence SKU S1 qui a une capacité de 3 unités peut seulement ingérer 2 100 événements toutes les minutes (1 million d’événements par jour = 700 événements par minute à 3 unités = 2 100 événements par minute).
Pour en savoir plus sur le fonctionnement de la logique de mise à plat, consultez Structures JSON prises en charge.
Résolutions recommandées en cas de limitation excessive
Pour éviter tout décalage, augmentez la capacité de votre environnement. Pour plus d’informations, consultez Mettre à l’échelle votre environnement Azure Time Series Insights.
Raison B : l’ingestion initiale de données d’historique ralentit l’entrée
Si vous vous connectez à une source de l’événement existante, il est probable que votre hub IoT ou votre Event Hub comporte déjà des données. L’environnement démarre l’extraction des données depuis le début de la période de rétention des messages de la source d’événement. Ce traitement par défaut ne peut pas être remplacé. Vous pouvez appliquer des limitations. La limitation peut prendre un certain temps en ce qui concerne le rattrapage, car elle ingère les données d’historique.
Résolutions recommandées en cas d’ingestion initiale volumineuse
Pour corriger le décalage :
Définissez la capacité de référence SKU sur la valeur maximale autorisée (10 unités dans ce cas). Après augmentation de la capacité, le processus d’entrée commence à rattraper le retard beaucoup plus rapidement. L’augmentation de capacité occasionne des frais supplémentaires. Pour suivre sa progression rapide, consultez le graphique de disponibilité dans l’explorateur Azure Time Series Insights.
Une fois le retard rattrapé, rétablissez la capacité de référence SKU sur votre taux d’entrée normal.
Problème : les données étaient affichées précédemment, mais ne le sont plus
Si Azure Time Series Insights n’ingère plus les données, mais que les événements sont toujours diffusés en continu dans IoT Hub ou Event Hub, considérez cette cause potentielle.
Raison A : la clé d’accès de votre hub a été régénérée et votre environnement doit être mis à jour
Ce problème se produit lorsque la clé fournie lors de la création de votre source d’événements n’est plus valide. Vous pouvez voir les données de télémétrie dans votre hub, mais aucun message n’a été reçu en entrée dans Azure Time Series Insights. Si vous ne savez pas si la clé a été générée à nouveau, vous pouvez rechercher « Créer ou mettre à jour des règles d’autorisation d’espace de noms » dans le journal d’activité de votre hub d’événements ou « Créer ou mettre à jour une ressource IotHub » pour un hub IoT.
Pour mettre à jour votre environnement Azure Time Series Insights avec la nouvelle clé, ouvrez votre ressource de hub dans le Portail Azure et copiez la nouvelle clé. Accédez à votre ressource Azure Time Series Insights et sélectionnez Sources d’événements :
Sélectionnez la ou les sources d’événements à partir desquelles l’ingestion s’est arrêtée, collez la nouvelle clé, puis sélectionnez Enregistrer :
Problème : le paramètre nom de la propriété timestamp de la source de l’événement ne fonctionne pas
Vérifiez que la valeur de la propriété timestamp provenant de votre source d’événement, comme une chaîne JSON, est au format aaaa-MM-jjTHH:mm:ss.FFFFFFFK. Voici un exemple : 2008-04-12T12:53Z.
N’oubliez pas que le nom de la propriété timestamp est sensible à la casse.
La méthode la plus simple pour vous assurer que votre nom de propriété timestamp est capturé et fonctionne correctement consiste à utiliser l’explorateur Azure Time Series Insights. Dans l’explorateur Azure Time Series Insights, à l’aide du graphique, sélectionnez une période de temps spécifique après avoir indiqué le nom de la propriété timestamp. Cliquez avec le bouton droit sur la sélection, puis sélectionnez Explorer les événements.
Le premier en-tête de colonne doit correspondre au nom de votre propriété timestamp. À côté du mot Horodatage est affiché ($ts).
Les valeurs suivantes ne seront pas affichées :
- (abc) : indique qu’Azure Time Series Insights lit les valeurs de données sous forme de chaînes.
- Icône calendrier : indique qu’Azure Time Series Insights lit les valeurs de données en tant que valeurs DateHeure.
- # : indique qu’Azure Time Series Insights lit les valeurs de données sous forme d’entiers.