Pydantic Logfire

Pydantic 与 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 检测

您甚至可以使用内置的 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 以获取验证详情。