为应用程序配置日志记录和事件跟踪¶

关于应用程序中的日志消息和跟踪事件¶

Snowflake Native App Framework 支持使用 Snowflake 日志记录和跟踪 功能来收集应用程序的信息。提供商可以配置应用程序来记录和分析以下内容：

• 日志消息 – 独立的详细消息，包含有关特定应用程序代码片段状态的信息。

• 跟踪事件 – 提供商可用于获取跨越和分组代码中多个部分信息的结构化数据。 跟踪事件允许应用程序发出与其性能和行为相关的信息。

要配置应用程序以发出日志消息和跟踪事件，提供商需要在清单文件中设置日志和跟踪级别。请参阅 为应用程序设置日志和跟踪级别。

提供商还可以将应用程序配置为使用事件共享，让使用者与提供商共享日志消息和跟踪事件。有关更多信息，请参阅 关于事件共享。

关于事件共享¶

事件共享允许提供商收集有关应用程序性能和行为的信息。提供商可以配置应用程序，要求使用者与提供商共享日志消息和跟踪事件。事件共享要求提供商和使用者在其账户中配置一个事件表，以存储应用程序发出的日志消息和跟踪事件。

当启用事件共享时，插入到使用者账户事件表中的日志消息和跟踪事件也会插入到提供商账户的事件表中。

使用事件共享时的注意事项¶

在为应用程序配置日志记录和事件共享之前，提供商必须考虑以下几点：

• 提供商需承担提供商方面事件共享相关的所有费用，包括数据引入和存储。

• 提供商必须在您想要支持事件共享的每个区域拥有 存储共享事件的账户。

• 提供商必须在清单文件中定义应用程序的默认日志级别和跟踪级别。

从之前的事件共享功能迁移时的注意事项¶

在从现有的事件共享功能迁移到使用事件定义的过程中，提供商应注意以下几点。

• 之前的事件共享功能相当于 OPTIONAL ALL 事件定义。

• 使用之前功能的应用程序的已发布版本和补丁程序将默认使用 OPTIONAL ALL 事件定义。提供商无需将此事件定义添加到清单文件中。

要开始使用事件定义，提供商可以将支持的事件定义添加到清单文件中。这适用于新应用程序以及现有应用程序的新版本和补丁。

工作流程 – 为应用程序设置事件共享¶

事件共享允许使用者与提供商共享日志消息和跟踪事件。

以下工作流程展示了如何为应用程序设置和启用事件共享：

1. 提供商为应用程序 设置日志和跟踪级别。

2. 提供商向清单文件中 添加事件定义。

   事件定义充当应用程序发出的日志消息和跟踪事件的筛选器。提供商可将事件定义配置为必需或可选。

3. 提供商在其组织中 设置事件表。

4. 提供商发布应用程序。

当使用者安装应用程序时，他们可以设置事件表并启用事件共享。有关事件共享的用户要求的更多信息，请参阅 为应用程序启用日志记录和事件共享。