Überwachen des Snowflake Connector for ServiceNow®V2

Der Snowflake Connector für ServiceNow® V2 unterliegt den Nutzungsbedingungen für Snowflake Connector.

Unter diesem Thema wird beschrieben, wie Sie den Status des Snowflake Connector for ServiceNow®V2 überwachen und Probleme beheben können.

Unter diesem Thema:

Allgemeine Informationen zur Überwachung des Konnektors

Um den Status des Snowflake Connector for ServiceNow®V2 zu überwachen und Probleme zu beheben, können Sie auf die Konnektorkonfiguration, auf Fehlermeldungen und Statistiken zugreifen. Der Zugriff erfolgt über die folgenden Ansichten, die im PUBLIC-Schema der Konnektoranwendung definiert sind:

Name der Ansicht

Beschreibung

AGGREGATED_CONNECTOR_STATS

Bietet Zugriff auf Informationen zur Gesamtzahl der vom Konnektor aktualisierten Zeilen (eingefügte, geänderte und gelöschte Datensätze) in jeder vollen Stunde.

APP_PROPERTIES

Stellt der Benutzeroberfläche Informationen zu den vom Snowflake Connector for ServiceNow®V2 unterstützten Eigenschaften bereit.

CONFIGURED_TABLES

Stellt die Liste der ServiceNow®-Tabellen bereit, die konfiguriert wurden. In dieser Ansicht können Sie feststellen, welche Tabellen für die Synchronisierung aktiviert sind, deren Datenaufnahmestrategie, der Zeitplan und weitere Datenaufnahmeoptionen.

CONNECTOR_CONFIGURATION

Stellt eine Liste der Werte der vom Konnektor verwendeten Konfigurationseinstellungen bereit.

CONNECTOR_ERRORS

Ermöglicht den Zugriff auf die Fehler, die während der Datenerfassung aufgetreten sind.

CONNECTOR_OVERVIEW

Stellt allgemeine Informationen zum Konnektor bereit.

CONNECTOR_STATS

Stellt Statistiken über den laufenden Datenaufnahmeprozess und die vom Konnektor in jedem Datenaufnahmelauf gesammelten Daten bereit.

SYNC_STATUS

Liefert den allgemeinen Status des Konnektors und des Datenaufnahmeprozesses:

  • PAUSED – Der Konnektor ist gerade angehalten oder wird gerade fortgesetzt und es werden gerade keine Tabellen eingelesen.

  • NOT_SYNCING – Der Konnektor ist bereit, Daten aufzunehmen, hat aber noch keine Daten aufgenommen.

  • SYNCING_DATA – Der Konnektor nimmt gerade Daten auf, aber es gibt noch keine Tabelle, bei der die Aufnahme abgeschlossen ist.

  • LAST_SYNCED – Die Datenaufnahme ist bei mindestens einer Tabelle beendet. Der Zeitstempel der letzten abgeschlossenen Datenaufnahme wird in der Spalte LAST_SYNCED_AT angegeben.

TABLES_STATE

Ermöglicht den Zugriff auf Informationen zu den Tabellen, die jemals für die Synchronisierung aktiviert wurden. Zu diesen Informationen gehören:

  • Status der Tabelle – ob sie aktiviert oder deaktiviert ist oder gerade neu geladen wird.

  • Status der letzten Datenaufnahme.

    • DONE bedeutet, dass die abgerufenen Daten in der Sync-Tabelle verfügbar sind.

    • RUNNING bedeutet, dass der Download gerade ausgeführt wird oder dass die Daten bereits in die Ereignisprotokolltabelle abgerufen wurden, aber die Synchronisierungstabelle noch nicht aktualisiert wurde.

    • FAILED bedeutet, dass der Datenerfassungslauf aufgrund eines Fehlers unterbrochen wurde. Dies kann dazu führen, dass nur ein Teil der Daten heruntergeladen wird. Dies führt zu keiner Datendiskrepanz, und je nach Datenerfassungsstrategie werden einige Batches möglicherweise erneut erfasst.

    • DISABLED bedeutet, dass eine bestimmte Tabelle mitten im Datenerfassungslauf deaktiviert wurde.

  • Zeitstempel der letzten geplanten Synchronisierung

  • Seitengröße, die in den Anfragen verwendet wird, die Daten für die Tabelle sammeln.

  • Status der Erstellung vereinfachter Ansichten.

  • Zeitstempel der letzten Überprüfung durch den Konnektor, ob vereinfachte Ansichten für die Tabelle neu erstellt werden müssen.

