Monitoramento do Snowflake Connector for ServiceNow®V2

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

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

Neste tópico:

Sobre o monitoramento do conector

Para monitorar o estado do Snowflake Connector for ServiceNow®V2 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 do aplicativo do conector:

Nome da exibição

Descrição

AGGREGATED_CONNECTOR_STATS

Fornece acesso a informações sobre o número total de linhas atualizadas pelo conector (registros inseridos, modificados e excluídos) em cada hora completa.

APP_PROPERTIES

Fornece informações à interface do usuário sobre as propriedades compatíveis com o Snowflake Connector for ServiceNow®V2

CONFIGURED_TABLES

Fornece a lista de tabelas do ServiceNow® configuradas. Você pode usar esta exibição para determinar quais tabelas estão habilitadas para sincronização, sua estratégia de ingestão, cronograma e outras opções de ingestão.

CONNECTOR_CONFIGURATION

Fornece uma lista dos valores dos ajustes de configuração usados pelo conector.

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 pelo conector em cada execução de ingestão.

SYNC_STATUS

Fornece o status geral do conector e o processo de ingestão:

  • PAUSED – o conector está pausado ou em processo de retomada e não há ingestão de nenhuma tabela em andamento.

  • NOT_SYNCING – o conector está pronto para ingerir dados, mas ainda não ingeriu nenhum dado.

  • SYNCING_DATA – o conector está ingerindo dados, mas não há nenhuma tabela para a qual a ingestão já tenha terminado.

  • LAST_SYNCED – a ingestão de pelo menos uma tabela foi concluída. carimbo de data/hora da última ingestão concluída é fornecido na coluna LAST_SYNCED_AT.

TABLES_STATE

Fornece acesso a informações sobre as tabelas já habilitadas para sincronização. Estas informações incluem:

  • o status da tabela – se ela está habilitada, desabilitada ou no meio da recarga.

  • o status da última 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 na tabela de 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 carimbo de data/hora da última sincronização programada.

  • o tamanho da página usado nas solicitações que coletam dados para a tabela.

  • o status da criação de exibições niveladas.

  • o carimbo de data/hora da última vez em que o conector verificou se as exibições niveladas da tabela precisavam ser recriadas.

WORKERS_STATE

Fornece acesso a informações sobre tabelas atualmente ingeridas e quando as tarefas do trabalhador foram atribuídas a ele.

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:

  • O dono do aplicativo do conector (geralmente a função do sistema ACCOUNTADMIN).

  • Qualquer função com a função de aplicativo ADMIN ou VIEWER concedida.

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. Para configurar alertas, o conector primeiro deve ser instalado. Essas notificações por e-mail incluem o número de erros encontrados e o tipo de cada erro.

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

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

  1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.

  2. No menu de navegação, selecione Data Products e, em seguida, Apps.

  3. Procure o Snowflake Connector for ServiceNow®V2, depois selecione o bloco para o conector.

  4. Na página para o Snowflake Connector for ServiceNow®V2, selecione a aba Settings na barra superior e depois mude para a seção Email Alerts da lista à esquerda.

  5. 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 – Os erros são resumidos e o relatório é enviado com a frequência do menor cronograma de ingestão configurado.

    • Once per day – Uma mensagem de e-mail com um resumo de todos os erros é enviada uma vez por dia às 12PM UTC.

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®V2 no Marketplace:

  1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.

  2. No menu de navegação, selecione Data Products e, em seguida, Apps.

  3. Procure o Snowflake Connector for ServiceNow®V2, depois selecione o bloco para o conector.

  4. Na página para o Snowflake Connector for ServiceNow®V2, selecione a aba Settings na barra superior e depois mude para a seção Email Alerts da lista à esquerda.

  5. Selecione Stop receiving alerts e confirme, selecionando novamente Stop receiving alerts.

Nos bastidores, é criado um objeto de integração de notificação usado para enviar alertas por e-mail. O nome desta integração é o mesmo que o nome do aplicativo do conector com um sufixo adicionado _NOTIFICATION_INTEGRATION. 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 ao aplicativo do conector. Por exemplo, para conceder os seguintes privilégios ao conector nomeado my_connector_servicenow:

GRANT USAGE ON INTEGRATION <notification_integration_name> TO APPLICATION <connector_application>;
Copy

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

CALL CONFIGURE_ALERTS({
  'notification_integration_name': '<notification_integration_name>',
  'email_addresses': ['<email_address>'],
  'schedule_type': '<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: Envia notificações por e-mail uma vez por dia às 12PM UTC.

  • LOWEST_INGESTION_SCHEDULE: Envia notificações por e-mail imediatamente após a ocorrência de um erro.

Por exemplo, se você nomeou o aplicativo do conector como MY_CONNECTOR_SERVICENOW, use a integração de notificação SN_EMAILS para enviar notificações diárias por e-mail ao endereço de e-mail john.doe@snowflake.com e execute os seguintes comandos:

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

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.