Definição de níveis para registro, métricas e rastreamento¶

Escopo¶

Para cada tipo de dados de telemetria, é possível definir níveis para que eles entrem em vigor no escopo que melhor atenda às suas exigências. Em muitos casos, você pode substituir níveis definidos em um escopo maior, configurando-os em um escopo menor, conforme descrito em Como o Snowflake determina o nível de efeito. Por exemplo, talvez você queira ter um conjunto de níveis padrão no escopo da conta e, em seguida, definir níveis diferentes para objetos em um determinado banco de dados.

É possível definir cada um deles nos seguintes escopos:

Conta:

Um nível definido para a conta está em vigor em todos os lugares da conta, exceto quando substituído ao ser definido no nível do objeto ou da sessão.

Objeto:

É possível definir os níveis de telemetria nos seguintes tipos de objetos:

• Banco de dados ou esquema que contém procedimentos e funções

• Procedimento armazenado

• Função definida pelo usuário (UDF) ou uma função de tabela definida pelo usuário (UDTF)

Por exemplo, para definir o nível de registro para uma UDF específica, use ALTER FUNCTION para definir o parâmetro LOG_LEVEL para essa UDF. Como outro exemplo, para definir o nível de registro padrão para todas as funções e procedimentos em um banco de dados, use ALTER DATABASE para definir o parâmetro LOG_LEVEL nesse banco de dados.

Nota

Não é possível definir o nível em objetos Streamlit. Em vez disso, defina o nível no banco de dados ou esquema que contém o objeto.

Sessão:

Você pode definir o nível de telemetria para chamadas a funções e procedimentos feitas na sessão atual.

Níveis¶

Você pode definir os seguintes níveis para cada tipo de dados de telemetria:

Registro:

Ao definir um nível, apenas os dados naquele nível e níveis mais severos são capturados em uma tabela de eventos e estão visíveis em Snowsight. Por exemplo, definir o parâmetro LOG_LEVEL como WARN significa que as mensagens nos níveis WARN, ERROR e FATAL são capturadas na tabela de eventos.

Ajuste o parâmetro LOG_LEVEL.

Métricas:

Atualmente, é possível ter todos os dados de métricas capturados ou nenhum.

Ajuste o parâmetro METRIC_LEVEL.

Rastreamento:

É possível especificar as seguintes características:

• Escopo dos dados de eventos de rastreamento armazenados na tabela de eventos

  Ajuste o parâmetro TRACE_LEVEL.

• Se o texto SQL será capturado em uma instrução SQL rastreada

  Isso é determinado pelo parâmetro SQL_TRACE_QUERY_TEXT. Para obter mais informações, consulte Rastreamento de instruções SQL.

Privilégios necessários¶

Para definir níveis em um objeto, é necessário usar uma função que receba ou herde os privilégios descritos nesta seção.

Por exemplo, o código no exemplo a seguir concede privilégios necessários para alguém que usa a função central_log_admin para definir o nível de log para a conta:

GRANT MODIFY LOG LEVEL ON ACCOUNT TO ROLE central_log_admin;

Para mais informações sobre privilégios, consulte Privilégios de controle de acesso.

Definição dos níveis de telemetria¶

Você pode definir níveis de telemetria usando SQL ou, em alguns casos, Snowsight. Em muitos casos, você pode substituir níveis definidos em um escopo maior, configurando-os em um escopo menor, conforme descrito em Como o Snowflake determina o nível de efeito.

Antes de definir níveis, verifique se você tem acesso a uma função com os privilégios necessários.

-- Set the log level on the account
ALTER ACCOUNT SET LOG_LEVEL = ERROR;

USE ROLE central_log_admin;

-- Set the log levels on a database and UDF.
ALTER DATABASE db1 SET LOG_LEVEL = ERROR;
ALTER FUNCTION f1(int) SET LOG_LEVEL = WARN;

-- Set the log levels on a Snowpark Container Services service.
ALTER SERVICE test_service SET LOG_LEVEL = ERROR;

USE ROLE developer_debugging;

-- Set the logging level to DEBUG for the current session.
ALTER SESSION SET LOG_LEVEL = DEBUG;

Como o Snowflake determina o nível de efeito¶

É possível substituir os parâmetros relacionados ao nível de telemetria (para objetos e sessões) usando uma hierarquia de níveis.

Por exemplo, você pode definir um nível para um valor para a conta e, em seguida, substituí-lo configurando o nível para um objeto, que está mais abaixo na hierarquia.

A seguir, descrevemos a hierarquia dos parâmetros de nível de sessão e objeto.

• Para parâmetros de sessão, a hierarquia é Conta » Usuário » Sessão.

  Isso significa que você pode definir o parâmetro para uma conta, substituir o parâmetro no nível da conta para um usuário e substituir o parâmetro no nível do usuário para a sessão atual.

• Para parâmetros de objeto, a hierarquia é Conta » Banco de dados » Esquema » Objeto.

  Isso significa que você pode definir o parâmetro para uma conta, substituir o parâmetro em nível de conta para um banco de dados ou esquema e substituir o parâmetro em nível de banco de dados ou esquema para procedimentos armazenados específicos e UDFs nesse banco de dados ou esquema.

Por exemplo, o LOG_LEVEL de uma função substitui o LOG_LEVEL da conta que contém a função. Se o LOG_LEVEL da conta for FATAL e o LOG_LEVEL da UDF de Java da conta for INFO, o LOG_LEVEL efetivo será INFO (o nível da função, não da conta):

ALTER ACCOUNT SET LOG_LEVEL = FATAL;

ALTER FUNCTION MyJavaUDF SET LOG_LEVEL = INFO;

-- The INFO log level is used because the FUNCTION MYJAVAUDF
-- is lower than the ACCOUNT in the hierarchy.

Nos casos em que o nível é definido nas hierarquias de parâmetro de sessão e de objeto, o nível mais detalhado é usado.

• Para o nível de log, a tabela a seguir lista exemplos de como os parâmetros definidos na sessão e no objeto afetam o nível de log usado.

  Valor da sessão	Valor do objeto, esquema, banco de dados ou conta	Nível de registro usado
  (não definido)	WARN	WARN
  DEBUG	(não definido)	DEBUG
  WARN	ERROR	WARN
  INFO	DEBUG	DEBUG
  (não definido)	(não definido)	OFF

• Para nível de métrica – ALL substitui NONE.

• Para nível de rastreamento – ALWAYS substitui ON_EVENT e OFF; ON_EVENT substitui OFF.