Skip to main content

The best Python observability tool! 🪵🔥

Project description

Pydantic Logfire — Know more. Build faster.

CI codecov pypi license versions Join Slack

From the team behind Pydantic Validation, Pydantic Logfire is an observability platform built on the same belief as our open source library — that the most powerful tools can be easy to use.

What sets Logfire apart:

  • Simple and Powerful: Logfire's dashboard is simple relative to the power it provides, ensuring your entire engineering team will actually use it.
  • Python-centric Insights: From rich display of Python objects, to event-loop telemetry, to profiling Python code and database queries, Logfire gives you unparalleled visibility into your Python application's behavior.
  • SQL: Query your data using standard SQL — all the control and (for many) nothing new to learn. Using SQL also means you can query your data with existing BI tools and database querying libraries.
  • OpenTelemetry: Logfire is an opinionated wrapper around OpenTelemetry, allowing you to leverage existing tooling, infrastructure, and instrumentation for many common Python packages, and enabling support for virtually any language. We offer full support for all OpenTelemetry signals (traces, metrics and logs).
  • Pydantic Integration: Understand the data flowing through your Pydantic Validation models and get built-in analytics on validations.

See the documentation for more information.

Feel free to report issues and ask any questions about Logfire in this repository!

This repo contains the Python SDK for logfire and documentation; the server application for recording and displaying data is closed source.

Using Logfire

This is a very brief overview of how to use Logfire, the documentation has much more detail.

Install

pip install logfire

(learn more)

Authenticate

logfire auth

(learn more)

Manual tracing

Here's a simple manual tracing (aka logging) example:

import logfire
from datetime import date

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)

(learn more)

Integration

Or you can also avoid manual instrumentation and instead integrate with lots of popular packages, here's an example of integrating with FastAPI:

import logfire
from pydantic import BaseModel
from fastapi import FastAPI

app = FastAPI()

logfire.configure()
logfire.instrument_fastapi(app)
# next, instrument your database connector, http library etc. and add the logging handler

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

@app.post('/')
async def add_user(user: User):
    # we would store the user here
    return {'message': f'{user.name} added'}

(learn more)

Logfire gives you a view into how your code is running like this:

Logfire screenshot

Contributing

We'd love anyone interested to contribute to the Logfire SDK and documentation, see the contributing guide.

Reporting a Security Vulnerability

See our security policy.

Logfire Open-Source and Closed-Source Boundaries

The Logfire SDKs (we also have them for TypeScript and Rust) are open source, and you can use them to export data to any OTel-compatible backend.

The Logfire platform (the UI and backend) is closed source. You can self-host it by purchasing an enterprise license.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

logfire-4.16.0.tar.gz (550.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

logfire-4.16.0-py3-none-any.whl (229.1 kB view details)

Uploaded Python 3

File details

Details for the file logfire-4.16.0.tar.gz.

File metadata

  • Download URL: logfire-4.16.0.tar.gz
  • Upload date:
  • Size: 550.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for logfire-4.16.0.tar.gz
Algorithm Hash digest
SHA256 03a3ab8fdc13399309cb55d69cba7a6fcbad3526cfad85fc4f72e7d75e22b654
MD5 b08ebdffa8ebc21b78ed5899c0694749
BLAKE2b-256 e260b8040db3598a55da64c45e3e689f2baa87389a4648a6f46ba80be3329f23

See more details on using hashes here.

Provenance

The following attestation bundles were made for logfire-4.16.0.tar.gz:

Publisher: main.yml on pydantic/logfire

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file logfire-4.16.0-py3-none-any.whl.

File metadata

  • Download URL: logfire-4.16.0-py3-none-any.whl
  • Upload date:
  • Size: 229.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for logfire-4.16.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8f895f6c2efa593ad6d49e1b06d8e6e351d3dd0cad61ce5def0c3d401f8ea707
MD5 bc1c617fc6bb9fbe17cd202657e0bfc0
BLAKE2b-256 53f7ffcf81eb4aea75e40c0646b9519947d2070626c5d533922df92975045181

See more details on using hashes here.

Provenance

The following attestation bundles were made for logfire-4.16.0-py3-none-any.whl:

Publisher: main.yml on pydantic/logfire

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

Image AWS Cloud computing and Security Sponsor Image Datadog Monitoring Image Depot Continuous Integration Image Fastly CDN Image Google Download Analytics Image Pingdom Monitoring Image Sentry Error logging Image StatusPage Status page