监控连接器

Snowflake Connector for ServiceNow® 受 Connector 条款 的约束。

本主题介绍如何监控 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 实例显示的日期所在时区不同。

以下角色有权访问这些视图：

  • ACCOUNTADMIN 系统角色。

  • 您已 向其委派配置权限 <label-servicenow_connector_delegating_privileges>`的角色，例如 ``connector_config_role` 角色。

配置电子邮件警报

您可以为连接器启用电子邮件警报。连接器使用 通知系统存储过程 发送电子邮件通知。这些电子邮件通知包括：

  • 遇到的错误数和每个错误的类型。

  • 连接器的新版本可用时的公告。

  • 有关刷新 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

    有两个可能的值：

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

    • Once per day - 每天发送一次电子邮件，其中包含所有错误的摘要。使用自定义计划时，建议选中此选项。

使用 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. 选择 ... 按钮，然后选择 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

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

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

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

schedule

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

  • ONCE_PER_DAY：每天发送一次电子邮件通知。使用自定义计划时，建议选中此选项。

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

语言: 中文