监控 Snowflake Connector for ServiceNow®V2

本主题介绍如何监控 Snowflake Connector for ServiceNow®V2 的状态和解决问题。

本主题内容：

关于监控连接器

要监控 Snowflake Connector for ServiceNow®V2 的状态并解决问题，您可以通过以下视图访问连接器配置、错误消息和统计信息（这些视图在 连接器应用程序 的 PUBLIC 架构中定义）：

视图名称

描述

AGGREGATED_CONNECTOR_STATS

支持访问连接器在每个完整小时内更新的总行数（插入、修改和删除的记录）的信息。

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 – 至少一个表的引入已完成。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 Products 和 Apps。

  3. 搜索 Snowflake Connector for ServiceNow®V2，然后选择连接器的磁贴。

  4. 在 Snowflake Connector for ServiceNow®V2 的页面中，请选择上方栏中的 Settings 选项卡，然后从左侧列表中切换到 Email Alerts 部分。

  5. 在对话框中输入以下信息：

    字段

    描述

    Email Address

    应向其发送警报的单个电子邮件地址。您必须指定与 Snowflake 账户关联的电子邮件地址。

    Frequency

    有两个可能的值：

    • Immediately - 发生错误时，会立即发送电子邮件。

    • Once per day - 每天 12PM UTC 发送一次电子邮件，其中包含所有错误的摘要。

使用 Snowsight 禁用电子邮件通知

要禁用电子邮件警报，请导航到 Marketplace 中的 Snowflake Connector for ServiceNow®V2 应用程序：

  1. 以具有 ACCOUNTADMIN 角色的用户身份登录 Snowsight。

  2. 在导航菜单中，依次选择 Data Products 和 Apps。

  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

应向其发送电子邮件通知的电子邮件地址。

  • 只能指定一个电子邮件地址。

  • 必须在通知集成的 ALLOWED_RECIPIENTS 子句中指定此电子邮件地址。

schedule

通知的发送频率。指定以下值之一：

  • ONCE_PER_DAY：每天 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 启用电子邮件通知。

语言: 中文