コネクタのモニター

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

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

このトピックの内容:

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

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

ビュー名

説明

CONNECTOR_ERRORS

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

CONNECTOR_OVERVIEW

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

CONNECTOR_STATS

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

GLOBAL_CONFIG

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

ENABLED_TABLES

同期が有効または無効になっている ServiceNow テーブルのリストを提供します。このビューを使用して、同期が有効になっているテーブルを特定できます。

TABLES_STATE

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

  • インジェスチョンの状態。

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

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

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

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

  • 同期のスケジュール。

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

WORKERS_STATE

現在インジェストされているテーブルとそこに含まれる行数に関する情報へのアクセスを提供します。

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

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

メールアラートの構成

コネクタのメールアラートを有効にすることができます。コネクタは、 通知システムストアドプロシージャ を使用してメール通知を送信します。これらのメール通知には次が含まれます。

  • 発生したエラーの数と各エラーの種類。

  • コネクタの新しいバージョンが利用可能になったときのお知らせ。

  • OAuth トークンの更新に関するリマインダー。

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

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

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

  2. ナビゲーションメニューで Data Products » Marketplace を選択します。

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

  4. Snowflake Connector for ServiceNow® のページで、タイトルが Email Alerts のタイルを選択します。

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

    フィールド

    説明

    Email Address

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

    Frequency

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

    • Immediately - エラーが発生するとすぐにメールメッセージが送信されます。

    • Once per day - すべてのエラーの概要が記載されたメールメッセージが1日1回送信されます。カスタムスケジュール使用時の推奨オプション。

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

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

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

  2. ナビゲーションメニューで Data Products » Marketplace を選択します。

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

  4. Snowflake Connector for ServiceNow® のページで、 Email Alerts を選択します。

  5. ... ボタンを選択してから、 Stop Receiving Alerts を選択します。

  6. Confirm を選択します。

内部では、メールアラートの送信に使用される SERVICENOW_GZSTZTP0KHD_NOTIFICATION 通知統合 オブジェクトが作成されます。コネクタはこのオブジェクトを名前で参照します。このオブジェクトの名前を変更または削除すると、メールアラート機能は停止します。

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

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

通知統合を作成したら、次を実行して、この統合の USAGE をコネクタロールに付与する必要があります。

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

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

CALL CONFIGURE_ALERTS({
  'notificationIntegrationName': '<notification_integration_name>',
  'emailAddresses': ['<email_address>'],
  'scheduleType': '<schedule>'
});
Copy

条件:

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

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

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

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

CALL DISABLE_ALERTS();
Copy

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

言語: 日本語