関数とプロシージャのイベントをトレースする¶

トレースの例¶

次の例のPythonコードは、スパンに example.proc.do_tracing 属性を値 begin で設定します。また、スパン内で、 example.key1 および example.key2 属性を持つ event_with_attributes イベントを出力します。

CREATE OR REPLACE PROCEDURE do_tracing()
RETURNS VARIANT
LANGUAGE PYTHON
PACKAGES=('snowflake-snowpark-python', 'snowflake-telemetry-python')
RUNTIME_VERSION = 3.9
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"
$$;

はじめるにあたり¶

ハンドラーコードからイベントトレースを開始するには、次の高レベルのステップに従います。

1. イベントテーブルを設定します。

   Snowflakeは、イベントテーブルを使用して、ハンドラーコードによって出力されたイベントデータを格納します。イベントテーブルには、 Snowflakeによって事前定義された列 があります。

2. 使用するハンドラー言語のイベントトレース API について理解を深めます。

   ハンドラー言語のリストについては、 サポートされている言語 を参照してから、 言語からトレースイベントを出力する方法に関するコンテンツ を表示します。

3. イベントトレースコードをハンドラーに追加します。

4. イベントテーブルから イベントトレースデータを取得する 方法を学習します。

トレースイベントのレベル¶

トレースレベルを設定すると、イベントテーブルに格納されたトレースイベントデータの冗長性を管理できます。トレースする前に、この設定を使用して、ログメッセージの重大度を取得していることを確認してください。イベントデータがテーブルに書き込まれていないことがわかった場合は、トレースレベルをチェックして、必要なデータをSnowflakeがキャプチャしていることを確認してください。

詳細については、 ロギング、メトリクス、トレースのレベル設定 をご参照ください。

サポートされている言語¶

次の言語で記述されたコードからイベントをトレースできます。これには、ハンドラーコードが Snowpark APIs で記述されている場合も含まれます。

*:

Snowparkで記述されたScala UDTF ハンドラー。

収集したイベントデータの表示¶

トレースデータは、 Snowsight、またはトレースデータが保存されているイベントテーブルをクエリすることで表示することができます。詳細については、 トレースデータの表示 をご参照ください。