跳转至

创建写入令牌

要向Logfire发送数据,您需要创建一个写入令牌。写入令牌是一个唯一标识符,允许您向特定的 Logfire 项目发送数据。如果您按照第一步指南设置Logfire,则您已经在本地绑定了与所创建项目的写入令牌。但是,如果要将其他计算机配置为写入该项目,例如在已部署的应用程序中,则需要创建新的写入令牌。

您可以按照以下步骤创建写入令牌:

  1. logfire.pydantic.dev 打开 Logfire Web 界面。

  2. 从页面左侧的“项目”部分选择您的项目。

  3. 单击页面右上角的“⚙️设置”选项卡。

  4. 选择左侧菜单中的 {} Write tokens 选项卡。

  5. 单击“创建写入令牌”按钮。

创建写入令牌后,你将看到一个包含令牌值的对话框。复制此值并安全地存储,它将不会再次显示

现在,您可以使用此写入令牌从任何计算机或应用程序将数据发送到您的 Logfire 项目。

我们建议您在已部署的应用程序中通过环境变量注入写入令牌。将 token 设置为环境变量的值 LOGFIRE_TOKEN 后,logfire 会自动使用它向您的项目发送数据。

设置 send_to_logfire='if-token-present'

您可能希望在本地开发期间不向 logfire 发送数据,但仍然可以选择在不更改代码的情况下在生产环境中发送数据。为此,我们在 logfire.configure() 函数中提供了参数 send_to_logfire='if-token-present'。如果将其设置为 'if-token-present',则只有当环境变量 LOGFIRE_TOKEN中存在写入令牌或本地保存了令牌时,logfire 才会向 logfire 发送数据。如果在 CI 中运行测试,则不会发送任何数据。

您也可以设置 environmnet 变量 LOGFIRE_SEND_TO_LOGFIRE 来配置此选项。例如,您可以在已部署的应用程序中将其设置为 LOGFIRE_SEND_TO_LOGFIRE=true,在测试设置中将其设置为 LOGFIRE_SEND_TO_LOGFIRE=false


本文总阅读量