Monitoramento do conector¶

O conector Snowflake para ServiceNow® está sujeito aos Termos do conector.

Este tópico descreve como monitorar o estado do Snowflake Connector for ServiceNow® e solucionar problemas.

Neste tópico:

Sobre o monitoramento do conector¶

Para monitorar o estado do Snowflake Connector for ServiceNow® e solucionar problemas, você pode acessar a configuração do conector, mensagens de erro e estatísticas através das seguintes exibições, que estão definidas no esquema PUBLIC no banco de dados que serve uma instância do conector:

Nome da exibição	Descrição
`CONNECTOR_ERRORS`	Fornece acesso aos erros que ocorreram durante a ingestão de dados.
`CONNECTOR_OVERVIEW`	Fornece informações gerais sobre o conector.
`CONNECTOR_STATS`	Fornece estatísticas sobre o processo de ingestão de dados em andamento e a quantidade de dados coletados por conector.
`GLOBAL_CONFIG`	Fornece uma lista dos valores dos ajustes de configuração usados pelo conector.
`ENABLED_TABLES`	Fornece a lista de tabelas do ServiceNow que estão habilitadas ou desabilitadas para sincronização. Você pode usar esta exibição para determinar quais tabelas estão habilitadas para sincronização.
`TABLES_STATE`	Fornece acesso às informações sobre as tabelas que foram habilitadas para sincronização. Estas informações incluem: o status da ingestão. `DONE` significa que os dados buscados estão disponíveis na tabela de sincronização. `RUNNING` significa que o download está em andamento ou os dados já foram buscados no log de eventos, mas a tabela de sincronização ainda não foi atualizada. `FAILED` significa que a execução de ingestão foi interrompida devido a um erro. Isso pode resultar no download de apenas parte dos dados. Isso não causará qualquer discrepância de dados e, dependendo da estratégia de ingestão, alguns lotes poderão ser recolhidos novamente. `DISABLED` significa que determinada tabela foi desativada no meio desta execução de ingestão. o cronograma de sincronização. o carimbo de data/hora da última sincronização programada.
`WORKERS_STATE`	Fornece acesso às informações sobre as tabelas atualmente ingeridas e o número de linhas que elas contêm.

Observe que todos os carimbos de data/hora exibidos nas exibições acima são fornecidos no fuso horário UTC sem offfset, que pode ser diferente do fuso horário das datas exibidas pela instância ServiceNow.

As seguintes funções têm acesso a essas exibições:

A função ACCOUNTADMIN do sistema.
A função a qual você delegou privilégios de configuração para, por exemplo, a função connector_config_role.

Configuração de alertas por e-mail¶

Você pode ativar os alertas por e-mail para o conector. O conector usa o Sistema de notificação Procedimento armazenado para enviar as notificações por e-mail. Essas notificações por e-mail incluem:

O número de erros encontrados e o tipo de cada erro.
Anúncios quando novas versões do conector estiverem disponíveis.
Lembretes sobre atualização dos tokens de OAuth.

Como habilitar as notificações por e-mail usando Snowsight¶

Para configurar alertas de e-mail, navegue até o aplicativo Snowflake Connector for ServiceNow® no Marketplace:

Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
No menu de navegação, selecione Data Products » Marketplace.
Procure o Snowflake Connector for ServiceNow®, depois selecione o bloco para o conector.
Na página do Snowflake Connector for ServiceNow®, selecione o bloco com o título Email Alerts.

Digite as seguintes informações na caixa de diálogo:

Campo	Descrição
Email Address	Endereço de e-mail único para onde os alertas devem ser enviados. Você deve especificar um endereço de e-mail que esteja associado à conta Snowflake.
Frequency	Há dois valores possíveis: Immediately - Uma mensagem de e-mail é enviada imediatamente quando ocorre um erro. Once per day - Uma mensagem de e-mail com um resumo de todos os erros é enviada uma vez por dia. Opção recomendada quando o cronograma personalizado é usado.

Campo

Descrição

Email Address

Endereço de e-mail único para onde os alertas devem ser enviados. Você deve especificar um endereço de e-mail que esteja associado à conta Snowflake.

Frequency

Há dois valores possíveis:

Immediately - Uma mensagem de e-mail é enviada imediatamente quando ocorre um erro.
Once per day - Uma mensagem de e-mail com um resumo de todos os erros é enviada uma vez por dia. Opção recomendada quando o cronograma personalizado é usado.

Como desabilitar as notificações por e-mail usando Snowsight¶

Para desativar os alertas de e-mail, navegue até o aplicativo Snowflake Connector for ServiceNow® no Marketplace:

Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
No menu de navegação, selecione Data Products » Marketplace.
Procure o conector Snowflake para ServiceNow®, depois selecione o bloco do conector.
Na página do Snowflake Connector for ServiceNow®, selecione Email Alerts.
Selecione o botão …, depois selecione Stop Receiving Alerts.
Selecione Confirm.

Nos bastidores, é criado o objeto de SERVICENOW_GZSTZTP0KHD_NOTIFICATION integração de notificação, usado para enviar alertas por e-mail. O conector faz referência a esse objeto por nome. Alterar o nome deste objeto ou descartá-lo faz com que a funcionalidade de alertas por e-mail seja interrompida.

Habilitação de notificações por e-mail usando SQL¶

Para configurar os alertas por e-mail, você deve criar uma integração de notificação.

Após criar a integração de notificação, você deve conceder USAGE nesta integração à função do conector, executando:

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

Copy

Para configurar e ativar os alertas por e-mail, chame o procedimento CONFIGURE_ALERTS:

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

Copy

Onde:

notification_integration_name

Identificador da integração da notificação que você criou para enviar os alertas por e-mail.

email_address

Endereço de e-mail para onde as notificações por e-mail devem ser enviadas.

Você pode especificar apenas um endereço de e-mail.
O endereço de e-mail deve ser especificado na cláusula ALLOWED_RECIPIENTS da integração da notificação.

schedule

A frequência com que as notificações devem ser enviadas. Especifique um dos seguintes vaores:

ONCE_PER_DAY: enviar notificações por e-mail uma vez por dia. Opção recomendada quando o cronograma personalizado é usado.
LOWEST_INGESTION_SCHEDULE: enviar notificações por e-mail com a mesma frequência de sincronização menos frequente.

Por exemplo, se você definiu uma função para seu conector chamado SN_ROLE, use a integração da notificação SN_EMAILS para enviar notificações diárias por e-mail para john.doe@snowflake.com, execute o seguinte comando:

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

O conector faz referência ao objeto de integração de notificação por nome. Alterar o nome deste objeto ou descartá-lo faz com que a funcionalidade de alertas por e-mail seja interrompida.

Como desabilitar as notificações por e-mail usando SQL¶

Para desativar as notificações por e-mail, chame o procedimento armazenado DISABLE_ALERTS():

CALL DISABLE_ALERTS();

Copy

Se você precisar ativar as notificações por e-mail novamente, consulte Como habilitar as notificações por e-mail usando Snowsight.