시작하기

이 가이드에서는Logfire를 시작하는 방법에 대해 설명합니다. Logfire를 설치하고 로컬 환경에 인증하고 추적 및 스패닝을 사용하여 코드 관찰 가능성을 감지하는 방법에 대해 배우게 됩니다.

설치¶

최신 버전의Logfire를 설치하려면 다음을 실행하십시오.

PIPRyePoetryConda

pip install logfire

rye add logfire

poetry add logfire

conda install -c conda-forge logfire

인증¶

다음 명령을 실행하여Logfire로 로컬 환경을 확인하십시오.

로그파이어 인증

그러면logfire.pydantic.dev에 등록하거나 로그인할 수 있는 브라우저 창이 열립니다. 인증에 성공하면 자격 증명이 ~/.logfire/default.toml 에 저장됩니다.

기본 용도¶

새로운 환경에서 처음 사용로그파이어프로젝트를 설정해야 합니다.로그파이어프로젝트는 데이터를 구성하는 네임스페이스입니다.로그파이어모든 데이터는 프로젝트와 연결되어야 합니다.

Logfire를 사용하려면 간단합니다.

import logfire

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

configure() 는 로그인하기 전에 한 번 호출하여Logfire를 초기화해야 합니다.
Hello world！ 를 信息 수준으로 기록합니다.

주의

'추적', '디버그', '알림', '경고'를 포함하여 다른로그 레벨도 사용할 수 있습니다. "잘못된"과 "치명적인".

프로젝트에 대한 기존 자격 증명이 없는 경우 프로젝트 중 하나를 선택하거나 새 프로젝트를 만들라는 메시지가 표시됩니다.

아직 프로젝트가 없는 경우 “n” 및 “Enter” 를 작성하여 새 프로젝트를 만드십시오.

그런 다음 시스템은 조직을 선택하고 새 프로젝트의 이름을 제공하도록 요청합니다.

Logfire에서 새 프로젝트를 만들었습니다!:p artying_face:

이 일회성 설정을 완료한 후Logfire는 동일한 디렉토리에서 후속 Python 실행에 대해 새로 생성된 프로젝트 자격 증명을 사용합니다.

???성공 "웹 UI를 통해 프로젝트를 만들 수도 있습니다. .."UI에서 새 프로젝트를 만들려면 다음 단계를 수행할 수 있습니다.

1. [Logfire 웹 UI](https://logfire.pydantic.dev)를 입력합니다.

![Logfire 웹 사용자 인터페이스](../../图片/指南/browser-create-project.png)

2. "새 프로젝트" 버튼을 클릭하고 나타나는 양식을 작성한 다음 "프로젝트 만들기"를 클릭합니다.

![새 프로젝트 버튼](../../图片/指南/browser-create-project-button.png)

해!**Logfire**에서 새 프로젝트를 만들었습니다! : 선글라스:

???성공 "CLI를 통해 프로젝트를 만들 수도 있습니다. .."CLI를 통해 프로젝트를 만드는 방법에 대한 자세한 내용은 을 참조하십시오. SDK CLI 설명서...

프로젝트를 만든 후 다음을 확인해야 합니다.

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

Logfire는 항상 프로젝트를 표시하는 URL로 시작하며 (기본 구성을 사용하여) 종료 지점에서 Logfire로 보내는 로그의 기본 표시도 제공합니다.

스팬으로 추적¶

스팬을 사용하면 로그에 컨텍스트를 추가하고 코드 실행 시간을 측정할 수 있습니다. 여러 스팬이 결합되어 단일 궤적을 형성하여 시스템을 통과하는 작업의 전체 경로를 보여줍니다.

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)를 계산합니다.
내부 범위는 각 개별 파일을 읽는 데 걸리는 시간을 측정합니다.
마지막으로 총 크기를 기록합니다.

추적 및 기간을 사용하여 코드를 검사하면 작업 시간을 확인하고 병목 현상을 식별하며 시스템의 요청 흐름을 높은 수준으로 볼 수 있습니다. 이는 애플리케이션의 성능과 안정성을 유지하는 데 매우 중요합니다.

本文总阅读量次