Memulai

Panduan ini akan memandu Anda untuk memulai LogfireAnda akan mempelajari cara memasang Logfire, mengautentikasi ke lingkungan lokal Anda, dan menggunakan penelusuran dan pencakup untuk mendeteksi pengamatan kode.

menginstal

Untuk menginstal versi terbaruLogfire, tolong jalankan:

PIPRyePoetryConda

pip install logfire

rye add logfire 

poetry add logfire

conda install -c conda-forge logfire

sertifikasi

Verifikasi lingkungan lokal Anda denganLogfiredengan menjalankan perintah berikut:

Otentikasi logika

Ini akan membuka jendela browser bagi Anda untuk mendaftar atau masuk pada logfire.pydantic.dev. Setelah otentikasi berhasil, kredensial akan disimpan dalam ~/.logfire/default.toml.

Penggunaan dasar

Saat menggunakanLogfiredi lingkungan baru untuk pertama kalinya, sebuah proyek perlu dicerai. proyekLogfireadalah namespace untuk mengatur data. Semua data yang di kirim keLogfireharus dikaitkan dengan proyek.

Untuk menggunakanLogfire, sederhana saja:

import logfire

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

1. configure() harus dipanggil sekali sebelum login untuk menginisialisasiLogfire.

2. Ini akan mencatat Hello world！ dengan tingkat 信息.

Perhatian

Tingkat log lainnya juga tersedia, termasuk 'trace', 'debug', 'notice', 'warning', "Salah" dan "fatal."

Jika Anda tidak memiliki kredensial yang ada untuk sebuah proyek, Anda akan diminta untuk memilih salah satu proyek atau membuat yang baru.

Jika Anda belum memiliki proyek, tulis “n” dan “Enter” untuk membuat proyek baru.

Kemudian, sistem akan meminta Anda untuk memilih organisasi Anda dan memberikan nama untuk proyek baru Anda:

Anda telah membuat proyek baru diLogfire!: p artying _ face:

Setelah menyelesaikan pengaturan satu kali ini,Logfireakan menggunakan kredensial proyek yang baru dibuat untuk Python berikutnya berjalan dari direktori yang sama.

???Sukses "Anda juga dapat membuat proyek melalui UI web..." Untuk membuat proyek baru di UI, Anda dapat mengikuti langkah-langkah ini:

1. Masukkan [Logfire Web UI](https://logfire.pydantic.dev).

![Logfire Antarmuka Pengguna Web](../../图片/指南/browser-create-project.png)

2. Klik tombol "Proyek Baru," isi formulir yang muncul, lalu klik "Buat Proyek."

![Tombol proyek baru](../../图片/指南/browser-create-project-button.png)

Mengerjakan! Anda telah membuat proyek baru di**Logfire**!: kacamata hitam:

???Sukses "Anda juga dapat membuat proyek melalui CLI..." Untuk informasi lebih lanjut tentang cara membuat proyek melalui CLI, lihat dokumentasi SDK CLI.

Setelah membuat proyek, Anda akan melihat:

Logfire project URL: https://logfire.pydantic.dev/dmontagu/my-project
19:52:12.323 Hello, world!

Logfireakan selalu dimulai dengan URL yang menampilkan proyek, dan (menggunakan konfigurasi default) juga akan memberikan tampilan dasar dari log yang Anda kirim ke Logfire di titik akhir.

Pelacakan dengan Rentang

Dengan bentang, Anda dapat menambahkan konteks ke log dan mengukur waktu eksekusi kode. Beberapa bentang digabungkan untuk membentuk satu lintasan, memberikan gambaran lengkap tentang perjalanan operasi melalui sistem.

from pathlib import Path
import logfire

cwd = Path.cwd()
total_size = 0

logfire.configure()

with logfire.span('counting size of {cwd=}', cwd=cwd):
    for path in cwd.iterdir():
        if path.is_file():
            with logfire.span('reading {file}', file=path):
                total_size += len(path.read_bytes())

    logfire.info('total size of {cwd} is {size} bytes', cwd=cwd, size=total_size)

Dalam contoh ini:

1. Ukuran bentang luar menghitung ukuran file total (cwd) dalam direktori saat ini.

2. Rentang internal mengukur waktu yang diambil untuk membaca setiap file individu.

3. Terakhir, catat ukuran totalnya.

Dengan menggunakan jejak dan rentang untuk memeriksa kode Anda, Anda dapat melihat berapa lama operasi berlangsung, mengidentifikasi kemacetan, dan mendapatkan pandangan tingkat tinggi tentang aliran permintaan di sistem Anda - sangat berharga untuk menjaga kinerja dan keandalan aplikasi Anda.

---

本文总阅读量次