Überwachen des Konnektors¶

Der Snowflake-Konnektor für ServiceNow® unterliegt den Nutzungsbedingungen für Konnektoren.

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

Unter diesem Thema:

Allgemeine Informationen zur Überwachung des Konnektors¶

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

Name der Ansicht	Beschreibung
`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 Datenerfassungsprozess und die vom Konnektor erfasste Datenmenge bereit.
`GLOBAL_CONFIG`	Stellt eine Liste der Werte der vom Konnektor verwendeten Konfigurationseinstellungen bereit.
`ENABLED_TABLES`	Stellt die Liste der ServiceNow-Tabellen bereit, die für die Synchronisierung aktiviert oder deaktiviert sind. In dieser Ansicht können Sie feststellen, welche Tabellen für die Synchronisierung aktiviert sind.
`TABLES_STATE`	Ermöglicht den Zugriff auf Informationen über die Tabellen, die für die Synchronisierung aktiviert wurden. Zu diesen Informationen gehören: Erfassungsstatus `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 das Ereignisprotokoll 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. Zeitplan für die Synchronisierung Zeitstempel der letzten geplanten Synchronisierung
`WORKERS_STATE`	Ermöglicht den Zugriff auf Informationen zu aktuell eingelesenen Tabellen und die Anzahl der darin enthaltenen Zeilen.

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:

Systemrolle ACCOUNTADMIN
Rolle, an die Sie Konfigurationsberechtigungen delegiert haben, wie zum Beispiel die Rolle connector_config_role.

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. Zu diesen E-Mail-Benachrichtigungen gehören:

Die Anzahl der aufgetretenen Fehler und der jeweilige Fehlertyp.
Ankündigungen, wenn neue Versionen des Konnektors verfügbar sind.
Erinnerungen an die Aktualisierung von OAuth-Token.

Aktivieren von E-Mail-Benachrichtigungen mit Snowsight¶

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

Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.
Wählen Sie im Navigationsmenü die Option Data Products » Marketplace aus.
Suchen Sie nach dem Snowflake Connector for ServiceNow®, und wählen Sie dann die Kachel für den Konnektor aus.
Wählen Sie auf der Seite des Snowflake Connector for ServiceNow® die Kachel mit dem Titel Email Alerts aus.

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 – Bei Auftreten eines Fehlers wird sofort eine E-Mail-Meldung versandt. Once per day – Einmal täglich wird eine E-Mail-Meldung mit einer Zusammenfassung aller Fehler versendet. Empfohlene Option, wenn die kundenspezifische Zeitplanung verwendet wird.

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 – Bei Auftreten eines Fehlers wird sofort eine E-Mail-Meldung versandt.
Once per day – Einmal täglich wird eine E-Mail-Meldung mit einer Zusammenfassung aller Fehler versendet. Empfohlene Option, wenn die kundenspezifische Zeitplanung verwendet wird.

Deaktivieren von E-Mail-Benachrichtigungen mit Snowsight¶

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

Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.
Wählen Sie im Navigationsmenü die Option Data Products » Marketplace aus.
Suchen Sie nach dem Snowflake-Konnektor für ServiceNow®, und wählen Sie dann die Kachel für den Konnektor aus.
Wählen Sie auf der Seite für Snowflake Connector for ServiceNow® die Option Email Alerts aus.
Wählen Sie die Schaltfläche … und dann die Option Stop Receiving Alerts aus.
Wählen Sie Confirm aus.

Im Hintergrund wird das Benachrichtigungsintegrationsobjekt SERVICENOW_GZSTZTP0KHD_NOTIFICATION erstellt, das zum Senden von E-Mail-Alerts verwendet wird. 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 Konnektorrolle die USAGE-Berechtigung für diese Integration erteilen. Führen Sie dazu folgenden Befehl aus:

GRANT USAGE ON INTEGRATION <notification_integration_name> TO ROLE <connector_resources_provider>;

Copy

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

CALL CONFIGURE_ALERTS({
  'notificationIntegrationName': '<notification_integration_name>',
  'emailAddresses': ['<email_address>'],
  'scheduleType': '<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: E-Mail-Benachrichtigungen werden einmal pro Tag gesendet. Empfohlene Option, wenn die kundenspezifische Zeitplanung verwendet wird.
LOWEST_INGESTION_SCHEDULE: E-Mail-Benachrichtigungen werden so oft wie die am wenigsten häufig geplante Synchronisierung gesendet.

Wenn Sie beispielsweise eine Rolle mit dem Namen SN_ROLE für Ihren Konnektor definiert haben und die Benachrichtigungsintegration SN_EMAILS verwenden, um tägliche E-Mail-Benachrichtigungen an die E-Mail-Adresse john.doe@snowflake.com zu senden, führen Sie den folgenden Befehl aus:

GRANT USAGE ON INTEGRATION  SN_EMAILS TO ROLE SN_ROLE;

CALL CONFIGURE_ALERTS({
  'notificationIntegrationName': 'SN_EMAILS',
  'emailAddresses': ['john.doe@snowflake.com'],
  'scheduleType': '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.