Aan de slag

Deze gids begeleidt u bij het aan de slag gaan metLogfire. U leert hoe u Logfire installeert, authenticeert bij uw lokale omgeving en tracering en spanning gebruikt om waarneembaarheid van code te detecteren.

installeren¶

Voer het volgende uit om de nieuwste versie vanLogfirete installeren:

PIPRyePoetryConda

pip install logfire

rye add logfire

poetry add logfire

conda install -c conda-forge logfire

certificatie¶

Controleer uw lokale omgeving metLogfiredoor de volgende opdracht uit te voeren:

Logfire authenticatie

Dit opent een browservenster waarin u zich kunt registreren of inloggen op logfire.pydantic.dev. Na succesvolle authenticatie worden de referenties opgeslagen in ~/.logfire/default.toml.

Basisgebruik¶

WanneerLogfirevoor het eerst in een nieuwe omgeving wordt gebruikt, moet een project worden opgezet.Logfireproject is een naamruimte voor het organiseren van gegevens. Alle gegevens die naarLogfireworden verzonden, moeten aan het project worden gekoppeld.

OmLogfirete gebruiken, is het eenvoudig:

import logfire

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

configure() moet één keer worden aangeroepen voordat u inlogt om deLogfirete initialiseren.
Dit zal Hello world！ loggen met het 信息-niveau.

Aandacht

Andere log levels zijn ook beschikbaar, waaronder 'trace', 'debug', 'Notice', 'waarschuw', "Fout" en "fataal".

Als u geen bestaande referenties voor een project heeft, wordt u gevraagd een van de projecten te selecteren of een nieuwe te maken.

Als je nog geen projecten hebt, schrijf dan “n” en “Enter” om een nieuw project te maken.

Vervolgens vraagt het systeem u om uw organisatie te kiezen en een naam op te geven voor uw nieuwe project:

Je hebt een nieuw project aangemaakt inLogfire!: p artying _ face:

Na het voltooien van deze eenmalige installatie, zalLogfirede nieuw gemaakte projectreferenties gebruiken voor volgende Python-runs vanuit dezelfde directory.

???Succes "U kunt ook projecten maken via de web-gebruikersinterface..."Om een nieuw project in de gebruikersinterface te maken, kunt u deze stappen volgen:

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

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

2. Klik op de knop "Nieuw project", vul het formulier in dat wordt weergegeven en klik vervolgens op "Project maken".

![Nieuwe projectknop](../../图片/指南/browser-create-project-button.png)

Doen! Je hebt een nieuw project aangemaakt in**Logfire**!: zonnebril:

???Succes "Je kunt ook projecten maken via de CLI..."Voor meer informatie over het maken van projecten via de CLI, bekijk de SDK CLI documentatie.

Na het maken van het project zou u het volgende moeten zien:

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

Logfirebegint altijd met de URL die het project weergeeft en biedt (met behulp van de standaardconfiguratie) ook een basisweergave van de logboeken die u in het eindpunt naar Logfire verzendt.

Volgen met Span¶

Met overspanningen kunt u context aan het logboek toevoegen en de uitvoeringstijd van de code meten. Meerdere overspanningen worden gecombineerd om een enkel traject te vormen, wat een volledig beeld geeft van de reis van de operatie door het systeem.

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)

In dit voorbeeld:

De buitenspanmaat berekent de totale bestandsgrootte (cwd) in de huidige map.
De interne overspanning meet de tijd die nodig is om elk afzonderlijk bestand te lezen.
Leg ten slotte de totale grootte vast.

Door sporen en overspanningen te gebruiken om uw code te inspecteren, kunt u zien hoe lang bewerkingen duren, knelpunten identificeren en een overzicht op hoog niveau krijgen van de stroom verzoeken in uw systeem - van onschatbare waarde voor het behoud van de prestaties en betrouwbaarheid van uw applicaties.

本文总阅读量次