Snowflake Connector for ServiceNow®V2 のモニター¶
Snowflake Connector for ServiceNow® V2は、 Snowflakeコネクタ規約 に従うものとします。
このトピックでは、 Snowflake Connector for ServiceNow®V2 の状態のモニターと問題をトラブルシューティングする方法について説明します。
このトピックの内容:
コネクタのモニターについて¶
Snowflake Connector for ServiceNow®V2 の状態をモニターし、問題をトラブルシューティングするため、コネクタの構成、エラーメッセージ、および統計に次のビューからアクセスできます。これらのビューは、 コネクタアプリケーション の PUBLIC
スキーマで定義されています。
ビュー名 |
説明 |
---|---|
|
1時間ごとにコネクタによって更新された行(挿入、変更、削除された記録)の総数に関する情報へのアクセスを提供します。 |
|
Snowflake Connector for ServiceNow®V2 がサポートするプロパティに関するユーザーインターフェースへの情報を提供します。 |
|
構成されている ServiceNow®テーブルのリストを提供します。このビューを使用して、同期が有効になっているテーブル、それらのインジェスチョン戦略、スケジュール、およびその他のインジェスチョンオプションを特定できます。 |
|
コネクタによって使用される構成設定の値のリストを提供します。 |
|
データのインジェスチョン中に発生したエラーへのアクセスを提供します。 |
|
コネクタに関する一般的な情報を提供します。 |
|
進行中のデータインジェスチョンプロセスと、各インジェスチョンの実行でコネクタによって収集されたデータ量に関する統計を提供します。 |
|
コネクタとインジェスチョンプロセスの一般的なステータスを提供します。
|
|
同期がこれまでに有効になったテーブルに関する情報へのアクセスを提供します。この情報には以下が含まれます。
|
|
現在インジェストされているテーブルと、それらに割り当てられたワーカータスクに関する情報へのアクセスを提供します。 |
上記のビューで表示されるすべてのタイムスタンプは、オフセットなしの UTC タイムゾーンで提供され、 ServiceNow インスタンスで表示される日付のタイムゾーンと異なる可能性があることに注意してください。
次のロールは、これらのビューにアクセスできます。
コネクタアプリケーション の所有者(通常は ACCOUNTADMIN システムロール)。
ADMIN または VIEWER アプリケーションロールが付与されているロール。
メールアラートの構成¶
コネクタのメールアラートを有効にすることができます。コネクタは、 通知システムストアドプロシージャ を使用してメール通知を送信します。アラートを構成するには、 まずコネクタをインストールする必要があります。発生したエラーの数と各エラーの種類を含むこれらのメール通知。
Snowsightを使用したメール通知の有効化¶
メールアラートを構成するには、Marketplaceにある Snowflake Connector for ServiceNow®V2 アプリケーションに移動します。
ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。
ナビゲーションメニューで Data Products、 Apps の順に選択します。
Snowflake Connector for ServiceNow®V2 を検索し、コネクタのタイルを選択します。
Snowflake Connector for ServiceNow®V2 のページで、上部バーにある Settings タブを選択し、左側のリストから Email Alerts セクションに切り替えます。
ダイアログボックスに次の情報を入力します。
フィールド
説明
Email Address
アラートの送信先となる単一のメールアドレス。Snowflakeアカウントに関連付けられているメールアドレスを指定する必要があります。
Frequency
使用できる値は2つあります。
Immediately - エラーは要約され、最も低く設定されたインジェスチョンスケジュールと同じ頻度でレポートが送信されます。
Once per day - すべてのエラーの概要が記載されたメールメッセージが1日1回、 12PM UTC に送信されます。
Snowsightを使用したメール通知の無効化¶
メールアラートを無効にするには、Marketplaceにある Snowflake Connector for ServiceNow®V2 アプリケーションに移動します。
ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。
ナビゲーションメニューで Data Products、 Apps の順に選択します。
Snowflake Connector for ServiceNow®V2 を検索し、コネクタのタイルを選択します。
Snowflake Connector for ServiceNow®V2 のページで、上部バーにある Settings タブを選択し、左側のリストから Email Alerts セクションに切り替えます。
Stop receiving alerts を選択し、再度 Stop receiving alerts を選択して確定します。
内部では、メールアラートの送信に使用される 通知統合 オブジェクトが作成されます。この統合の名前は、 コネクタアプリケーション の名前と同じで、接尾辞 _NOTIFICATION_INTEGRATION
が追加されています。コネクタはこのオブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。
SQL を使用したメール通知の有効化¶
メールアラートを構成するには、 通知統合 を作成する必要があります。
通知統合を作成したら、この統合に対する USAGE を コネクタアプリケーション に付与する必要があります。たとえば、 my_connector_servicenow
という名前のコネクタに次の権限を付与するには、次を行います。
GRANT USAGE ON INTEGRATION <notification_integration_name> TO APPLICATION <connector_application>;
メール アラートを構成して有効にするには、 CONFIGURE_ALERTS
プロシージャを呼び出します。
CALL CONFIGURE_ALERTS({ 'notification_integration_name': '<notification_integration_name>', 'email_addresses': ['<email_address>'], 'schedule_type': '<schedule>' });
条件:
notification_integration_name
メールアラートを送信するために作成した 通知統合 の識別子。
email_address
メール通知の送信先メールアドレス。
指定できるメールアドレスは1つだけです。
メールアドレスは、通知統合の ALLOWED_RECIPIENTS 句で指定する必要があります。
schedule
通知を送信する頻度。次の値のいずれかを指定します。
ONCE_PER_DAY: 1日1回、12PM UTC にメール通知を送信します。
LOWEST_INGESTION_SCHEDULE: エラー発生後、即座にメール通知を送信します。
たとえば、コネクタアプリケーションに MY_CONNECTOR_SERVICENOW という名前を付けた場合、通知統合 SN_EMAILS
を使用してメール通知を john.doe@snowflake.com
メールに毎日送信するには、次のコマンドを実行します。
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' });
コネクタは 通知統合 オブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。
SQL を使用したメール通知の無効化¶
メール通知を無効にするには、 DISABLE_ALERTS()
ストアドプロシージャを呼び出します。
CALL DISABLE_ALERTS();
メール通知を再度有効にする必要がある場合は、 Snowsightを使用したメール通知の有効化 をご参照ください。