Use logging and event tracing for an app¶

このトピックでは、プロバイダーがログメッセージとトレースイベントを記録するために Snowflake Native App を設定する方法について説明します。

アプリのログメッセージとトレースイベントについて¶

Snowflake Native App Framework は、アプリに関する情報を収集するために、Snowflake のロギングとトレース機能の使用をサポートしています。プロバイダーは、以下のことを記録・分析するアプリを設定することができます：

ログメッセージは、コードの特定部分の状態に関する情報を含む、独立した詳細なメッセージです。
構造化データを使用したトレースイベントは、プロバイダーがコードの複数の部分にまたがる情報やグループ化された情報を取得するために使用できます。トレース・イベントは、アプリがそのパフォーマンスや動作に関連する情報を発信することを可能にします。
Metrics - Snowflake が生成する CPU とメモリメトリクスに基づく、ストアドプロシージャと UDF のリソース消費に関する情報。

アプリがログメッセージとトレースイベントを出力するように設定するには、プロバイダーはマニフェストファイルでログレベルとトレースレベルを設定します。アプリのログとトレースのレベルを設定するをご参照ください。

プロバイダーは、コンシューマがログメッセージとトレースイベントをプロバイダーと共有できるように、イベント共有を使用するようにアプリを構成することもできます。詳しくはイベントの共有についてをご参照ください。

Monitor consumer application health¶

You can use the LAST_HEALTH_STATUS and LAST_HEALTH_STATUS_UPDATED_ON columns of the APPLICATION_STATE view to monitor the health of consumer instances of your app. The LAST_HEALTH_STATUS column has the following possible values:

OK: The consumer instance is healthy.
FAILED: The consumer instance is in an error state.
PAUSED: The consumer manually paused the app.

The following code sample demonstrates using the APPLICATION_STATE view to retrieve the health status of all consumer instances of your app:

SELECT
    CONSUMER_ORGANIZATION_NAME,
    CONSUMER_ACCOUNT_NAME,
    LAST_HEALTH_STATUS,
    LAST_HEALTH_STATUS_UPDATE_TIME
FROM
    SNOWFLAKE.ACCOUNT_USAGE.APPLICATION_STATE
WHERE
    PROVIDER_ORG_NAME = '<your_provider_org_name>'
    AND APPLICATION_NAME = '<your_app_name>'
ORDER BY
    LAST_HEALTH_STATUS_UPDATE_TIME DESC;

Copy

The preceding query may return results similar to the following:

CONSUMER_ORG_NAME    CONSUMER_ACCOUNT_NAME    LAST_HEALTH_STATUS    LAST_HEALTH_STATUS_UPDATE_TIME
------------------   ---------------------    ------------------    -------------------------------
consumer_org_1      consumer_account_1       OK                    2024-01-15 10:30:00.000
consumer_org_2      consumer_account_2       FAILED                2024-01-15 09:45:00.000
consumer_org_3      consumer_account_3       PAUSED                2024-01-14 16:20:00.000

Use logging and event tracing for an app¶

アプリのログメッセージとトレースイベントについて¶

イベント共有について¶

イベント共有を使用する際の考慮事項¶

以前のイベント共有機能から移行する際の注意点¶

ワークフロー - アプリのイベント共有を設定する¶

Monitor consumer application health¶