Registro de mensagens em Python¶

Como usar o nome do registrador de logs para definir o nível de registro em log¶

É possível usar o nome do registrador de logs registrado na tabela de eventos para configurar um limite para entradas de log desse registrador de logs. Isso pode ser útil quando você deseja definir o limite de um registrador de logs para que ele filtre entradas de log indesejadas acima de um nível específico.

Para fazer isso, primeiro você consultaria a tabela de eventos para descobrir o nome do registrador de logs associado às entradas para as quais deseja capturar um nível de registro em log diferente. Então, usando esse nome de registrador de logs, você definiria o nível de log para o limite desejado.

O código no exemplo a seguir consulta entradas de log, incluindo o nome do registrador de logs nos dados retornados. Você pode obter o nome como o valor da coluna Escopo.

SET event_table_name='my_db.public.my_event_table';

SELECT
  TIMESTAMP as time,
  RECORD['severity_text'] as log_level,
  SCOPE['name'] as logger_name,
  VALUE as message
FROM
  IDENTIFIER($event_table_name)
WHERE
  RECORD_TYPE = 'LOG';

Esta consulta pode retornar muitas entradas de vários registradores de logs. Se, depois de analisar os resultados, você decidir que está recebendo muitas mensagens INFO que não deseja do registrador de logs numpy, poderá usar Python para definir o limite desse registrador de logs para capturar entradas de log no nível ERROR e acima.

numpy_logger = logging.getLogger('numpy_logs')
numpy_logger.setLevel(logging.ERROR)

Para obter mais informações sobre como consultar a tabela de eventos, consulte Visualização de mensagens de log.

Exemplo de procedimento armazenado¶

O código no exemplo a seguir importa o módulo logging, obtém um agente de registro e registra uma mensagem no nível INFO.

Para obter mais informações sobre os níveis de registro compatíveis com Python, consulte a documentação dos níveis de registro.

CREATE OR REPLACE PROCEDURE do_logging()
RETURNS VARCHAR
LANGUAGE PYTHON
PACKAGES=('snowflake-snowpark-python')
RUNTIME_VERSION = 3.9
HANDLER='do_things'
AS $$
import logging

logger = logging.getLogger("python_logger")
logger.info("Logging from Python module.")

def do_things(session):
  logger.info("Logging from Python function start.")

  try:
    throw_exception()
  except Exception:
    logger.error("Logging an error from Python handler: ")
    return "ERROR"

  return "SUCCESS"

def throw_exception():
  raise Exception("Something went wrong.")

$$;

Você pode acessar as mensagens de log executando um comando SELECT na tabela de eventos. Para obter mais informações, consulte Visualização de mensagens de log.

O código no exemplo a seguir consulta a tabela de eventos onde as mensagens de log estão armazenadas. A consulta informa sobre a gravidade e a mensagem de cada entrada de log da classe do manipulador.

SET event_table_name='my_db.public.my_event_table';

SELECT
  RECORD['severity_text'] AS SEVERITY,
  VALUE AS MESSAGE
FROM
  IDENTIFIER($event_table_name)
WHERE
  SCOPE['name'] = 'python_logger'
  AND RECORD_TYPE = 'LOG';

O exemplo anterior gera a seguinte saída.

---------------------------------------------------------------------------
| SEVERITY | MESSAGE                                                      |
---------------------------------------------------------------------------
| "INFO"   | "Logging from Python module."                                |
---------------------------------------------------------------------------
| "INFO"   | "Logging from Python function start."                        |
---------------------------------------------------------------------------
| "ERROR"  | "Logging an error from Python handler."                      |
---------------------------------------------------------------------------

Exemplos do Streamlit¶

O código no exemplo a seguir importa o módulo logging, obtém um agente de registro e registra uma mensagem no nível INFO.

Para obter mais informações sobre os níveis de registro compatíveis com Python, consulte a documentação dos níveis de registro.

import streamlit as st
import logging

logger = logging.getLogger('app_logger')

st.title("Streamlit logging example")

hifives_val = st.slider("Number of high-fives", min_value=0, max_value=90, value=60)

if st.button("Submit"):
    logger.info(f"Submitted with high-fives: {hifives_val}")