コネクタのモニター¶
このトピックでは、 ServiceNow 用Snowflakeコネクタの状態をモニターし、問題をトラブルシューティングする方法について説明します。
このトピックの内容:
コネクタのモニターについて¶
ServiceNow 用Snowflakeコネクタの状態をモニターし、問題をトラブルシューティングするため、コネクタの構成、エラーメッセージ、および統計に次のビューからアクセスできます。これらのビューは、 コネクタのインスタンスとして機能するデータベース の PUBLIC
スキーマで定義されています。
ビュー名 |
説明 |
---|---|
|
データのインジェスチョン中に発生したエラーへのアクセスを提供します。 |
|
コネクタに関する一般的な情報を提供します。 |
|
進行中のデータインジェスチョンプロセスとコネクタによって収集されたデータの量に関する統計を提供します。 |
|
コネクタによって使用される構成設定の値のリストを提供します。 |
|
同期が有効または無効になっている ServiceNow テーブルのリストを提供します。このビューを使用して、同期が有効になっているテーブルを特定できます。 |
|
同期が有効になっているテーブルに関する情報へのアクセスを提供します。この情報には以下が含まれます。
|
|
現在インジェストされているテーブルとそこに含まれる行数に関する情報へのアクセスを提供します。 |
次のロールは、これらのビューにアクセスできます。
ACCOUNTADMIN システムロール。
構成権限の委任先 ロール(例:
connector_config_role
ロール)。
メールアラートの構成¶
コネクタのメールアラートを有効にすることができます。コネクタは、 通知システムストアドプロシージャ を使用してメール通知を送信します。これらのメール通知には次が含まれます。
発生したエラーの数と各エラーの種類。
コネクタの新しいバージョンが利用可能になったときのお知らせ。
OAuth トークンの更新に関するリマインダー。
Snowsightを使用したメール通知の有効化¶
メールアラートを構成するには、Marketplaceにある ServiceNow アプリケーション用Snowflakeコネクタに移動します。
ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。
左側のナビゲーションで Marketplace を選択します。
ServiceNow 用Snowflakeコネクタを検索し、コネクタのタイルを選択します。
Snowflake Connector for ServiceNow のページで、タイトルが Email Alerts のタイルを選択します。
ダイアログボックスに次の情報を入力します。
フィールド
説明
Email Address
アラートの送信先となる単一のメールアドレス。Snowflakeアカウントに関連付けられているメールアドレスを指定する必要があります。
Frequency
使用できる値は2つあります。
Immediately - エラーが発生するとすぐにメールメッセージが送信されます。
Once per day - すべてのエラーの概要が記載されたメールメッセージが1日1回送信されます。カスタムスケジュール使用時の推奨オプション。
Snowsightを使用したメール通知の無効化¶
メールアラートを無効にするには、Marketplaceにある ServiceNow アプリケーション用Snowflakeコネクタに移動します。
ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。
左側のナビゲーションで Marketplace を選択します。
ServiceNow 用Snowflakeコネクタを検索し、コネクタのタイルを選択します。
Snowflake Connector for ServiceNow のページで、 Email Alerts を選択します。
... ボタンを選択してから、 Stop Receiving Alerts を選択します。
Confirm を選択します。
内部では、メールアラートの送信に使用される SERVICENOW_GZSTZTP0KHD_NOTIFICATION
通知統合 オブジェクトが作成されます。コネクタはこのオブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。
SQL を使用したメール通知の有効化¶
メールアラートを構成するには、 通知統合 を作成する必要があります。
通知統合を作成したら、次を実行して、この統合の USAGE をコネクタロールに付与する必要があります。
GRANT USAGE ON INTEGRATION <notification_integration_name> TO ROLE <connector_resources_provider>;
メール アラートを構成して有効にするには、 CONFIGURE_ALERTS
プロシージャを呼び出します。
CALL CONFIGURE_ALERTS({ 'notificationIntegrationName': '<notification_integration_name>', 'emailAddresses': ['<email_address>'], 'scheduleType': '<schedule>' });
条件:
notification_integration_name
メールアラートを送信するために作成した 通知統合 の識別子。
email_address
メール通知の送信先メールアドレス。
指定できるメールアドレスは1つだけです。
メールアドレスは、通知統合の ALLOWED_RECIPIENTS 句で指定する必要があります。
schedule
通知を送信する頻度。次の値のいずれかを指定します。
ONCE_PER_DAY: メール通知を1日1回送信します。カスタムスケジュール使用時の推奨オプション。
LOWEST_INGESTION_SCHEDULE: 最も頻度の低いスケジュールされた同期と同じ頻度でメール通知を送信します。
たとえば、 SN_ROLE
という名前のコネクタのロールを定義した場合、通知統合 SN_EMAILS
を使用して日次でメール通知を john.doe@snowflake.com
メールに送信するには、次のコマンドを実行します。
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' });
コネクタは 通知統合 オブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。
SQL を使用したメール通知の無効化¶
メール通知を無効にするには、 DISABLE_ALERTS()
ストアドプロシージャを呼び出します。
CALL DISABLE_ALERTS();
メール通知を再度有効にする必要がある場合は、 Snowsightを使用したメール通知の有効化 をご参照ください。