Pydantic Logfire — 了解更多，更快构建。

由 Pydantic 验证背后的团队打造，Pydantic Logfire 是一个可观测性平台，其理念与我们的开源库一脉相承——最强大的工具也可以简单易用。

Logfire 的独特之处在于：

• 简单而强大： Logfire 的仪表板设计简洁，却功能强大，确保整个工程团队都能真正使用它。
• 以 Python 为中心的洞察： 从丰富的 Python 对象展示，到事件循环的遥测数据，再到 Python 代码和数据库查询的性能分析，Logfire 能够让您全面了解 Python 应用程序的行为。
• SQL 支持： 您可以使用标准 SQL 查询数据——完全掌控，且对许多人来说无需学习新知识。通过 SQL，您还可以利用现有的 BI 工具和数据库查询库来分析数据。
• OpenTelemetry 集成： Logfire 是 OpenTelemetry 的封装层，允许您复用现有的工具、基础设施和针对常见 Python 包的监控方案，并支持几乎任何编程语言。我们全面支持 OpenTelemetry 的所有信号类型（追踪、指标和日志）。
• Pydantic 集成： 深入理解在您的 Pydantic 验证模型中流动的数据，并获得内置的验证分析功能。

更多详细信息请参阅 文档。

欢迎在此仓库中报告问题或提出关于 Logfire 的任何疑问！

本仓库包含 logfire 的 Python SDK 和相关文档；用于记录和展示数据的服务端应用则为闭源。

使用 Logfire

以下是对 Logfire 使用方法的简要概述，文档 中有更详细的说明。

安装

pip install logfire

(了解更多)

认证

logfire auth

(了解更多)

手动追踪

以下是一个简单的手动追踪（即日志记录）示例：

from datetime import date

import logfire

logfire.configure()
logfire.info('你好，{name}！', name='世界')

with logfire.span('询问用户{question}', question='年龄'):
    user_input = input('你几岁了 [YYYY-mm-dd]？ ')
    dob = date.fromisoformat(user_input)
    logfire.debug('{dob=} {age=!r}', dob=dob, age=date.today() - dob)

(了解更多)

集成

您也可以避免手动埋点，直接与 众多流行库 集成。以下是与 FastAPI 集成的示例：

from fastapi import FastAPI
from pydantic import BaseModel

import logfire

app = FastAPI()

logfire.configure()
logfire.instrument_fastapi(app)
# 接下来，您可以集成数据库连接器、HTTP 客户端等，并添加日志处理器


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


@app.post('/')
async def add_user(user: User):
    # 我们会在这里存储用户信息
    return {'message': f'{user.name}已添加'}

(了解更多)

Logfire 可以为您提供类似这样的代码运行视图：

贡献

我们欢迎任何有兴趣的人为 Logfire 的 SDK 和文档做出贡献，请参阅 贡献指南。

报告安全漏洞

请参阅我们的 安全政策。

Logfire 开源与闭源边界

Logfire 的 SDK（我们还提供 TypeScript 和 Rust 版本）是开源的，您可以将其用于将数据导出到 任何兼容 OTel 的后端。

而 Logfire 平台（包括 UI 和后端）则是闭源的。您可以通过购买 企业许可证 来自行部署该平台。

Pydantic Logfire 快速上手指南

Pydantic Logfire 是一款专为 Python 开发者打造的可观测性平台，由 Pydantic 团队开发。它基于 OpenTelemetry，提供强大的追踪、指标和日志功能，同时保持极简的使用体验。

环境准备

• 操作系统：Linux、macOS 或 Windows
• Python 版本：3.8 及以上
• 前置依赖：无特殊系统依赖，需确保已安装 pip 包管理工具

💡 国内加速建议：推荐使用清华或阿里云镜像源加速安装过程。

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple logfire

安装步骤

1. 使用 pip 安装 Logfire SDK：

   pip install logfire
   

2. 进行身份认证（首次使用必需）：

   logfire auth
   

   执行后将引导你登录 Pydantic Logfire 云平台并获取访问令牌。

基本使用

方式一：手动埋点（推荐新手）

最简单的用法是直接记录日志和创建追踪跨度：

from datetime import date

import logfire

logfire.configure()
logfire.info('Hello, {name}!', name='world')

with logfire.span('Asking the user their {question}', question='age'):
    user_input = input('How old are you [YYYY-mm-dd]? ')
    dob = date.fromisoformat(user_input)
    logfire.debug('{dob=} {age=!r}', dob=dob, age=date.today() - dob)

方式二：自动集成主流框架

若你使用 FastAPI、Django、SQLAlchemy 等流行库，可一键启用自动 instrumentation：

from fastapi import FastAPI
from pydantic import BaseModel

import logfire

app = FastAPI()

logfire.configure()
logfire.instrument_fastapi(app)
# 后续可继续 instrument 数据库连接器、HTTP 客户端等


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


@app.post('/')
async def add_user(user: User):
    # 此处可存储用户数据
    return {'message': f'{user.name} added'}

配置完成后，所有请求、异常、数据库查询等将自动上报至 Logfire 仪表盘，无需额外编码。

访问 Logfire 控制台 即可查看实时追踪与性能分析。