Überwachen von Konnektoren mit dem Openflow Connectors-Dashboard¶
Das Openflow Connectors-Dashboard bietet eine Übersicht zu allen installierten Konnektoren, Zustand-Snapshots und wichtige Leistungsindikatoren, wie z. B. den aggregierten durchschnittlichen Durchsatz und die Gesamtdaten, die von allen Konnektoren, die die Filterkriterien erfüllen, aufgenommen werden.
Voraussetzungen¶
Um das Openflow Connectors-Dashboard zu verwenden, müssen die folgenden Voraussetzungen erfüllt sein:
Sie benötigen mindestens eine Nur-Lesen-Berechtigung für die Ereignistabelle.
Sie müssen über die folgenden Openflow-Mindestversionen verfügen:
BYOC-Bereitstellung: 1.36.0
Snowflake-Bereitstellung: 1.26.0
Runtime: 2026.3.17.13
Sie müssen über die folgenden Mindestversionen für Konnektoren verfügen. Diese Versionen gelten für Change Data Capture (CDC)-Konnektoren. Andere Konnektortypen haben für die Dashboard-Unterstützung keine Anforderungen an die Mindestversion.
Konnektor
Mindestversion
MySQL
0.33.0
PostgreSQL
0.39.0
MongoDB
0.17.0
SQL Server
0.27.0
Eingebettete Oracle-Lizenz
0.25.0
Unabhängige Oracle-Lizenz
0.24.0
Weitere Informationen dazu finden Sie unter Snowflake Openflow-Versionsverlauf.
Zugriff auf das Openflow Connectors-Dashboard¶
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü Ingestion » Openflow aus und navigieren Sie zur Registerkarte Connector Observability.
Das Openflow Connectors-Dashboard wird angezeigt.
Übersicht zum Openflow Connectors-Dashboard¶
Das Openflow Connectors-Dashboard zeigt die folgenden Informationen an:
- Status
Zeigt die Anzahl der Konnektoren mit den folgenden Statusangaben an:
Healthy: Während des ausgewählten Zeitraums sind keine Fehler aufgetreten.
Unhealthy: Protokollierte Fehler in der Ereignistabelle während des ausgewählten Zeitraums oder enthält eine oder mehrere Tabellen mit dem Status Failed (nur Change Data Capture (CDC)-Konnektoren).
Upgrade required: Die Openflow-Bereitstellung, Laufzeit oder der Konnektor werden nicht mit den Mindestversionen ausgeführt, die zur Anzeige von Zustands- und Leistungsmetriken erforderlich sind. Überprüfen Sie die Voraussetzungen für die Version, und führen Sie bei Bedarf ein Upgrade durch.
- Average throughput
Misst die Rate, mit der Daten aus Quellsystemen gelesen und über alle Konnektoren an Snowflake gesendet werden.
Die Metrik Average throughput » Ingested misst, wie schnell Daten über alle Konnektoren, die den Kriterien für Primärfilter (Zeitrahmen und Ereignistabelle) entsprechen, an Snowflake gesendet werden.
Die Metrik Average throughput » Read misst, wie schnell Openflow Daten aus Quellsystemen über alle Konnektoren hinweg liest, die den Kriterien für Primärfilter (Zeitrahmen und Ereignistabelle) entsprechen.
- Total data ingested
Zeigt an, wie viele Daten alle Konnektoren, die den Kriterien für Primärfilter für Zeitrahmen und Ereignistabelle entsprechen, im ausgewählten Zeitraum an Snowflake gesendet haben. Verwenden Sie diese Metrik, um schnell Anomalien bei der Datenaufnahme über einen bestimmten Zeitraum zu erkennen.
Informationen zu kundenspezifischen Telemetrieabfragen außerhalb des Dashboards finden Sie unter Überwachen von Openflow mithilfe von Telemetriedaten.
Bemerkung
Die Metriken Total data ingested und:ui:
Average throughputumfassen sowohl die Rohnutzlast als auch die strukturellen Overheads wie JSON-Schlüssel, -Klammern und -Trennzeichen. Da diese Metriken das übertragene Gesamtvolumen verfolgen, können diese Zahlen höher sein als die von Snowpipe Streaming gemeldeten unkomprimierten Daten oder das endgültige Speichervolumen in Ihrer Zieltabelle.Die Konnektoren werden in der Liste angezeigt, wenn sie den ausgewählten Filterkriterien entsprechen und Telemetrieereignisse während des ausgewählten Zeitraums aufgezeichnet haben.
Wenn Sie längere Zeitrahmen untersuchen, werden in der Liste möglicherweise Konnektoren angezeigt, die zuvor gelöscht wurden.
Sie haben zum Beispiel einen Konnektor vor sechs Tagen bereitgestellt und diesen Konnektor dann vor zwei Tagen gelöscht. Wenn Sie den Zeitrahmen auf Last 7 days setzen, wird der Konnektor in der Liste angezeigt, da er Telemetrieereignisse der letzten 7 Tage aufgezeichnet hat.
Filtern von Konnektoren¶
Das Openflow Connectors-Dashboard unterstützt die folgenden Filter:
- Event table
Die Ereignistabelle des Openflow-Konnektors, die Sie überwachen möchten. Dieser Filter zeigt Ereignistabellen an, die mit mindestens einer Openflow-Bereitstellung verbunden sind, sowie die Standard-Ereignistabelle und die Konto-Ereignistabelle. Sie können immer nur eine Ereignistabelle auswählen. Ansichten von Ereignistabellen werden ebenfalls unterstützt.
Die Ereignistabelle wird festgelegt, wenn Sie Openflow einrichten.
Tipp
Um die mit einer Openflow-Bereitstellung verbundene Ereignistabelle anzuzeigen, verwenden Sie den Befehl DESCRIBE OPENFLOW DATA PLANE INTEGRATION. Weitere Informationen zum Konfigurieren von Ereignistabellen finden Sie unter Openflow – Snowflake-Bereitstellungen einrichten or Openflow einrichten – BYOC
- Zeitrahmen
Verwenden Sie diesen Filter, um relevante Konnektoren in einem bestimmten Zeitrahmen zu identifizieren.
Tipp
Um die aktuellsten Ergebnisse über die Integrität des Konnektors zu erhalten, wählen Sie den Zeitrahmen Last Hour aus.
- Status
Ermöglicht das Filtern nach Konnektoren mit dem Status Healthy, Unhealthy oder All.
- Source
Ermöglicht das Filtern nach dem Quellsystem auf der Grundlage bekannter bereitgestellter Konnektoren. Der Filter zeigt nur Quellen an, die von Ihren Konnektoren verwendet werden.
- Deployment
Ermöglicht das Filtern nach Snowflake Openflow-Bereitstellungen.
Dieser Filter zeigt Namen von Data Plane-Integrationen an, die aus dem Präfix
OPENFLOW_DATAPLANE_gefolgt von der Bereitstellungs-ID bestehen. Um die Bereitstellungs-ID zu ermitteln, navigieren Sie zu Openflow, wählen Sie die Registerkarte Deployments und dann Option View Details aus.- Runtime
Ermöglicht das Filtern nach Snowflake Openflow-Laufzeiten.
Dieser Filter zeigt die Laufzeitschlüssel an. Um Laufzeitschlüssel mit Openflow-Laufzeitnamen in der UI abzugleichen, navigieren Sie zu Openflow, wählen Sie die Registerkarte Runtimes und anschließend die Option:ui:
View Detailsaus. Suchen Sie dann den zugehörigen Schlüssel.- Type
Ermöglicht das Filtern nach Konnektortyp: Datenbanken, SaaS, Streaming, Unstrukturiert, Sonstige.
Bemerkung
Primärfilter (Ereignistabelle und Zeitrahmen) werden vor Sekundärfiltern (Status, Quelle, Bereitstellung, Laufzeit oder Typ) angewendet.
Die sekundären Filter (Status, Quelle, Bereitstellung, Laufzeit, Typ) gelten nicht für den Durchsatz und die aufgenommenen Daten.
Überwachung von Openflow-Konnektoren¶
Um die Details eines Konnektors zu überwachen, wählen Sie
» View Details aus.
Ändern der Change Data Capture-Konnektoren¶
Auf der Detailseite werden die folgenden Informationen für jede Tabelle angezeigt, die Teil der Change Data Capture-Konfiguration ist:
- Table replication status
Tabellen können sich entweder im Replikationsstatus Active oder:ui:
Failedbefinden. Der Replikationsstatus basiert auf dem letzten Telemetrieereignis, das für die Tabelle verfügbar ist. Ereignisse, die dazu führen, dass die Replikation für eine Tabelle fehlschlägt, führen sofort zum Replikationsstatus Failed im Dashboard. Nutzen Sie die Nachricht Failure Reason, um das Problem zu identifizieren.- Error distribution
Hilft Ihnen zu verstehen, wann für den Konnektor Probleme aufgetreten sind, sodass Sie potenzielle Probleme mit Quellsystemen, der Konnektor-Konfiguration oder dem Snowflake-Ziel erkennen können.
- Table name
Zeigt das Schema und die Tabellennamen für alle Tabellen an, die für eine Replikation durch den Konnektor konfiguriert sind. Die Liste stimmt mit den Konfigurationsparametern Included Table Names oder Included Table Regex des Konnektors überein.
- Replication status
Zeigt an, ob sich eine Tabelle im Replikationsstatus Active oder Failed befindet.
- Replication phase
Zeigt die aktuelle Phase der Tabellenreplikation an. Nach der Konfiguration im Konnektor wechseln die Tabellen in die Replikationsphase New, gehen in die Phase Snapshot Load über, führen das erstmalige Laden durch und wechseln schließlich in die Phase Incremental Replication, in der einzelne Change Data Capture-Ereignisse verarbeitet werden.
- Last Ingested
Zeigt den Zeitstempel des letzten Datensatzes an, der während des ausgewählten Zeitraums in die Zieltabelle eingefügt wurde. Berücksichtigen Sie bei der Berechnung dieser Metrik eine kurze Verzögerung zwischen den erfassten Datensätzen und den Ereignissen, die protokolliert werden und für Abfragen zur Verfügung stehen.
Sie können die Replication status, Replication phase und Zeitrahmenfilter zum Eingrenzen der Tabellenliste verwenden.
Alle Konnektoren¶
- Connector status
Zeigt den Integritätsstatus des Konnektors an: Healthy, wenn während des ausgewählten Zeitraums keine Fehlermeldungen aufgetreten sind, oder:ui:
Unhealthy, wenn Fehlermeldungen aufgetreten sind.- Error distribution
Zeigt an, wie viele Fehler bei diesem Konnektor im ausgewählten Zeitraum aufgetreten sind.
- Average throughput
Misst die Rate, mit der Daten für den ausgewählten Konnektor aus den Quellsystemen gelesen und in Snowflake aufgenommen werden.
Die Metrik Average throughput » Ingested misst, wie schnell der ausgewählte Konnektor Daten in Snowflake aufnimmt.
Die Metrik Average throughput » Read misst, wie schnell der ausgewählte Konnektor Daten aus Quellsystemen liest.
- Total data ingested
Zeigt an, wie viele Daten der ausgewählte Konnektor im ausgewählten Zeitraum in Snowflake aufgenommen hat. Verwenden Sie diese Metrik, um schnell Anomalien bei der Datenaufnahme über einen bestimmten Zeitraum zu erkennen.
Kundenspezifische Abläufe¶
Kundenspezifische Abläufe, die in der Openflow-Arbeitsoberfläche erstellt wurden, können auch über das Dashboard überwacht werden, jedoch nur, wenn sie in einem Git-Repository eines Kunden mithilfe der Openflow-Git-Integration aktiv versioniert werden. Abläufe, die nicht versionskontrolliert sind, werden nicht im Dashboard angezeigt.
Weitere Informationen dazu finden Sie unter Versionskontrolle für kundenspezifische Abläufe.
Debuggen von Openflow-Konnektoren¶
Das Openflow Connectors-Dashboard dient als Einstiegspunkt für das Debuggen von Konnektor-spezifischen Problemen und macht alle Konnektorprotokolle für Benutzende leicht zugänglich.
Anzeigen der Konnektorfehler¶
Um alle Fehler anzuzeigen, die ein Konnektor im ausgewählten Zeitraum aufgetreten ist, navigieren Sie zunächst zur Seite mit den Konnektordetails, indem Sie
» View Details und dann die Registerkarte Issues auswählen.
Die Fehlerüberschrift teilt Ihnen mit, auf welchen Typ von Fehler der Konnektor gestoßen ist, und der Inhalt liefert die gesamte Stapelüberwachung des Fehlers.
Anzeigen der Konnektor-Protokolle¶
Möglicherweise sollten Sie sich auch zusätzliche Konnektorprotokolle ansehen, um den Kontext einer Fehlermeldung zu verstehen. Um alle Protokolle für den ausgewählten Konnektor anzuzeigen, wählen Sie
» View logs aus.
Nach dem Öffnen des Protokoll-Explorers können Sie auch die Filter ändern, um Protokolle für verschiedene Konnektoren oder für ganze Laufzeiten oder Bereitstellungen anzuzeigen. Der Protokoll-Explorer unterstützt Openflow-spezifische Filter wie die Data Plane-ID, den Laufzeitschlüssel und die Prozessgruppen-ID.
Zugriff auf die Openflow-Arbeitsoberfläche¶
Wenn Sie ein Problem mit dem Konnektor feststellen, müssen Sie wahrscheinlich zur Openflow-Arbeitsoberfläche navigieren, um das Problem zu beheben. Passen Sie z. B. einige Konfigurationsparameter an oder aktualisieren Sie auf eine neuere Version des Konnektors.
Um zum ausgewählten Konnektor in der Openflow-Arbeitsoberfläche zu navigieren, wählen Sie
» Go to canvas aus.
Optimieren der Leistung¶
Auswahl eines größeren Warehouses¶
Verwenden Sie die Warehouse-Auswahl oben rechts auf dem Bildschirm, um ein anderes Warehouse für die Ausführung der Abfragen auszuwählen.
Bemerkung
Größere Warehouses führen Abfragen zwar schneller aus, aber das Fortsetzen dauert länger, was die erstmalige Ladezeit der Seite verlängern kann.
Einrichten von Clustering für die Openflow-Ereignistabelle¶
Durch die Verwendung von Gruppierungsschlüsseln können Sie bei Abfragen unnötiges Scannen von Mikropartitionen vermeiden und dadurch die Leistung von Abfragen, die auf diese Spalten verweisen, erheblich beschleunigen. Weitere Informationen dazu finden Sie unter Was ist Daten-Clustering?.
Führen Sie die folgende Abfrage aus und ersetzen Sie die Platzhalter durch Ihre Openflow-Ereignistabelle:
Bemerkung
Beim Automatic Clustering werden Snowflake-Credits mit serverlosen Computeressourcen verbraucht. Weitere Informationen zur Anzahl der verbrauchten Credits pro Computestunde finden Sie in der „Serverless Feature Credit Table“ unter Snowflake Service Consumption Table.
Nachdem Sie das Clustering für Ihre Ereignistabelle aktiviert haben, wird ein Hintergrundprozess gestartet, der einige Zeit in Anspruch nimmt. Nachdem der Prozess abgeschlossen ist, sollten Sie eine verbesserte Leistung bei der Verwendung des Dashboards feststellen.
Verkürzen des abgefragten Zeitrahmens¶
Die Auswahl eines kleineren Zeitrahmens im Filter führt dazu, dass weniger Daten gescannt werden, was zu einer schnelleren Abfrageleistung führt. Verwenden Sie den Filter Last Hour, um die beste Leistung zu erzielen und einen aktuellen Überblick über den Zustand und die Leistung Ihrer Konnektoren zu erhalten.
Einschränkungen¶
Das Openflow Connectors-Dashboard verwendet Daten, die in Ereignistabellen gespeichert sind, um einen Einblick in Openflow-Konnektoren zu geben. Abhängig vom ausgewählten Zeitraum und der Ereignistabelle spiegeln die auf dem Dashboard bereitgestellten Informationen möglicherweise nicht den aktuellen Status eines Konnektors wider.
Eine detaillierte Überwachung des Zustands ist derzeit nur für Database CDC-Konnektoren verfügbar.
Die Filter Deployment und:ui:
Runtimeverwenden interne Namen, die sich von den Anzeigenamen in der Openflow UI unterscheiden. Weitere Informationen zum Abgleichen dieser Namen finden Sie im Abschnitt zum :ref:` Filtern von Konnektoren<label-openflow_dashboard_filtering>`.
Bekannte Probleme¶
Nach dem Upgrade der Bereitstellung, der Laufzeitumgebung und des Konnektors auf die in den Voraussetzungen genannten Versionen spiegelt die Fehlermetrik nur Fehler wider, die nach dem Upgrade aufgetreten sind.