Pydantic Logfire

Pydantic 与 Pydantic Logfire 无缝集成，Pydantic Logfire 是我们基于与开源库相同的理念构建的可观测性平台 — 最强大的工具也可以易于使用。

入门指南

Logfire 具有开箱即用的 Pydantic 集成，使您能够了解通过 Pydantic 模型传递的数据，并获得关于验证的分析。对于现有的 Pydantic 用户，它可以提供对您 Pydantic 模型使用情况的无与伦比的洞察。

开始使用 Logfire 可以通过三个简单的步骤完成

1. 设置您的 Logfire 帐户。
2. 安装 Logfire SDK。
3. 对您的项目进行检测。

基本用法

一旦您设置好 Logfire，您就可以开始使用它来监控您的 Pydantic 模型，并深入了解您的数据验证

from datetime import date

import logfire

from pydantic import BaseModel

logfire.configure()  # (1)!


class User(BaseModel):
    name: str
    country_code: str
    dob: date


user = User(name='Anne', country_code='USA', dob='2000-01-01')
logfire.info('user processed: {user!r}', user=user)  # (2)!

1. 您只需要调用 logfire.configure() 即可使用 Logfire 对您的项目进行检测。
2. 调用 logfire.info() 会将 user 对象记录到 Logfire，并内置支持 Pydantic 模型。

Pydantic instrumentation

您甚至可以通过使用内置的 Pydantic 集成来自动记录关于验证过程的信息

from datetime import date

import logfire

from pydantic import BaseModel

logfire.configure()
logfire.instrument_pydantic()  # (1)!


class User(BaseModel):
    name: str
    country_code: str
    dob: date


User(name='Anne', country_code='USA', dob='2000-01-01')
User(name='David', country_code='GBR', dob='invalid-dob')

1. 调用 logfire.instrument_pydantic() 会自动记录您项目中所有 Pydantic 模型的验证信息。

您将看到每个成功和失败的验证都记录在 Logfire 中

并且您可以调查每个相应的 span 以获取验证详情