WORKERS_STATE

Ermöglicht den Zugriff auf Informationen zu aktuell aufgenommenen Tabellen und darüber, wann ihnen die Worker-Aufgabe zugewiesen wurden.

Beachten Sie, dass alle Zeitstempel in der obigen Ansicht in der UTC-Zeitzone ohne Offset angezeigt werden, die von der Zeitzone der Datumsangaben abweichen kann, die von der ServiceNow-Instanz angezeigt werden.

Die folgenden Rollen haben Zugriff auf diese Ansichten:

  • Der Eigentümer der Konnektor-Anwendung (normalerweise die Systemrolle ACCOUNTADMIN).

  • Jede Rolle, der die Anwendungsrolle ADMIN oder VIEWER zugewiesen ist.

Konfigurieren von E-Mail-Alerts

Sie können E-Mail-Alerts für den Konnektor aktivieren. Der Konnektor verwendet die Notification System Stored Procedure (Gespeicherte Systemprozedur für Benachrichtigungen), um die E-Mail-Benachrichtigungen zu senden. Um Alerts zu konfigurieren, muss zuerst der Konnektor installiert werden. Diese E-Mail-Benachrichtigung enthält die Anzahl der aufgetretenen Fehler und den jeweiligen Fehlertyp.

Aktivieren von E-Mail-Benachrichtigungen mit Snowsight

Um E-Mail-Alerts zu konfigurieren, navigieren Sie in Marketplace zur Anwendung Snowflake Connector for ServiceNow®V2:

  1. Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.

  2. Wählen Sie im Navigationsmenü die Option Data Products und dann Apps aus.

  3. Suchen Sie nach dem Snowflake Connector for ServiceNow®V2, und wählen Sie dann die Kachel für den Konnektor aus.

  4. Wählen Sie auf der Seite für den Snowflake Connector for ServiceNow®V2 in der oberen Leiste die Registerkarte Settings aus, und wechseln Sie dann in der Liste links zum Abschnitt Email Alerts.

  5. Geben Sie die folgenden Informationen in das Dialogfeld ein:

    Feld

    Beschreibung

    Email Address

    Einzelne E-Mail-Adresse, an die die Alerts gesendet werden sollen. Sie müssen eine E-Mail-Adresse angeben, die mit dem Snowflake-Konto verknüpft ist.

    Frequency

    Es gibt zwei mögliche Werte:

    • Immediately – Fehler werden zusammengefasst, und der Bericht wird so oft gesendet, wie es der niedrigste konfigurierte Zeitplan für die Aufnahme vorsieht.

    • Once per day – Einmal täglich um 12:00 Uhr UTC wird eine E-Mail-Nachricht mit einer Zusammenfassung aller Fehler versendet.

Deaktivieren von E-Mail-Benachrichtigungen mit Snowsight

Um E-Mail-Alerts zu deaktivieren, navigieren Sie in Marketplace zur Anwendung Snowflake Connector for ServiceNow®V2:

  1. Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.

  2. Wählen Sie im Navigationsmenü die Option Data Products und dann Apps aus.

  3. Suchen Sie nach dem Snowflake Connector for ServiceNow®V2, und wählen Sie dann die Kachel für den Konnektor aus.

  4. Wählen Sie auf der Seite für den Snowflake Connector for ServiceNow®V2 in der oberen Leiste die Registerkarte Settings aus, und wechseln Sie dann in der Liste links zum Abschnitt Email Alerts.

  5. Wählen Sie Stop receiving alerts aus, und wählen Sie dann zur Bestätigung erneut Stop receiving alerts aus.

