Monitoramento do conector¶

Este tópico descreve como monitorar o estado do conector Snowflake para ServiceNow e solucionar problemas.

Neste tópico:

Sobre o monitoramento do conector¶

Para monitorar o estado do conector Snowflake para 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.

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 conector Snowflake para o aplicativo ServiceNow no Marketplace:

Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
Na navegação da esquerda, selecione Marketplace.
Procure o conector do Snowflake para 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 conector Snowflake para o aplicativo ServiceNow no Marketplace:

Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
Na navegação da esquerda, selecione Marketplace.
Procure o conector do Snowflake para ServiceNow, depois selecione o bloco para o 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.