Aller au contenu

Premiers pas

Ce guide vous guidera pour démarrer avecLogfireVous apprendrez à installer Logfire, à authentifier votre environnement local et à utiliser le suivi et la portée pour détecter l'observabilité du code.

Installation de

Pour installer la dernière version deLogfire, lancez:

pip install logfire

rye add logfire 

poetry add logfire

conda install -c conda-forge logfire

Certification par

Validez votre environnement local avecLogfireen exécutant la commande suivante:

Authentification par Logfire

Cela ouvrira une fenêtre de navigateur pour vous inscrire ou vous connecter sur logfire.pydantic.dev Une fois l'authentification réussie, les informations d'identification seront stockées dans ~/.logfire/default.toml.

Utilisation basique

Lorsque vous utilisezLogfirepour la première fois dans un nouvel environnement, vous devez configurer un projet.Logfireproject est un espace de noms utilisé pour organiser les données. toutes les données envoyées àLogfiredoivent être associées au projet.

Pour utiliserLogfire, c'est simple:

import logfire

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

  1. configure() devrait être appelé une fois avant de se connecter pour initialiserLogfire.

  2. Cela enregistrera Hello world！ avec le niveau 信息.

Attention

Autre Niveau de log Aussi disponible, y compris 'trace',' debog','notice',' warn', "Erreur" et "fatale".

Si vous ne disposez pas des informations d'identification existantes pour le projet, vous serez invité à sélectionner l'un d'entre eux ou à en créer un nouveau:

Terminal avec prompt à créer un projet

Si vous n'avez pas encore de projets, écrivez “n” et “Enter” pour en créer un nouveau.

Le système vous demandera alors de choisir votre organisation et de donner un nom à votre nouveau projet:

Terminal avec prompt à créer un projet

Vous venez de créer un nouveau projet dansLogfire!:p artying_face:

Une fois cette configuration unique terminée,Logfireutilisera les informations d'identification du projet nouvellement créées pour les exécutions Python ultérieures à partir du même répertoire.

???Succès "Vous pouvez également créer un projet via l'interface utilisateur Web..." Pour créer un nouveau projet dans l'interface utilisateur, vous pouvez suivre ces étapes:

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

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

2. Cliquez sur le bouton « Nouveau projet », remplissez le formulaire qui apparaît, puis cliquez sur « Créer un projet ».

![Nouveau bouton de projet](../../图片/指南/browser-create-project-button.png)

Vous avez créé un nouveau projet dans**Logfire**!: Lunettes de soleil:

???Succès "Vous pouvez également créer des projets via CLI..." Pour plus d'informations sur la création de projets via CLI, consultez la documentation SDK CLI.

Après avoir créé votre projet, vous devriez voir: 

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

Logfirecommencera toujours par afficher l'URL de l'élément et (avec la configuration par défaut) fournira également un affichage de base des journaux que vous envoyez à Logfire dans le terminal.

Hello world screenshot

Suivi avec Span

Grâce aux span, vous pouvez ajouter du contexte au journal et mesurer le temps d'exécution du code. plusieurs span se combinent pour former une piste, fournissant ainsi une image complète du parcours de l'action dans le système.

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)

Dans ce cas:

  1. La mesure de la portée externe calcule le temps nécessaire pour calculer la taille totale du fichier (cwd) dans le répertoire courant.

  2. La portée interne mesure le temps de lecture de chaque fichier individuel.

  3. Enfin, notez la taille totale.

Counting size of loaded files screenshot

En utilisant le suivi et la portée pour détecter le code, vous pouvez voir combien de temps les opérations prennent, identifier les goulots d'étranglement et obtenir une vue avancée du flux de requêtes dans votre système, ce qui est précieux pour maintenir les performances et la fiabilité de vos applications.

本文总阅读量次