入門

このガイドでは、Logfireの使用を開始する方法を説明します。Logfireのインストール方法、ロケールの認証方法、およびトレースとスパンを使用してコードの観察可能性を検出する方法を学習します。

インストール¶

Logfireの最新バージョンをインストールするには、次のコマンドを実行します。

PIPRyePoetryConda

pip install logfire

rye add logfire

poetry add logfire

conda install -c conda-forge logfire

認証する¶

次のコマンドを実行して、Logfireを使用してロケール環境を検証します。

Logfire認証

これにより、logfire.pydantic.devに登録またはログインするためのブラウザウィンドウが開きます。認証が成功すると、資格情報は ~/.logfire/default.toml に保存されます。

基本的な使い方¶

Logfireを新しい環境で初めて使用する場合は、プロジェクトを設定する必要があります。Logfireプロジェクトは、データを整理するための名前空間です。Logfireに送信されるすべてのデータは、プロジェクトに関連付けられている必要があります。

Logfireを使うのは簡単です:

import logfire

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

configure() は、Logfireを初期化するためにログインする前に一度呼び出す必要があります。
これは 信息 レベルで Hello world！ を記録します。

注意する

他のログレベルも利用できます。'trace'、'debug'、'note'、'warn'、「間違い」と「致命的」。

アイテムの既存の資格情報がない場合は、アイテムの1つを選択するか、新しいアイテムを作成するように求められます。

まだプロジェクトがない場合は、“n” と “Enter” を書いて新しいプロジェクトを作成します。

次に、組織を選択し、新しいプロジェクトに名前を付けるように求められます。

Logfireに新しいプロジェクトを作成しました!:p_face:

この1回限りの設定が完了すると、Logfireは、新しく作成されたプロジェクト資格情報を使用して、同じディレクトリから後続のPython実行を実行します。

???成功“また、Web UIを介してプロジェクトを作成することができます.。。"UIで新しいプロジェクトを作成するには、次の手順に従います。

1. は[Logfire Web UI](https://logfire.pydantic.dev)にアクセスします。

![Logfire Webユーザーインターフェース](../../图片/指南/browser-create-project.png)

2. 「新規プロジェクト」ボタンをクリックし、表示されたフォームに入力し、「プロジェクトの作成」をクリックします。

![[新規プロジェクト]ボタン](../../图片/指南/browser-create-project-button.png)

やって!あなたはすでに **ログファイア**新しいプロジェクトが作成されました!:サングラス:

???成功“また、CLIを介してプロジェクトを作成することができます.。。"CLIでプロジェクトを作成する方法の詳細については、こちらをご覧ください SDK CLIドキュメント。

プロジェクトを作成すると、次のようになります。

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

Logfireは、常にアイテムのURLを表示することから始まり、（デフォルトの構成を使用して）Logfireに送信したログの基本的な表示もターミナルで提供します。

Spanを使用したトレース¶

スパンを使用すると、ログにコンテキストを追加したり、コードの実行時間を測定したりできます。複数のスパンが組み合わさってトラックを形成し、システム内の操作の旅の全体像を提供します。

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)

この例では:

外部スパン測定は、現在のディレクトリ内のファイルの合計サイズ(cwd)を計算する時間を測定します。
内部スパンは、個々のファイルを読み取る時間を測定します。
最後に、合計サイズを記録します。

トレースとスパンを使用してコードを検出することで、操作にかかる時間を確認し、ボトルネックを特定し、システム内の要求フローの高度なビューを取得できます。これは、アプリケーションのパフォーマンスと信頼性を維持するために非常に貴重です。

本文总阅读量次