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 |
---|---|
|
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. |
|
Fournit des informations à l’interface utilisateur sur les propriétés prises en charge par Snowflake Connector for ServiceNow®V2. |
|
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. |
|
Fournit une liste des valeurs des paramètres de configuration utilisés par le connecteur. |
|
Permet d’accéder aux erreurs survenues lors de l’ingestion des données. |
|
Fournit des informations générales sur le connecteur. |
|
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. |
|
Fournit le statut général du connecteur et du processus d’ingestion :
|
|
Permet d’accéder à des informations sur les tables pour lesquelles la synchronisation a déjà été activée. Informations comprises :
|
|
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.
Dans le menu de navigation, sélectionnez Data Products, puis Apps.
Recherchez le Snowflake Connector for ServiceNow®V2, puis sélectionnez la vignette du connecteur.
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.
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 :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.
Dans le menu de navigation, sélectionnez Data Products, puis Apps.
Recherchez le Snowflake Connector for ServiceNow®V2, puis sélectionnez la vignette du connecteur.
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.
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>;
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>' });
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' });
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();
Si vous devez réactiver les notifications par e-mail, voir Activation des notifications par e-mail à l’aide de Snowsight.