Surveillance du connecteur

Le connecteur Snowflake pour ServiceNow® est soumis aux conditions de connecteur.

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

Dans ce chapitre :

À propos de la surveillance du connecteur

Pour surveiller l’état du Snowflake Connector for ServiceNow® 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 la base de données qui sert d’instance du connecteur :

Nom de la vue

Description

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.

GLOBAL_CONFIG

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

ENABLED_TABLES

Fournit la liste des tables ServiceNow qui sont activées ou désactivées pour la synchronisation. Vous pouvez utiliser cette vue pour déterminer quelles tables sont activées pour la synchronisation.

TABLES_STATE

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

  • le statut de l’ingestion.

    • DONE signifie que les données synchronisé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 le journal des é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.

  • le calendrier de synchronisation.

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

WORKERS_STATE

Permet d’accéder aux informations relatives aux tables actuellement ingérées et au nombre de lignes qu’elles contiennent.

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 :

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. Ces notifications par e-mail comprennent :

  • Nombre d’erreurs rencontrées et type de chaque erreur.

  • Annonces lorsque de nouvelles versions du connecteur sont disponibles.

  • Rappels concernant l’actualisation des jetons OAuth.

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® 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 » Marketplace.

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

  4. Dans la page du Snowflake Connector for ServiceNow®, sélectionnez la vignette portant le titre Email Alerts.

  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 - Un e-mail est envoyé immédiatement en cas d’erreur.

    • Once per day - Un e-mail contenant un résumé de toutes les erreurs est envoyé une fois par jour. Option recommandée en cas d’utilisation d’une planification personnalisée.

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® 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 » Marketplace.

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

  4. Dans la page Snowflake Connector for ServiceNow®, sélectionnez Email Alerts.

  5. Sélectionnez le bouton puis sélectionnez Stop Receiving Alerts.

  6. Sélectionnez Confirm.

Sous le capot, l’objet intégration de notification SERVICENOW_GZSTZTP0KHD_NOTIFICATION, utilisé pour envoyer des alertes par e-mail, est créé. 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 USAGE sur cette intégration au rôle de connecteur en exécutant :

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

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

CALL CONFIGURE_ALERTS({
  'notificationIntegrationName': '<notification_integration_name>',
  'emailAddresses': ['<email_address>'],
  'scheduleType': '<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 : envoyer des notifications par e-mail une fois par jour. Option recommandée en cas d’utilisation d’une planification personnalisée.

  • LOWEST_INGESTION_SCHEDULE : envoyer des notifications par e-mail aussi souvent que la synchronisation planifiée la moins fréquente.

Par exemple, si vous avez défini un rôle pour votre connecteur nommé SN_ROLE, utilisez l’intégration de notification SN_EMAILS pour envoyer des notifications quotidiennes à l’adresse e-mail john.doe@snowflake.com , exécutez la commande suivante :

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

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.