Configuração do registro e o compartilhamento de eventos para um aplicativo¶

Fluxo de trabalho para configurar o registro e o compartilhamento de eventos como um provedor¶

Como provedor, você pode configurar o registro e o compartilhamento de eventos para um aplicativo executando o seguinte:

1. Revisão das considerações para usar o registro e o compartilhamento de eventos.

2. Configuração de eventos de registro e rastreamento para funções e procedimentos armazenados.

3. Definição do nível de registro e rastreamento no arquivo de manifesto.

4. Configuração de uma conta para armazenar eventos compartilhados.

Depois que o consumidor instalar um aplicativo e habilitar o registro e o compartilhamento de eventos, você pode visualizar o registro e as informações de eventos compartilhadas pelo aplicativo instalado:

• Exibição do nível de rastreamento e log.

• Exibição dos logs e eventos na tabela de eventos.

Considerações para usar o registro e o compartilhamento de eventos¶

Antes de usar o registro e o compartilhamento de eventos para um aplicativo, você deve considerar o seguinte:

• Você é responsável por todos os custos associados ao compartilhamento de eventos no lado do provedor, incluindo ingestão e armazenamento de dados.

• Você deve ter uma conta para armazenar eventos compartilhados em cada região onde você deseja oferecer suporte ao compartilhamento de eventos.

• Você deve definir o nível de log padrão e o nível de rastreamento para um aplicativo no arquivo de manifesto.

Configuração de eventos de registro e rastreamento em funções e procedimentos¶

O Native Apps Framework exige uma tabela de eventos para armazenar mensagens de log e rastrear eventos gerados a partir de funções e procedimentos armazenados em um aplicativo.

Uma conta pode ter várias tabelas de eventos, mas apenas uma delas pode ser definida como a tabela de eventos ativa para uma conta Snowflake por vez. Sem uma tabela de eventos ativa, as mensagens de log e os eventos de rastreamento gerados pelo aplicativo não são capturados. Isso se aplica mesmo se as funções e procedimentos em um aplicativo chamarem as APIs de evento de registro e rastreamento.

Para criar uma tabela de eventos, use o comando CREATE EVENT TABLE. Para obter mais informações, consulte Configuração de uma tabela de eventos.

Após o código ter registrado mensagens de log e eventos de rastreamento, você pode consultar os dados gravados.

Para obter informações sobre como registrar e consultar dados de log e rastreamento, consulte o seguinte:

• Registro de mensagens de funções e procedimentos.

• Eventos de rastreamento para funções e procedimentos.

Definição do nível de registro e rastreamento no arquivo de manifesto¶

Para definir os níveis de eventos de rastreamento e log padrão para uma versão de um aplicativo, defina os parâmetros log_level e trace_level no arquivo de manifesto, conforme mostrado no exemplo a seguir:

artifacts:
  setup_script: setup.sql
configuration:
  trace_level: OFF
  log_level: DEBUG

Quando um provedor ativa o rastreamento, um Snowflake Native App captura automaticamente as horas de início e término de todas as consultas e chamadas de procedimento armazenado.

Consulte Configuração do nível de rastreamento e Configuração do nível de registro para obter informações sobre os valores suportados para trace_level e log_level.

Quando o Snowflake Native App é instalado inicialmente, ele usa os níveis de log definidos no arquivo de manifesto. Se o nível de log for alterado em uma atualização subsequente, o novo nível de log entrará em vigor após a conclusão do processo de atualização.

O nível de rastreamento e log só podem ser definidos no arquivo de manifesto. O consumidor não tem permissão para modificar o nível de log usando os comandos ALTER APPLICATION ou ALTER DATABASE.

Da mesma forma, quaisquer configurações de nível de sessão para o nível de registro em log são ignoradas pelo aplicativo.

Configuração de uma conta para armazenar eventos compartilhados¶

Para armazenar logs e eventos compartilhados, você deve selecionar uma conta para armazenar uma tabela de eventos. Pode ser qualquer conta que um provedor possa acessar. No entanto, se sua organização tiver vários provedores publicando pacotes de aplicativos, considere usar uma conta Snowflake dedicada para armazenar eventos compartilhados do consumidor.

As seguintes restrições se aplicam à conta de eventos compartilhados:

• Você deve usar a função ORGADMIN para definir uma conta como a conta de eventos.

• A conta deve ter uma tabela de eventos ativos.

• A conta especificada não pode ser nenhuma das seguintes opções:

  • Uma conta bloqueada ou suspensa.

  • Uma conta de leitor.

  • Uma conta de avaliação.

  • Uma conta gerenciada do Snowflake.

CALL SYSTEM$SET_EVENT_SHARING_ACCOUNT_FOR_REGION('<snowflake_region>', '<region_group>', '<account_name>')

CALL SYSTEM$UNSET_EVENT_SHARING_ACCOUNT_FOR_REGION('<snowflake_region>', '<region_group>', '<account_name>')

CALL SYSTEM$SHOW_EVENT_SHARING_ACCOUNTS()

Exibição dos níveis de log e rastreamento de eventos definidos em um pacote de aplicativo¶

Use o comando DESCRIBE APPLICATION para visualizar o nível de registro em log de um aplicativo instalado, conforme mostrado no seguinte comando:

DESC APPLICATION HelloSnowflake;

Use o comando SHOW VERSIONS para visualizar o nível de registro em log das versões do aplicativo definidas em um pacote de aplicativo, conforme mostrado no exemplo a seguir:

SHOW VERSIONS
  IN APPLICATION PACKAGE HelloSnowflake;

Exibição dos logs e eventos na tabela de eventos¶

Para visualizar os logs e eventos armazenados na tabela de eventos, use o comando SELECT como mostrado no exemplo a seguir:

SELECT * FROM EVENT_DB.EVENT_SCHEMA.MY_EVENT_TABLE

Informações de eventos compartilhados disponíveis para o provedor¶

As seções a seguir descrevem as informações que o Native Apps Framework compartilha com os provedores.