Protokollierung von Meldungen in Python¶

Verwenden des Loggernamens zum Einstellen des Protokolliergrads¶

Sie können den in der Ereignistabelle erfassten Loggernamen verwenden, um einen Schwellenwert für Protokolleinträge von diesem Logger festzulegen. Dies kann nützlich sein, wenn Sie den Schwellenwert eines Loggers so einstellen möchten, dass unerwünschte Protokolleinträge oberhalb eines bestimmten Wertes herausgefiltert werden.

Dazu müssen Sie zunächst die Ereignistabelle abfragen, um den Namen des Loggers zu ermitteln, der mit den Einträgen verbunden ist, für die Sie einen anderen Protokolliergrad erfassen möchten. Unter Verwendung dieses Loggernamens setzen Sie dann den Protokolliergrad auf den gewünschten Schwellenwert.

Der Code im folgenden Beispiel führt eine Abfrage nach Protokolleinträgen aus und fügt den Loggernamen in die zurückgegebenen Daten ein. Sie können den Namen als Wert der Spalte Scope erhalten.

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';

Diese Abfrage kann viele Einträge von mehreren Loggern zurückgeben. Wenn Sie nach Durchsicht der Ergebnisse zu dem Schluss kommen, dass Sie vom Numpy-Logger viele INFO-Meldungen erhalten, die Sie nicht benötigen, können Sie mit Python den Schwellenwert dieses Loggers so einstellen, dass nur Protokolleinträge des Protokolliergrads ERROR und darüber erfasst werden.

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

Weitere Informationen zum Abfragen der Ereignistabelle finden Sie unter Anzeigen von Protokollmeldungen.

Beispiel einer gespeicherten Prozedur¶

Der Code im folgenden Beispiel importiert das Modul logging, ruft einen Logger ab und protokolliert eine Meldung des Protokolliergrads INFO.

Weitere Informationen zu den von Python unterstützten Protokolliergraden finden Sie in der Dokumentation zu Protokolliergrade.

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.")

$$;

Sie können auf die Protokollmeldungen zugreifen, indem Sie einen SELECT-Befehl auf der Ereignistabelle ausführen. Weitere Informationen dazu finden Sie unter Anzeigen von Protokollmeldungen.

Der Code im folgenden Beispiel fragt die Ereignistabelle ab, in der die Protokollmeldungen gespeichert sind. Die Abfrage gibt den Schweregrad und die Meldung jedes Protokolleintrags der Handler-Klasse zurück.

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';

Das vorherige Beispiel generiert die folgende Ausgabe.

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

Streamlit-Beispiel¶

Der Code im folgenden Beispiel importiert das Modul logging, ruft einen Logger ab und protokolliert eine Meldung des Protokolliergrads INFO.

Weitere Informationen zu den von Python unterstützten Protokolliergraden finden Sie in der Dokumentation zu Protokolliergrade.

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}")