Snowflake Connector for ServiceNow®V2 のモニター

Snowflake Connector for ServiceNow® V2は、 Snowflakeコネクタ規約 に従うものとします。

このトピックでは、 Snowflake Connector for ServiceNow®V2 の状態のモニターと問題をトラブルシューティングする方法について説明します。

このトピックの内容:

コネクタのモニターについて

Snowflake Connector for ServiceNow®V2 の状態をモニターし、問題をトラブルシューティングするため、コネクタの構成、エラーメッセージ、および統計に次のビューからアクセスできます。これらのビューは、 コネクタアプリケーションPUBLIC スキーマで定義されています。

ビュー名

説明

AGGREGATED_CONNECTOR_STATS

1時間ごとにコネクタによって更新された行(挿入、変更、削除された記録)の総数に関する情報へのアクセスを提供します。

APP_PROPERTIES

Snowflake Connector for ServiceNow®V2 がサポートするプロパティに関するユーザーインターフェースへの情報を提供します。

CONFIGURED_TABLES

構成されている ServiceNow®テーブルのリストを提供します。このビューを使用して、同期が有効になっているテーブル、それらのインジェスチョン戦略、スケジュール、およびその他のインジェスチョンオプションを特定できます。

CONNECTOR_CONFIGURATION

コネクタによって使用される構成設定の値のリストを提供します。

CONNECTOR_ERRORS

データのインジェスチョン中に発生したエラーへのアクセスを提供します。

CONNECTOR_OVERVIEW

コネクタに関する一般的な情報を提供します。

CONNECTOR_STATS

進行中のデータインジェスチョンプロセスと、各インジェスチョンの実行でコネクタによって収集されたデータ量に関する統計を提供します。

SYNC_STATUS

コネクタとインジェスチョンプロセスの一般的なステータスを提供します。

  • PAUSED - コネクタは現在一時停止中か再開中で、現在進行中のテーブルのインジェスチョンはありません。

  • NOT_SYNCING - コネクタはデータをインジェストする準備ができていますが、データはまだインジェストされていません。

  • SYNCING_DATA - コネクタはデータをインジェストしていますが、インジェスチョンが終了したテーブルはまだありません。

  • LAST_SYNCED - 少なくとも1つのテーブルのインジェスチョンが終了しました。最後にインジェスチョンが終了したタイムスタンプは、 LAST_SYNCED_AT 列に提供されます。

TABLES_STATE

同期がこれまでに有効になったテーブルに関する情報へのアクセスを提供します。この情報には以下が含まれます。

  • テーブルのステータス - 有効、無効、リロード中のいずれかです。

  • 最後のインジェスチョンのステータス。

    • DONE は、フェッチされたデータが同期テーブルで利用できることを意味します。

    • RUNNING は、ダウンロードが進行中であるか、データは既にイベントログにフェッチされているけれども、同期テーブルがまだ更新されていなかったことを意味します。

    • FAILED は、インジェスチョン実行がエラーのために中断されたことを意味します。その結果、データの一部のみがダウンロードされている場合があります。これにより、データの不一致が生じることはありません。また、データのインジェスチョン戦略によっては、いくつかのバッチが再度収集される可能性があります。

    • DISABLED は、指定されたテーブルがこのインジェスチョン実行の途中で無効になったことを意味します。

  • 最後にスケジュールされた同期のタイムスタンプ。

  • テーブルのデータを収集するリクエストで使用されるページサイズ。

  • フラット化されたビューの作成ステータス。

  • コネクタが、テーブルのフラット化されたビューを再作成する必要があるかどうかを最後に確認したときのタイムスタンプ。

WORKERS_STATE

現在インジェストされているテーブルと、それらに割り当てられたワーカータスクに関する情報へのアクセスを提供します。

上記のビューで表示されるすべてのタイムスタンプは、オフセットなしの UTC タイムゾーンで提供され、 ServiceNow インスタンスで表示される日付のタイムゾーンと異なる可能性があることに注意してください。

次のロールは、これらのビューにアクセスできます。

  • コネクタアプリケーション の所有者(通常は ACCOUNTADMIN システムロール)。

  • ADMIN または VIEWER アプリケーションロールが付与されているロール。

メールアラートの構成

コネクタのメールアラートを有効にすることができます。コネクタは、 通知システムストアドプロシージャ を使用してメール通知を送信します。アラートを構成するには、 まずコネクタをインストールする必要があります。発生したエラーの数と各エラーの種類を含むこれらのメール通知。

Snowsightを使用したメール通知の有効化

メールアラートを構成するには、Marketplaceにある Snowflake Connector for ServiceNow®V2 アプリケーションに移動します。

  1. ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。

  2. ナビゲーションメニューで Data ProductsApps の順に選択します。

  3. Snowflake Connector for ServiceNow®V2 を検索し、コネクタのタイルを選択します。

  4. Snowflake Connector for ServiceNow®V2 のページで、上部バーにある Settings タブを選択し、左側のリストから Email Alerts セクションに切り替えます。

  5. ダイアログボックスに次の情報を入力します。

    フィールド

    説明

    Email Address

    アラートの送信先となる単一のメールアドレス。Snowflakeアカウントに関連付けられているメールアドレスを指定する必要があります。

    Frequency

    使用できる値は2つあります。

    • Immediately - エラーは要約され、最も低く設定されたインジェスチョンスケジュールと同じ頻度でレポートが送信されます。

    • Once per day - すべてのエラーの概要が記載されたメールメッセージが1日1回、 12PM UTC に送信されます。

Snowsightを使用したメール通知の無効化

メールアラートを無効にするには、Marketplaceにある Snowflake Connector for ServiceNow®V2 アプリケーションに移動します。

  1. ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。

  2. ナビゲーションメニューで Data ProductsApps の順に選択します。

  3. Snowflake Connector for ServiceNow®V2 を検索し、コネクタのタイルを選択します。

  4. Snowflake Connector for ServiceNow®V2 のページで、上部バーにある Settings タブを選択し、左側のリストから Email Alerts セクションに切り替えます。

  5. Stop receiving alerts を選択し、再度 Stop receiving alerts を選択して確定します。

内部では、メールアラートの送信に使用される 通知統合 オブジェクトが作成されます。この統合の名前は、 コネクタアプリケーション の名前と同じで、接尾辞 _NOTIFICATION_INTEGRATION が追加されています。コネクタはこのオブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。

SQL を使用したメール通知の有効化

メールアラートを構成するには、 通知統合 を作成する必要があります。

通知統合を作成したら、この統合に対する USAGE を コネクタアプリケーション に付与する必要があります。たとえば、 my_connector_servicenow という名前のコネクタに次の権限を付与するには、次を行います。

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

メール アラートを構成して有効にするには、 CONFIGURE_ALERTS プロシージャを呼び出します。

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

条件:

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'
});
Copy

コネクタは 通知統合 オブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。

SQL を使用したメール通知の無効化

メール通知を無効にするには、 DISABLE_ALERTS() ストアドプロシージャを呼び出します。

CALL DISABLE_ALERTS();
Copy

メール通知を再度有効にする必要がある場合は、 Snowsightを使用したメール通知の有効化 をご参照ください。