शुरुआत
यह गाइड आपको आरंभ करने के लिए मार्गदर्शन करेगा लॉगफायरआप सीखेंगे कि लॉगफायर कैसे स्थापित करें, अपने स्थानीय वातावरण को प्रमाणित करें, और कोड अवलोकन का पता लगाने के लिए ट्रेसिंग और स्पैनिंग का उपयोग करें।
स्थापित करें¶
नवीनतम संस्करण स्थापित करने के लिएलॉगफायर, कृपया चलाएं:
pip install logfire
rye add logfire
poetry add logfire
conda install -c conda-forge logfire
प्रमाणन¶
निम्न कमांड चलाकर, उपयोग करें लॉगफायर अपने स्थानीय वातावरण को सत्यापित करें:
लॉगफायर प्रमाणीकरण
यह आपके लिए एक्सेस करने के लिए एक ब्राउज़र विंडो खोलेगा logfire.pydantic.dev रजिस्टर या लॉग इन करें। सफल प्रमाणीकरण के बाद, क्रेडेंशियल्स को संग्रहीत किया जाएगा ~/.logfire/default.toml में।
मूल उपयोग¶
पहले एक नए वातावरण में उपयोग करेंलॉगफायरआपको एक परियोजना स्थापित करने की आवश्यकता है।लॉगफायरएक परियोजना डेटा को व्यवस्थित करने के लिए एक नामस्थान है। भेजने के लिएलॉगफायरसभी डेटा परियोजना से जुड़ा होना चाहिए।
उपयोग करने के लिए लॉगफायरयह बहुत सरल है।
import logfire
logfire.configure() # (1)!
logfire.info('Hello, {name}!', name='world') # (2)!
-
configure()इसे इनिशियलाइज़ करने के लिए लॉग इन करने से पहले एक बार कॉल किया जाना चाहिए लॉगफायर... -
यह रिकॉर्ड करेगा
信息स्तरHello world！...
!!!ध्यान
अन्य [लॉग स्तर][logfire.Logfire] इसके अलावा उपलब्ध है, जिसमें 'ट्रेस', 'डिबग', 'नोटिस', 'चेतावनी' शामिल हैं,
"गलत" और "घातक।"
यदि आपके पास किसी परियोजना के लिए मौजूदा क्रेडेंशियल्स नहीं हैं, तो आपको परियोजनाओं में से एक का चयन करने या एक नया बनाने के लिए प्रेरित किया जाएगा।
यदि आपके पास अभी तक कोई परियोजना नहीं है, तो कृपया उन्हें लिखें“n” और “Enter” एक नई परियोजना बनाने के लिए।
फिर, सिस्टम आपको अपना संगठन चुनने और अपनी नई परियोजना के लिए एक नाम प्रदान करने के लिए कहेगा:
आप पहले से ही वहां हैंलॉगफायरएक नई परियोजना बनाई गई!: p artying_face:
इस एक बार के सेटअप को पूरा करने के बाद,लॉगफायर नए बनाए गए प्रोजेक्ट क्रेडेंशियल्स का उपयोग उसी निर्देशिका से बाद के पायथन रन के लिए किया जाएगा।
???सफलता "आप वेब यूआई के माध्यम से परियोजनाएं भी बना सकते हैं "... यूआई में एक नई परियोजना बनाने के लिए, आप इन चरणों का पालन कर सकते हैं:
1. दर्ज करें[लॉगफायर वेब यूआई](https://logfire.pydantic.dev)...
2. "नया प्रोजेक्ट" बटन पर क्लिक करें, प्रकट होने वाले फॉर्म को भरें, और फिर "प्रोजेक्ट बनाएं" पर क्लिक करें।
करो! आप पहले से ही वहां हैं **लॉगफायर**में एक नई परियोजना बनाई गई है!: धूप का चश्मा:
???सफलता "आप सीएलआई के माध्यम से परियोजनाएं भी बना सकते हैं "... सीएलआई के माध्यम से परियोजनाएं बनाने के तरीके के बारे में अधिक जानकारी के लिए, देखें एसडीके सीएलआई प्रलेखन...
प्रोजेक्ट बनाने के बाद, आपको देखना चाहिए:
Logfire project URL: https://logfire.pydantic.dev/dmontagu/my-project
19:52:12.323 Hello, world!
लॉगफायरआप हमेशा उस के साथ शुरू करेंगे जो प्रोजेक्ट दिखाता है, और (with the default configuration) अंतिम बिंदु में लॉगफायर को भेजे गए लॉग का एक मूल प्रदर्शन भी प्रदान करेगा।
स्पैन के साथ ट्रैकिंग¶
स्पैन के साथ, आप लॉग में संदर्भ जोड़ सकते हैं और कोड निष्पादन समय को माप सकते हैं। सिस्टम के माध्यम से संक्रिया की यात्रा की पूरी तस्वीर प्रदान करते हुए, एक एकल प्रक्षेपवक्र बनाने के लिए कई स्पैन को जोड़ा जाता है।
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) की गणना करता है। -
आंतरिक अवधि प्रत्येक व्यक्तिगत फ़ाइल को पढ़ने में लगने वाले समय को मापती है।
-
अंत में, कुल आकार रिकॉर्ड करें।
अपने कोड का निरीक्षण करने के लिए निशान और स्पैन का उपयोग करके, आप देख सकते हैं कि संचालन में कितना समय लगता है, अड़चनों की पहचान करें, और अपने सिस्टम में अनुरोधों के प्रवाह का उच्च-स्तरीय दृश्य प्राप्त करें - अपने अनुप्रयोगों के प्रदर्शन और विश्वसनीयता को बनाए रखने के लिए अमूल्य।
本文总阅读量次