The best Python observability tool! 🪵🔥
Project description
Pydantic Logfire — Uncomplicated Observability
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
Authenticate
logfire auth
Manual tracing
Here's a simple manual tracing (aka logging) example:
import logfire
from datetime import date
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)
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'}
Logfire gives you a view into how your code is running like this:
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.
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
Built Distribution
File details
Details for the file logfire-0.27.0.tar.gz.
File metadata
- Download URL: logfire-0.27.0.tar.gz
- Upload date:
- Size: 24.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | bf1e35651bb57211656451b70ae4ee8c9542305dfa5146dc9f4b4cbd5ce30070 |
|
| MD5 | fe4076d7ca53e30c51b7ac69bb4073b9 |
|
| BLAKE2b-256 | cf93abd390b9768207debc3a55b64d76c4fd8d536b283374f10229ece4d35709 |
Provenance
File details
Details for the file logfire-0.27.0-py2.py3-none-any.whl.
File metadata
- Download URL: logfire-0.27.0-py2.py3-none-any.whl
- Upload date:
- Size: 118.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 53be83ff83ed31f23556566499d3e98a46484e2dc4739a7c82ec70d242698c35 |
|
| MD5 | 614ce5debb12f76ed0a9ced1e7b04980 |
|
| BLAKE2b-256 | 49ba750d6507064d1b35505cf47e27f90c12ae57f14142c12374e9d2e3dab26e |
