Pydantic Logfire — 洞察更多，构建更快。

Pydantic Validation 团队倾力打造的 Pydantic Logfire 是一个可观测性平台。它秉持着与我们的开源库相同的信念——最强大的工具也应该简单易用。

Logfire 的独特之处：

• 简单而强大： Logfire 的仪表盘在提供强大功能的同时保持简洁，确保整个工程团队都能真正上手使用。
• 以 Python 为中心的洞察： 从 Python 对象的高级展示、事件循环（event-loop）遥测，到 Python 代码和数据库查询的性能分析，Logfire 为你提供了前所未有的 Python 应用行为可见性。
• SQL 支持： 使用标准 SQL 查询数据——既拥有完全的控制权，又无需学习新技能。使用 SQL 也意味着你可以通过现有的 BI 工具和数据库查询库来查询数据。
• OpenTelemetry： Logfire 是一个基于 OpenTelemetry 的高层封装，允许你利用现有的工具、基础设施以及针对众多常见 Python 包的仪表化（instrumentation），并支持几乎任何语言。我们对所有 OpenTelemetry 信号（traces、metrics 和 logs）提供全面支持。
• Pydantic 集成： 深入了解流经 Pydantic Validation 模型的数据，并获取验证过程的内置分析。

更多信息请参阅 文档。

欢迎在该仓库中提交问题或询问有关 Logfire 的任何事项！

本仓库包含 logfire 的 Python SDK 和文档；用于记录和显示数据的服务器端应用程序为闭源。

使用 Logfire

以下是关于如何使用 Logfire 的简要概述，详细信息请参考 文档。

安装

pip install logfire

(了解更多)

身份验证

logfire auth

(了解更多)

手动追踪

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

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 集成的示例：

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} added'}

(了解更多)

Logfire 为你展示代码运行情况的视图如下：

贡献

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

安全漏洞报告

请参阅我们的 安全政策。

Logfire 开源与闭源界限

Logfire SDK（我们同时也提供 TypeScript 和 Rust 版本）是开源的，你可以使用它们将数据导出到 任何支持 OTel 的后端。

Logfire 平台（UI 和后端）是闭源的。你可以通过购买 企业许可证 来进行私有化部署。