Partage via


Déboguer des requêtes Azure Stream Analytics en local à l’aide du diagramme de travail dans Visual Studio Code (préversion)

Les travaux de diffusion en continu qui ne génèrent aucun résultat ou des résultats inattendus nécessitent souvent un dépannage. L’extension de Visual Studio Code pour Azure Stream Analytics intègre les diagrammes de travaux, les métriques, les journaux de diagnostic et les résultats intermédiaires pour vous aider à isoler rapidement la source d’un problème. Vous pouvez utiliser le diagramme de travail lorsque vous testez votre requête localement pour examiner le jeu de résultats intermédiaire et les métriques pour chaque étape.

Déboguer une requête à l’aide du diagramme de travail

Un script Azure Stream Analytics est utilisé pour transformer des données d’entrée en données de sortie. Le diagramme de la tâche montre la façon dont les données circulent des sources d’entrée (Event Hubs, IoT Hub, etc.), via plusieurs étapes de requête jusqu’aux récepteurs de sortie. Chaque étape de la requête est mappée à un jeu de résultats temporaire défini dans le script à l’aide d’une instruction WITH. Vous pouvez afficher les données et les métriques de chaque étape de la requête dans chaque jeu de résultats intermédiaire pour trouver la source d’un problème.

Notes

Ce diagramme de travail affiche uniquement les données et les métriques pour les tests locaux dans un nœud unique. Il ne doit pas être utilisé pour le réglage des performances et la résolution des problèmes.

Commencer les tests locaux

Utilisez ce Démarrage rapide pour apprendre à créer un travail Stream Analytics à l’aide de Visual Studio Code ou exporter un travail existant vers un projet local. Les informations d’identification pour les entrées et les sorties sont automatiquement remplies pour les travaux exportés.

Si vous souhaitez tester la requête avec des données d’entrée locales, suivez ces instructions. Si vous souhaitez effectuer un test avec une entrée dynamique, configurez votre entrée et passez à l’étape suivante.

Ouvrez le fichier de script .asaql et sélectionnez Exécuter localement. Ensuite, sélectionnez Utiliser une entrée locale ou Utiliser une entrée en direct. Le diagramme de tâche apparaît sur le côté droit de la fenêtre.

Afficher la sortie et le jeu de résultats intermédiaire

  1. Toutes les sorties de tâche s’affichent dans la fenêtre de résultats en bas à droite de la fenêtre de Visual Studio Code.

    Résultats de sortie de la tâche

  2. Sélectionnez l’étape de la requête pour accéder au script. Vous êtes automatiquement dirigé vers le script correspondant dans l’éditeur sur la gauche. Les résultats intermédiaires s’affichent dans la fenêtre de résultats en bas à droite de la fenêtre de Visual Studio Code.

    Aperçu des résultats dans le diagramme de travail

Afficher les mesures

Dans cette section, vous explorez les métriques disponibles pour chaque partie du diagramme.

  1. Sélectionnez l’onglet Métriques en regard de l’onglet Résultats situé en bas à droite de la fenêtre Visual Studio Code.

  2. Dans la liste déroulante, sélectionnez Tâche. Vous pouvez sélectionner n’importe quel espace vide dans un nœud de graphique pour accéder aux métriques au niveau de la tâche. Cette vue contient toutes les métriques, qui sont mises à jour toutes les 10 secondes lorsque la tâche est en cours d’exécution. Vous pouvez sélectionner ou désélectionner les métriques sur le côté droit pour les afficher dans les graphiques.

    Métriques du diagramme de la tâche

  3. Sélectionnez le nom de la source de données d’entrée dans la liste déroulante pour afficher les métriques d’entrée. La source d’entrée dans la capture d’écran ci-dessous est appelée quotes. Pour plus d’informations sur les métriques d’entrée, consultez Métriques des travaux Azure Stream Analytics.

    Métriques d’entrée du diagramme de tâche

  4. Sélectionnez une étape de requête dans le diagramme de tâche ou sélectionnez le nom de l’étape dans la liste déroulante pour afficher les métriques au niveau de l’étape. Le délai en filigrane est la seule mesure de l’étape disponible.

    Métriques de l’étape

  5. Sélectionnez une sortie dans le diagramme ou dans la liste déroulante pour afficher les métriques liées à la sortie. Pour plus d’informations sur les métriques de sortie, consultez Métriques des travaux Azure Stream Analytics. Les récepteurs de sortie dynamique ne sont pas pris en charge.

    Métriques de sortie

Afficher les journaux de diagnostic

Les journaux de diagnostic au niveau de la tâche contiennent des informations de diagnostic pour les sources de données d'entrée et les récepteurs de sortie. Lorsque vous sélectionnez un nœud d’entrée ou de sortie, seuls les journaux correspondants sont affichés. Aucun journal n’est affiché si vous sélectionnez une étape de requête. Vous pouvez trouver tous les journaux au niveau de la tâche, et les filtrer par gravité et par temps.

Journaux de diagnostic

Sélectionnez une entrée de journal pour afficher l’intégralité du message.

Message des journaux de diagnostic

Autres fonctionnalités du diagramme de tâche

Vous pouvez sélectionner Arrêter ou Suspendre à partir de la barre d’outils en fonction de vos besoins. Une fois la tâche suspendue, vous pouvez la reprendre à partir de la dernière sortie.

Arrêter ou suspendre la tâche

Sélectionnez Résumé de la tâche en haut à droite du diagramme pour afficher les propriétés et les configurations de votre tâche locale.

Résumé de la tâche locale

Limites

  • Exécuter une tâche en local avec la fonction JavaScript n'est pris en charge que par le système d'exploitation Windows.

  • Les fonctions Azure Machine Learning ne sont pas prises en charge.

  • Seules les options d’entrée dans le cloud offrent une prise en charge de stratégies de temps ; les options d’entrée locale n’en proposent pas.

Étapes suivantes