Résoudre les problèmes liés à Azure Stream Analytics à l’aide des journaux de ressources

Il arrive parfois qu’un travail Azure Stream Analytics s’arrête de manière inattendue. Les échecs peuvent être liés à un résultat de requête inattendu, à une mauvaise connectivité aux périphériques ou à un arrêt inattendu du service. Les journaux de ressources dans Azure Stream Analytics peuvent vous aider à identifier la cause de ces défaillances et à réduire le temps de récupération.

Activez les journaux de ressources pour tous les travaux Stream Analytics afin de faciliter le débogage et la surveillance.

Types de journaux Stream Analytics

Stream Analytics fournit deux types de journaux d’activité :

• Les journaux d’activité (activés en permanence) fournissent des détails sur les opérations effectuées sur les travaux.

• Les journaux de ressources (configurables) offrent des informations plus détaillées sur tous les événements liés à un travail. Les journaux de ressources enregistrent les événements entre le moment où le travail est créé et celui où le travail est supprimé. Ils consignent les événements qui se produisent lorsque le travail est mis à jour et lors de son exécution.

Déboguer des travaux Stream Analytics à l’aide des journaux d’activité

Les journaux d’activité sont activés par défaut et proposent des informations détaillées sur les opérations effectuées par votre travail Stream Analytics. Les informations présentes dans les journaux d’activité peuvent vous aider à trouver la cause racine des problèmes qui affectent votre travail. Pour utiliser les journaux d’activité dans Stream Analytics, procédez comme suit :

1. Connectez-vous au portail Azure et sélectionnez Journal d’activité sous Vue d’ensemble.

   

2. Vous pouvez consulter la liste des opérations effectuées. Toute opération ayant entraîné l’échec de votre travail est accompagnée d'une info-bulle rouge.

3. Sélectionnez une opération pour afficher un résumé la concernant. Les informations ici sont souvent limitées. Pour plus d’informations sur l’opération, sélectionnezJSON.

   

4. Faites défiler jusqu'à la section Propriétés du JSON, qui fournit des détails sur l’erreur à l'origine de l'échec de l'opération. Dans cet exemple, l’échec était dû à une erreur d’exécution provenant de valeurs de latitude hors limites. Une différence dans les données qu’un travail Stream Analytics traite provoque une erreur de données. Vous pouvez en savoir plus sur les différentes erreurs de données d’entrée et de sortie, et la raison de leur survenue.

   

5. Effectuez des actions correctives en fonction du message d’erreur au format JSON. Dans cet exemple, ajoutez des vérifications pour vous assurer que la valeur de latitude est comprise entre -90 degrés et 90 degrés.

6. Si le message d’erreur dans les journaux d’activité n’est pas utile pour identifier la cause profonde, activez les journaux des ressources et utilisez les journaux d’Azure Monitor.

Envoyer les diagnostics Stream Analytics vers les journaux Azure Monitor

Activez les journaux de ressources et envoyez-les vers les journaux Azure Monitor. Les journaux des ressources sont désactivés par défaut.

1. Créez un espace de travail Log Analytics si vous n’en avez pas déjà un. Placez votre espace de travail Log Analytics dans la même région que votre travail Stream Analytics.

2. Connectez-vous au portail Azure et accédez à votre travail Stream Analytics. Sous Supervision, sélectionnez Journaux de diagnostic. Ensuite, sélectionnez Activer les diagnostics.

   

3. Indiquez un nom dans le champ Nom des paramètres de diagnostic et cochez les cases Exécution et Création sous Journal, ainsi que AllMetrics sous Métrique. Sélectionnez ensuite Envoyer à Log Analytics et choisissez votre espace de travail. Sélectionnez Enregistrer.

   

4. Lorsque votre travail Stream Analytics démarre, les journaux de ressources sont envoyés vers votre espace de travail Log Analytics. Pour afficher les journaux de ressources de votre travail, sélectionnez Journaux sous la section Surveillance.

   

5. Stream Analytics fournit des requêtes prédéfinies qui vous permettent de rechercher facilement les journaux qui vous intéressent. Vous pouvez sélectionner n’importe quelle requête prédéfinie dans le volet gauche, puis sélectionner Exécuter. Les résultats de la requête s’affichent dans le volet inférieur.

   

Catégories de journaux de ressources Stream Analytics

Azure Stream Analytics capture deux catégories de journaux de ressources :

• Création : capture les événements de journal liés aux opérations de création de travaux (création du travail, ajout et suppression d’entrées et de sorties, ajout et mise à jour de la requête, démarrage et arrêt du travail).

• Exécution : capture les événements qui se produisent pendant l’exécution du travail.

  • Erreurs de connectivité
  • Erreurs de traitement des données, notamment :
    • Événements non conformes à la définition de la requête (types et valeurs de champs ne correspondant pas, champs manquants, etc.)
    • Erreurs d’évaluation d’expression
  • Autres erreurs et événements

Tous les journaux d’activité sont stockés au format JSON. Pour en savoir plus sur le schéma des journaux de ressources, consultez Schéma des journaux de ressources.

Étapes suivantes

• Erreurs de données Stream Analytics
• Informations de référence sur le langage de requête Stream Analytics