Visão geral do registro e do rastreamento¶

É possível registrar a atividade do código do manipulador de funções e procedimentos do Snowflake (incluindo o código que você escreve usando APIs Snowpark) capturando mensagens de log e eventos de rastreamento do código à medida que ele é executado. Depois de coletar os dados, você pode consultá-los com SQL para analisar os resultados.

Em especial, é possível registrar e analisar o seguinte:

Mensagens de log que são mensagens independentes e detalhadas com informações sobre o estado de uma parte específica do seu código.
Evento de rastreamento com dados estruturados que você pode usar para obter informações que abrangem e agrupam várias partes do seu código.

Introdução¶

Use as seguintes etapas de alto nível para começar a capturar e usar dados de registro e rastreamento.

Crie uma tabela de eventos.

No Snowflake, você armazena seus dados de registro e rastreamento em uma tabela de eventos, um tipo especial de tabela com um conjunto predefinido de colunas.
Comece a emitir dados de registro ou rastreamento do código do manipulador.

Depois de criar uma tabela de eventos e associá-la à sua conta, use uma API na linguagem do seu manipulador para emitir mensagens de registro do código do manipulador. Depois de capturar dados de registro e rastreamento, você pode consultar os dados para analisar os resultados.

Para obter mais informações, consulte:
- Registro de mensagens de funções e procedimentos
- Eventos de rastreamento para funções e procedimentos
Consulte a tabela de eventos para analisar os dados de registro e rastreamento coletados.

Para obter mais informações, consulte o seguinte:
- Acesso a dados de mensagens registradas
- Acesso a dados de rastreamento

Comparação de mensagens de registro e eventos de rastreamento¶

A tabela a seguir compara as características e os benefícios das mensagens de registro e dos eventos de rastreamento.

Característica	Entradas de registro	Eventos de rastreamento
Uso pretendido	Registre informações detalhadas, mas não estruturadas, sobre o estado do seu código. Use essas informações para entender o que aconteceu durante uma determinada invocação de sua função ou procedimento.	Registre um resumo breve, mas estruturado, de cada invocação do seu código. Agregue essas informações para entender o comportamento do seu código em um nível elevado.
Estrutura como carga útil	Nenhum. Uma entrada de registro é apenas uma cadeia de caracteres.	Estruturada com atributos que você pode anexar aos eventos de rastreamento. Os atributos são pares chave-valor que podem ser facilmente consultados com uma consulta SQL.
Oferece suporte a agrupamento	Não. Cada entrada de registro é um evento independente.	Sim. Os eventos de rastreamento são organizados em spans. Um span pode ter seus próprios atributos.
Limites de quantidade	Ilimitado. Todas as entradas de registro emitidas pelo seu código são ingeridas na tabela de eventos.	O número de eventos de rastreamento por span é limitado a 128. Há também um limite para o número de atributos de span.
Complexidade das consultas aos dados registrados	Relativamente alto. Suas consultas devem analisar cada entrada de registro para extrair informações significativas.	Relativamente baixo. Suas consultas podem tirar proveito da natureza estruturada dos eventos de rastreamento.