Surveillance du Snowflake Connector for ServiceNow®V2

Snowflake Connector pour ServiceNow® V2 est soumis aux Conditions de Snowflake Connector.

Ce chapitre explique comment surveiller l’état du Snowflake Connector for ServiceNow®V2 et résoudre les problèmes.

Dans ce chapitre :

À propos de la surveillance du connecteur

Pour surveiller l’état de Snowflake Connector for ServiceNow®V2 et résoudre les problèmes, vous pouvez accéder à la configuration, aux messages d’erreur et aux statistiques du connecteur via les vues suivantes, qui sont définies dans le schéma PUBLIC de l”application de connecteur :

Nom de la vue

Description

AGGREGATED_CONNECTOR_STATS

Permet d’accéder à des informations sur le nombre total de lignes mises à jour par le connecteur (enregistrements insérés, modifiés et supprimés) au cours de chaque heure complète.

APP_PROPERTIES

Fournit des informations à l’interface utilisateur sur les propriétés prises en charge par Snowflake Connector for ServiceNow®V2.

CONFIGURED_TABLES

Fournit la liste des tables ServiceNow® qui ont été configurées. Vous pouvez utiliser cette vue pour déterminer quelles tables sont activées pour la synchronisation, leur stratégie d’ingestion, leur planification d’ingestion et d’autres options d’ingestion.

CONNECTOR_CONFIGURATION

Fournit une liste des valeurs des paramètres de configuration utilisés par le connecteur.

CONNECTOR_ERRORS

Permet d’accéder aux erreurs survenues lors de l’ingestion des données.

CONNECTOR_OVERVIEW

Fournit des informations générales sur le connecteur.

CONNECTOR_STATS

Fournit des statistiques sur le processus d’ingestion de données en cours et sur la quantité de données collectées par le connecteur à chaque cycle d’ingestion.

SYNC_STATUS

Fournit le statut général du connecteur et du processus d’ingestion :

  • PAUSED - le connecteur est actuellement en pause ou en cours de reprise et aucune table n’est en cours d’ingestion.

  • NOT_SYNCING - le connecteur est prêt à ingérer des données, mais ne l’a pas encore fait.

  • SYNCING_DATA - le connecteur est en train d’ingérer des données, mais aucune ingestion n’est terminée pour aucune table.

  • LAST_SYNCED - l’ingestion d’au moins une table est terminée. L’horodatage de la dernière ingestion terminée est fourni dans la colonne LAST_SYNCED_AT.

TABLES_STATE

Permet d’accéder à des informations sur les tables pour lesquelles la synchronisation a déjà été activée. Informations comprises :

  • Statut de la table - activée, désactivée ou en cours de rechargement.

  • Statut de la dernière ingestion.

    • DONE signifie que les données récupérées sont disponibles dans la table de synchronisation.

    • RUNNING signifie que le téléchargement est en cours ou que les données ont déjà été récupérées dans la table de journal d’événements, mais que la table de synchronisation n’a pas encore été mise à jour.

    • FAILED signifie que le cycle d’ingestion a été interrompu en raison d’une erreur. Il se peut donc que seule une partie des données soit téléchargée. Cela n’entraînera aucune divergence de données et, en fonction de la stratégie d’ingestion, certains lots pourront être collectés à nouveau.

    • DISABLED signifie que la table en question a été désactivée au milieu de ce cycle d’ingestion.

  • l’horodatage de la dernière synchronisation planifiée.

  • Taille de page utilisée dans les requêtes collectant des données pour la table.

  • Statut de création de vues aplaties.

  • Horodatage de la dernière fois que le connecteur a vérifié s’il était nécessaire de recréer des vues aplaties pour la table.

WORKERS_STATE

Permet d’accéder à des informations sur les tables actuellement ingérées et sur la date à laquelle les tâches des travailleurs leur ont été attribuées.

Notez que tous les horodatages affichés dans les vues ci-dessus sont fournis dans le fuseau horaire UTC sans décalage, ce qui peut différer du fuseau horaire des dates affichées par l’instance ServiceNow.

Les rôles suivants ont accès à ces vues :

  • Propriétaire de l”application de connecteur (généralement le rôle système ACCOUNTADMIN).

  • Tout rôle auquel est accordé le rôle d’application ADMIN ou VIEWER.

Configuration des alertes par e-mail

Vous pouvez activer les alertes par e-mail pour le connecteur. Le connecteur utilise la procédure stockée du système de notification pour envoyer les notifications par e-mail. Pour configurer les alertes, il convient de commencer par installer le connecteur. Ces notifications par e-mail incluent le nombre d’erreurs rencontrées et type de chaque erreur.

