Eventos de rastreamento para funções e procedimentos¶

Exemplo de rastreamento¶

O código Python no exemplo a seguir define um atributo example.proc.do_tracing no span com um valor de begin. Ele também emite dentro do span um evento event_with_attributes com atributos example.key1 e example.key2.

CREATE OR REPLACE PROCEDURE do_tracing()
RETURNS VARIANT
LANGUAGE PYTHON
PACKAGES=('snowflake-snowpark-python', 'snowflake-telemetry-python')
RUNTIME_VERSION=3.8
HANDLER='run'
AS $$
from snowflake import telemetry
def run(session):
  telemetry.set_span_attribute("example.proc.do_tracing", "begin")
  telemetry.add_event("event_with_attributes", {"example.key1": "value1", "example.key2": "value2"})
  return "SUCCESS"
$$;

Introdução¶

Para começar a usar os rastreamentos de eventos do código do manipulador, siga estas etapas de alto nível:

1. Configure uma tabela de eventos.

   O Snowflake usa sua tabela de eventos para armazenar dados de eventos emitidos pelo seu código do manipulador. Uma tabela de eventos tem colunas predefinidas pelo Snowflake.

2. Familiarize-se com a API de rastreamento de eventos para a linguagem do manipulador que você usará.

   Consulte Linguagens suportadas para obter uma lista de linguagens de manipuladores e, em seguida, veja o conteúdo sobre como emitir eventos de rastreamento de sua linguagem.

3. Adicione o código de rastreamento de eventos ao seu manipulador.

4. Saiba como recuperar dados de rastreamento de eventos da tabela de eventos.

Nível para eventos de rastreamento¶

Você pode gerenciar o detalhamento dos dados de eventos de rastreamento armazenados na tabela de eventos definindo o nível de rastreamento. Antes de rastrear, use essa configuração para ter certeza de que está capturando a gravidade da mensagem de registro. Se você achar que os dados do evento não estão sendo gravados na tabela, verifique o nível de rastreamento para garantir que ele esteja permitindo os dados desejados.

Para obter mais informações, consulte Configuração do nível de rastreamento.

Linguagens suportadas¶

É possível rastrear eventos da função e procedimento escrito nas seguintes linguagens, inclusive quando o código do manipulador é escrito com Snowpark APIs.

*

Manipulador de UDTF Scala escrito em Snowpark.

Acesso a dados de eventos¶

Você pode acessar dados pares executando um comando SELECT na tabela de eventos. Para obter mais informações, consulte Acesso a dados de rastreamento.