Im Hintergrund wird das Benachrichtigungsintegrationsobjekt erstellt, das zum Senden von E-Mail-Alerts verwendet wird. Der Name dieser Integration ist derselbe wie der Name der Konnektoranwendung ergänzt um das Suffix _NOTIFICATION_INTEGRATION. Der Konnektor referenziert dieses Objekt mit seinem Namen. Wenn Sie den Namen dieses Objekts ändern oder das Objekt löschen, wird die Funktionalität der E-Mail-Benachrichtigung unterbrochen.

Aktivieren von E-Mail-Benachrichtigungen mit SQL

Um E-Mail-Alerts zu konfigurieren, müssen Sie eine Benachrichtigungsintegration erstellen.

Nachdem Sie die Benachrichtigungsintegration erstellt haben, müssen Sie der Konnektoranwendung die USAGE-Berechtigung für diese Integration erteilen. So erteilen Sie beispielsweise dem Konnektor namens my_connector_servicenow die folgenden Berechtigungen:

GRANT USAGE ON INTEGRATION <notification_integration_name> TO APPLICATION <connector_application>;
Copy

Um E-Mail-Alerts zu konfigurieren und zu aktivieren, rufen Sie die Prozedur CONFIGURE_ALERTS auf:

CALL CONFIGURE_ALERTS({
  'notification_integration_name': '<notification_integration_name>',
  'email_addresses': ['<email_address>'],
  'schedule_type': '<schedule>'
});
Copy

Wobei:

notification_integration_name

Bezeichner der Benachrichtigungsintegration, die Sie für den Versand der E-Mail-Alerts erstellt haben.

email_address

E-Mail-Adresse, an die die E-Mail-Benachrichtigungen gesendet werden sollen.

  • Sie können nur eine E-Mail-Adresse angeben.

  • Die E-Mail-Adresse muss in der ALLOWED_RECIPIENTS-Klausel der Benachrichtigungsintegration angegeben werden.

schedule

Die Häufigkeit, mit der Benachrichtigungen gesendet werden sollen. Geben Sie einen der folgenden Werte an:

  • ONCE_PER_DAY: Einmal am Tag um 12:00 Uhr UTC wird eine E-Mail-Benachrichtigung gesendet.

  • LOWEST_INGESTION_SCHEDULE: E-Mail-Benachrichtigungen werden sofort nach Auftreten eines Fehlers gesendet.

Wenn Sie beispielsweise Ihrer Konnektoranwendung MY_CONNECTOR_SERVICENOW genannt haben und die Benachrichtigungsintegration SN_EMAILS verwenden möchten, um tägliche E-Mail-Benachrichtigungen an die E-Mail-Adresse john.doe@snowflake.com zu senden, führen Sie die folgenden Befehle aus:

GRANT USAGE ON INTEGRATION SN_EMAILS TO APPLICATION MY_CONNECTOR_SERVICENOW;

CALL CONFIGURE_ALERTS({
  'notification_integration_name': 'SN_EMAILS',
  'email_addresses': ['john.doe@snowflake.com'],
  'schedule_type': 'ONCE_PER_DAY'
});
Copy

Der Konnektor referenziert dieses Benachrichtigungsintegrationsobjekt mit seinem Namen. Wenn Sie den Namen dieses Objekts ändern oder das Objekt löschen, wird die Funktionalität der E-Mail-Benachrichtigung unterbrochen.

Aktivieren von E-Mail-Benachrichtigungen mit SQL

Um E-Mail-Benachrichtigungen zu deaktivieren, rufen Sie die gespeicherte Prozedur DISABLE_ALERTS() auf:

CALL DISABLE_ALERTS();
Copy

Wenn Sie E-Mail-Benachrichtigungen wieder aktivieren müssen, finden Sie unter Aktivieren von E-Mail-Benachrichtigungen mit Snowsight die entsprechenden Informationen.