Activation des notifications par e-mail à l’aide de Snowsight

Pour configurer les alertes par e-mail, accédez à l’application Snowflake Connector for ServiceNow®V2 dans Marketplace :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

  2. Dans le menu de navigation, sélectionnez Data Products, puis Apps.

  3. Recherchez le Snowflake Connector for ServiceNow®V2, puis sélectionnez la vignette du connecteur.

  4. Sur la page de Snowflake Connector for ServiceNow®V2, sélectionnez l’onglet Settings dans la barre supérieure, puis passez à la section Email Alerts dans la liste à gauche.

  5. Saisissez les informations suivantes dans la boîte de dialogue :

    Champ

    Description

    Email Address

    Adresse e-mail unique à laquelle les alertes doivent être envoyées. Vous devez spécifier une adresse e-mail associée au compte Snowflake.

    Frequency

    Deux valeurs sont possibles :

    • Immediately- Les erreurs sont résumées et le rapport est envoyé en fonction de la planification d’ingestion configurée la moins fréquente.

    • Once per day - Un message e-mail contenant un résumé de toutes les erreurs est envoyé une fois par jour à 12PM UTC.

Désactivation des notifications par e-mail à l’aide de Snowsight

Pour désactiver les alertes par e-mail, accédez à l’application Snowflake Connector for ServiceNow®V2 dans Marketplace :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

  2. Dans le menu de navigation, sélectionnez Data Products, puis Apps.

  3. Recherchez le Snowflake Connector for ServiceNow®V2, puis sélectionnez la vignette du connecteur.

  4. Sur la page de Snowflake Connector for ServiceNow®V2, sélectionnez l’onglet Settings dans la barre supérieure, puis passez à la section Email Alerts dans la liste à gauche.

  5. Sélectionnez Stop receiving alerts, puis confirmez en sélectionnant de nouveau Stop receiving alerts.

Sous le capot, un objet d”intégration de notification, utilisé pour envoyer des alertes par e-mail, est créé. Le nom de cette intégration est le même que le nom de l’application de connecteur avec un suffixe _NOTIFICATION_INTEGRATION ajouté. Le connecteur référence cet objet par son nom. Le fait de modifier le nom de cet objet ou de le supprimer entraîne la rupture de la fonctionnalité d’alertes par e-mail.

Activation des notifications par e-mail à l’aide de SQL

Pour configurer les alertes par e-mail, vous devez créer une intégration de notification.

Après avoir créé l’intégration de notification, vous devez accorder le droit USAGE sur cette intégration au rôle de connecteur. Par exemple, pour accorder les privilèges suivants au connecteur nommé my_connector_servicenow :

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

Pour configurer et activer les alertes par e-mail, appelez la procédure CONFIGURE_ALERTS :

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

Où :

notification_integration_name

Identificateur de l’intégration de notification que vous avez créée pour l’envoi des alertes par e-mail.

email_address

Adresse e-mail à laquelle les notifications par e-mail doivent être envoyées.

  • Vous ne pouvez indiquer qu’une seule adresse e-mail.

  • L’adresse e-mail doit être spécifiée dans la clause ALLOWED_RECIPIENTS de l’intégration de la notification.

schedule

Fréquence à laquelle les notifications doivent être envoyées. Spécifie l’une des valeurs suivantes :

  • ONCE_PER_DAY : envoyez des notifications par e-mail une fois par jour à 12PM UTC.

  • LOWEST_INGESTION_SCHEDULE : envoyez des notifications par e-mail immédiatement après l’apparition d’une erreur.

Par exemple, si vous avez nommé votre application de connecteur MY_CONNECTOR_SERVICENOW, utilisez l’intégration de notification SN_EMAILS pour envoyer des notifications par e-mail quotidiennes à l’adresse e-mail john.doe@snowflake.com en exécutant les commandes suivantes :

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

Le connecteur référence l’objet intégration de notification par son nom. Le fait de modifier le nom de cet objet ou de le supprimer entraîne la rupture de la fonctionnalité d’alertes par e-mail.

Désactivation des notifications par e-mail à l’aide de SQL

Pour désactiver les notifications par e-mail, appelez la procédure stockée DISABLE_ALERTS() :

CALL DISABLE_ALERTS();
Copy

Si vous devez réactiver les notifications par e-mail, voir Activation des notifications par e-mail à l’aide de Snowsight.