Surveiller les connecteurs à l’aide du tableau de bord des connecteurs Openflow¶
Le tableau de bord des connecteurs Openflow fournit une vue détaillée de tous les connecteurs installés, des instantanés de santé et des indicateurs de performances clés, tels que le débit moyen agrégé et le total des données ingérées par tous les connecteurs correspondant aux critères de filtre.
Conditions préalables¶
Pour utiliser le tableau de bord des connecteurs Openflow, les conditions suivantes doivent être remplies :
Vous devez disposer d’au moins des autorisations en lecture seule sur le tableau des événements.
Vous devez disposer des versions minimales d’Openflow suivantes :
Déploiement BYOC : 1.36.0
Déploiement de Snowflake : 1.26.0
Runtime : 2026.3.17.13
Vous devez disposer des versions de connecteur minimales suivantes. Ces versions s’appliquent uniquement aux connecteurs de capture de données modifiées (CDC). Les autres types de connecteurs n’ont pas de version minimale requise pour la prise en charge du tableau de bord.
Connecteur
Version minimale
MySQL
0.33.0
PostgreSQL
0.39.0
MongoDB
0.17.0
SQL Server
0.27.0
Licence intégrée Oracle
0.25.0
Licence indépendante Oracle
0.24.0
Pour plus d’informations, voir Historique des versions de Snowflake Openflow.
Accéder au tableau de bord des connecteurs Openflow¶
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Ingestion » Openflow et accédez à l’onglet Connector Observability.
Le tableau de bord des connecteurs Openflow apparaît.
Vue d’ensemble du tableau de bord des connecteurs Openflow¶
Le tableau de bord des connecteurs Openflow affiche les informations suivantes :
- Status
Indique le nombre de connecteurs avec les états suivants :
Healthy : N’a rencontré aucune erreur au cours de la période sélectionnée.
Unhealthy : Erreurs enregistrées dans le tableau des événements pendant la période sélectionnée ou a une ou plusieurs tables dans l’état Failed (connecteurs de capture de données modifiées (CDC) uniquement).
Upgrade required : Le déploiement, l’environnement d’exécution ou le connecteur Openflow n’exécutent pas les versions minimales requises pour afficher les métriques de santé et de performance. Examinez les conditions de version requises et procédez à une mise à niveau si nécessaire.
- Average throughput
Mesure la vitesse à laquelle les données sont lues à partir des systèmes sources et envoyées à Snowflake dans tous les connecteurs.
La métrique Average throughput » Ingested mesure la vitesse à laquelle les données sont envoyées à Snowflake dans tous les connecteurs qui répondent aux critères de filtrage principaux (période et tableau des événements).
La métrique Average throughput » Read mesure la vitesse à laquelle Openflow lit les données des systèmes sources dans tous les connecteurs qui correspondent aux critères de filtre principaux (période et tableau des événements).
- Total data ingested
Indique la quantité de données que tous les connecteurs correspondant aux critères de filtrage principaux pour la période et le tableau des événements ont envoyées à Snowflake au cours de la période sélectionnée. Utilisez cette métrique pour identifier rapidement les anomalies d’ingestion sur une période donnée.
Pour les requêtes de télémétrie personnalisées au-delà du tableau de bord, voir:doc:monitor.
Note
Les métriques Total data ingested et Average throughput comprennent à la fois la charge utile brute et les surcharges structurelles tels que les clés JSON, les accolades et les délimiteurs. Comme ces métriques suivent le volume total transmis, ces chiffres peuvent être supérieurs aux données non compressées rapportées par Snowpipe Streaming ou au volume de stockage final dans votre table de destination.
Les connecteurs apparaissent dans la liste s’ils correspondent aux critères de filtrage sélectionnés et s’ils ont enregistré des événements de télémétrie pendant la période sélectionnée.
Si vous examinez des périodes plus longues, la liste peut afficher des connecteurs qui ont été précédemment supprimés.
Par exemple, vous avez déployé un connecteur il y a six jours, puis supprimé ce connecteur il y a deux jours. Si vous avez défini la période sur:ui:
Last 7 days, le connecteur apparaît dans la liste car il a enregistré des événements de télémétrie au cours des 7 derniers jours.
Filtrage des connecteurs¶
Le tableau de bord des connecteurs Openflow prend en charge les filtres suivants :
- Event table
Tableau des événements des connecteurs Openflow que vous souhaitez surveiller. Ce filtre affiche les tableaux d’événements associés à au moins un déploiement Openflow, ainsi que le tableau d’événements par défaut et le tableau d’événements du compte. Vous ne pouvez sélectionner qu’un seul tableau d’événements à la fois. Les vues de tableau d’événements sont également prises en charge.
Le tableau des événements est défini lorsque vous avez configuré Openflow.
Astuce
Pour afficher le tableau des événements associé à un déploiement Openflow, utilisez la commande DESCRIBE OPENFLOW DATA PLANE INTEGRATION. Voir Configurer Openflow - Déploiement Snowflake ou Configuration d’Openflow - BYOC pour plus d’informations sur la configuration des tableaux d’événements.
- Cadre temporel
Utilisez ce filtre pour identifier les connecteurs pertinents dans une période spécifique.
Astuce
Pour obtenir les résultats les plus récents concernant l’intégrité du connecteur, sélectionnez la période Last Hour.
- Status
Active le filtrage pour les connecteurs Healthy,:ui:
Unhealthyou All.- Source
Permet de filtrer par le système source en fonction des connecteurs déployés connus. Le filtre n’affiche que les sources utilisées par vos connecteurs.
- Deployment
Active le filtrage par déploiements Snowflake Openflow.
Ce filtre affiche les noms d’intégration de plan de données, qui sont composés du préfixe
OPENFLOW_DATAPLANE_suivi de l’ID du déploiement. Pour trouver l’ID du déploiement, accédez à Openflow, sélectionnez l’onglet Deployments, puis sélectionnez View Details.- Runtime
Active le filtrage par les environnements d’exécution Snowflake Openflow.
Ce filtre affiche les clés d’exécution. Pour faire correspondre les clés d’exécution avec les noms d’exécution Openflow dans l’UI, accédez à Openflow, sélectionnez l’onglet Runtimes, puis sélectionnez:ui:
View Detailset recherchez la clé correspondante.- Type
Active le filtrage par type de connecteur : Bases de données, SaaS, Streaming, Non structuré, Autre.
Note
Les filtres principaux (tableau des événements et période) sont appliqués avant les filtres secondaires (état, source, déploiement, environnement d’exécution ou type).
Les filtres secondaires (état, source, déploiement, environnement d’exécution, type) ne s’appliquent pas aux visuels de débit et d’ingestion de données.
Surveillance des connecteurs Openflow¶
Pour surveiller les détails du connecteur, sélectionnez
» View Details.
Changer les connecteurs de capture de données¶
La page de détails affiche les informations suivantes pour chaque table faisant partie de la configuration de la capture des données modifiées :
- Table replication status
Les tables peuvent avoir l’état de réplication Active ou Failed. L’état de la réplication est basé sur l’événement de télémétrie le plus récent disponible pour la table. Les événements qui entraînent l’échec de la réplication d’une table génèrent immédiatement un état de réplication Failed dans le tableau de bord. Utilisez le message Failure Reason pour identifier le problème.
- Error distribution
Vous aide à comprendre lorsque le connecteur a rencontré des problèmes, afin que vous puissiez identifier tout problème potentiel lié aux systèmes sources, à la configuration du connecteur ou à la destination Snowflake.
- Table name
Affiche les noms des schémas et des tables configurées pour être répliquées par le connecteur. La liste correspond aux paramètres de configuration Included Table Names ou Included Table Regex du connecteur.
- Replication status
Indique si chaque table a l’état de réplication Active ou Failed.
- Replication phase
Affiche la phase de réplication de la table en cours. Après la configuration dans le connecteur, les tables entrent dans la New phase de réplication, passent à la phase Snapshot Load pour effectuer le chargement initial et entrent ensuite dans la phase Incremental Replication où les événements de capture de données modifiées sont traités.
- Last Ingested
Affiche l’horodatage du dernier enregistrement inséré dans la table de destination au cours de la période sélectionnée. Lors de la consultation de cette métrique, tenez compte du court délai entre l’ingestion des enregistrements et l’enregistrement des événements, ainsi que leur disponibilité pour interrogation.
Vous pouvez utiliser les filtres Replication status, Replication phase et de période pour réduire la liste des tables.
Tous les connecteurs¶
- Connector status
Affiche l’état de santé du connecteur : Healthy si aucun message d’erreur n’a été rencontré pendant la période sélectionnée, ou Unhealthy si des messages d’erreur ont été rencontrés.
- Error distribution
Indique le nombre d’erreurs rencontrées par ce connecteur au cours de la période sélectionnée.
- Average throughput
Mesure la vitesse à laquelle les données sont lues à partir des systèmes sources et ingérées dans Snowflake pour le connecteur sélectionné.
La métrique Average throughput » Ingested mesure la vitesse à laquelle le connecteur sélectionné ingère les données dans Snowflake.
La métrique Average throughput » Read mesure la vitesse à laquelle le connecteur sélectionné lit les données des systèmes sources.
- Total data ingested
Indique la quantité de données que le connecteur sélectionné a ingérées dans Snowflake au cours de la période sélectionnée. Utilisez cette métrique pour identifier rapidement les anomalies d’ingestion sur une période donnée.
Flux personnalisés¶
Les flux personnalisés créés sur le canevas Openflow peuvent également être surveillés sur le tableau de bord, mais uniquement s’ils font l’objet d’un contrôle de version actif dans un dépôt Git client via l’intégration Git d’Openflow. Les flux qui ne font pas l’objet d’un contrôle de version n’apparaissent pas dans le tableau de bord.
Pour plus d’informations, voir Contrôle des versions pour les flux personnalisés.
Débogage des connecteurs Openflow¶
Le tableau de bord des connecteurs Openflow sert de point d’entrée pour déboguer les problèmes spécifiques aux connecteurs et rend tous les journaux des connecteurs facilement accessibles aux utilisateurs.
Affichage des erreurs de connecteur¶
Pour afficher toutes les erreurs qu’un connecteur a rencontrées dans la période sélectionnée, accédez d’abord à la page de détails du connecteur en sélectionnant
» View Details, puis sélectionnez l’onglet Issues.
Le titre de l’erreur vous indique le type d’erreur rencontré par le connecteur et le contenu fournit la trace complète de l’erreur.
Affichage des journaux du connecteur¶
Vous pouvez également consulter d’autres journaux du connecteur pour comprendre le contexte d’un message d’erreur. Pour afficher tous les journaux du connecteur sélectionné, sélectionnez
» View logs.
Après avoir ouvert l’explorateur de journaux, vous pouvez également modifier les filtres pour afficher les journaux de différents connecteurs ou pour des environnements d’exécution ou des déploiements entiers. L’explorateur de journaux prend en charge des filtres spécifiques à Openflow comme l’ID de plan de données, la clé d’exécution et l’ID du groupe de processus.
Accès au canevas Openflow.¶
Lorsque vous identifiez un problème de connecteur, vous devez probablement accéder au canevas Openflow pour y remédier ; par exemple, ajustez certains paramètres de configuration ou passez à une version de connecteur plus récente.
Pour naviguer vers le connecteur sélectionné dans le canevas Openflow, sélectionnez
» Go to canvas.
Optimisation des performances¶
Sélectionner un entrepôt plus grand¶
Utilisez le sélecteur d’entrepôt dans la section supérieure à droite de l’écran pour choisir un autre entrepôt pour exécuter les requêtes.
Note
Bien que les entrepôts de plus grande taille exécutent les requêtes plus rapidement, ils mettent plus de temps à redémarrer, ce qui peut augmenter le temps de chargement initial de la page.
Configurer le clustering sur le tableau des événements Openflow¶
En utilisant des clés de clustering, vous pouvez éviter une analyse inutile des micro-partitions lors des requêtes, accélérant ainsi considérablement les performances des requêtes faisant référence à ces colonnes. Pour plus d’informations, voir Qu’est-ce que le clustering de données ?.
Exécutez la requête suivante, en remplaçant les espaces réservés par votre tableau des événements Openflow :
Note
Le clustering automatique consomme des crédits Snowflake en utilisant des ressources de calcul sans serveur. Pour savoir combien de crédits par heure de calcul sont consommés, reportez-vous au « Tableau des crédits de fonctionnalité sans serveur » dans la Table de consommation du service Snowflake.
Une fois que vous avez activé le clustering sur votre tableau des événements, un processus en arrière-plan démarre et prend un certain temps pour se terminer. Une fois le processus terminé, vous devriez constater une amélioration des performances lors de l’utilisation du tableau de bord.
Réduire la période interrogée¶
La sélection d’une période plus petite dans le filtre analyse moins de données et conduit à des performances de requête plus rapides. Utilisez le filtre Last Hour pour obtenir les meilleures performances et la vue la plus récente de la santé et des performances de votre connecteur.
Limitations¶
Le tableau de bord des connecteurs Openflow utilise des données stockées dans les tableaux d’événements pour fournir des informations sur les connecteurs Openflow. Selon la période et le tableau d’événements sélectionnées, les informations fournies sur le tableau de bord peuvent ne pas refléter l’état actuel d’un connecteur.
La surveillance de la santé détaillée n’est actuellement disponible que pour les connecteurs CDC de base de données.
Les filtres Deployment et Runtime utilisent des noms internes différents des noms d’affichage dans l’UI d’Openflow. Pour plus de détails sur la correspondance de ces noms, voir:ref:
Filtrage des connecteurs <label-openflow_dashboard_filtering>.
Problèmes connus¶
Après la mise à niveau du déploiement, de l’environnement d’exécution et du connecteur vers les versions mentionnées dans les conditions préalables, la métrique du nombre d’erreurs n’est exacte que pour les erreurs rencontrées après la mise à niveau.