گزارش log
ثبت رویدادهای برنامه با سطح اهمیت، پیشوند، فیلدهای ساختاریافته، قالب JSON و نوشتن در پرونده.
واردسازی گزارش
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
برای برنامهای که روی سرور اجرا میشود، سرچاپ کافی نیست: باید بدانید هر پیام چقدر مهم است و کی ثبت شده، و بتوانید پیامهای کماهمیت را خاموش کنید. بستهی گزارش چهار سطح دارد (اشکالزدایی، اطلاعات، هشدار، خطا) و فقط پیامهایی را ثبت میکند که سطحشان از سطح تنظیمشده کمتر نباشد؛ سطح پیشفرض «اطلاعات» است. هر خط به شکل متن ساده یا یک شیء JSON به خروجی خطا، خروجی استاندارد یا پروندهای چرخشی نوشته میشود.
یک خط متنی این شکل را دارد: 2026-10-17 13:09:22 [INFO] shop order 1042 accepted، یعنی زمان محلی، سطح، پیشوند و پیام. نمونههای پایین برای ثابت ماندن خروجی، زمان را با نمایش زمان(نادرست) خاموش کردهاند.
همهی تنظیمات برای کل برنامه یکی است: تنظیم سطح، تنظیم قالب، تنظیم پیشوند و یکی از به خطای استاندارد، به خروجی استاندارد یا به پرونده را یک بار نزدیک آغاز ریشه صدا بزنید تا هر بستهای که گزارش را وارد میکند به همان شکل بنویسد. برای نگاهی سریع به یک مقدار هنگام کار روی کد، بستهی اشکال زدایی مناسبتر است و برای زمانسنجی و آمار حافظه، زمان اجرا.
اشتباههای رایج:
- گزارش پروندهای میانگیر (بافر) دارد. خطها وقتی به دیسک میرسند که میانگیر پر شود یا
بستن پروندهصدا زده شود؛ پسtail -fعقب میماند و اگر برنامه از کار بیفتد خطهای آخر از دست میروند. در هر مسیر خروج از برنامهبستن پروندهرا صدا بزنید. - قالب متنی پیام را همانطور که هست مینویسد. مقداری از کاربر که شکستن خط دارد یک خط گزارش جعلی میسازد؛ ولی JSON آن را به شکل
\nدرون رشته نگه میدارد (پایینتر را ببینید). - تنظیمات متغیرهای سراسری سادهاند و قفلی ندارند. فقط هنگام شروع برنامه تغییرشان دهید، نه وقتی نخهای دیگر در حال گزارشاند.
- زمان، زمان محلی و بدون اختلاف منطقهی زمانی است، در JSON هم. اگر گزارش چند ماشین را کنار هم میگذارید، سرورها را با
TZ=UTCاجرا کنید.
سطح را از تنظیمات بخوانید
سطح گزارش نباید در کد ثابت باشد. هنگام توسعه پیامهای اشکالزدایی را میخواهید و روی سروری پرکار فقط هشدار و خطا را. سطح را به شکل متن از پروندهی تنظیمات یا محیط بخوانید و با تجزیه سطح به عدد تبدیلش کنید. این تابع debug، info، warn، warning و error را با هر اندازهی حروفی میپذیرد و برای هر چیز دیگری «اطلاعات» را برمیگرداند؛ پس یک غلط تایپی هیچوقت گزارش را کاملاً خاموش نمیکند.
واردسازی گزارش
واردسازی پیکربندی
تابع راه اندازی(متن: رشته):
ناپایا پ := پیکربندی.تجزیه محیط(متن)
دیرکن پیکربندی.آزادسازی(پ)
سطح := گزارش.تجزیه سطح(پیکربندی.دریافت با پیش فرض(پ، "LOG_LEVEL"، "info"))
گزارش.تنظیم سطح(سطح)
گزارش.تنظیم پیشوند(پیکربندی.دریافت با پیش فرض(پ، "APP_NAME"، "برنامه"))
سرچاپ "-- سطح"، گزارش.نام سطح(گزارش.دریافت سطح())
پایان
تابع کار():
گزارش.اشکال زدایی("جستوجوی حافظهی نهان برای کلید user:7")
گزارش.اطلاعات("سفارش ۱۰۴۲ پذیرفته شد")
گزارش.هشدار("درگاه پرداخت دیر جواب داد")
گزارش.خطا("رسید به ایمیل فرستاده نشد")
پایان
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
راه اندازی("LOG_LEVEL=debug\nAPP_NAME=فروشگاه\n")
کار()
راه اندازی("LOG_LEVEL=warning\nAPP_NAME=فروشگاه\n")
کار()
راه اندازی("LOG_LEVEL=loud\n")
کار()
پایانبستهی پیکربندی که اینجا به کار رفته صفحهی خودش را دارد: پیکربندی. پیشوند جای خوبی برای نام برنامه است تا خطهای چند برنامه در یک گزارش از هم جدا بمانند.
گزارش JSON برای ابزارهای جمعآوری
خواندن خطهای متنی آسان است و جستوجو در خطهای JSON برای ابزارهایی مثل Loki، Elasticsearch یا سرویسهای گزارش ابری. تنظیم قالب(قالب جیسون) هر خط را یک شیء JSON میکند با level، prefix اگر تنظیم شده باشد، msg و یک عضو برای هر کلیدی که به تابعهای «با فیلد» دادهاید. اگر نمایش زمان روشن باشد، عضو time با قالب ISO 8601 اول میآید.
واردسازی گزارش
واردسازی رشته
ساختار درخواست:
همگانی روش: رشته = ""
همگانی مسیر: رشته = ""
همگانی وضعیت: صحیح = ۰
همگانی زمان: صحیح = ۰
پایان
تابع ثبت درخواست(د: درخواست):
ناپایا کلیدها := وکتور {} برگردان وکتور<رشته>
ناپایا مقدارها := وکتور {} برگردان وکتور<رشته>
دیرکن کلیدها.آزادکن()
دیرکن مقدارها.آزادکن()
کلیدها.بیفزا("method")
مقدارها.بیفزا(د.روش)
کلیدها.بیفزا("path")
مقدارها.بیفزا(د.مسیر)
کلیدها.بیفزا("status")
مقدارها.بیفزا(رشته.از عدد(د.وضعیت برگردان صحیح۶۴))
کلیدها.بیفزا("ms")
مقدارها.بیفزا(رشته.از عدد(د.زمان برگردان صحیح۶۴))
اگر د.وضعیت >= ۵۰۰:
گزارش.خطا با فیلد("درخواست شکست خورد"، کلیدها، مقدارها)
وگرنه د.وضعیت >= ۴۰۰:
گزارش.هشدار با فیلد("درخواست رد شد"، کلیدها، مقدارها)
وگرنه:
گزارش.اطلاعات با فیلد("درخواست انجام شد"، کلیدها، مقدارها)
پایان
پایان
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
گزارش.تنظیم قالب(گزارش.قالب جیسون)
گزارش.تنظیم پیشوند("api")
ثبت درخواست(درخواست { روش = "GET"، مسیر = "/products"، وضعیت = ۲۰۰، زمان = ۱۲ })
ثبت درخواست(درخواست { روش = "POST"، مسیر = "/login"، وضعیت = ۴۰۱، زمان = ۳ })
ثبت درخواست(درخواست { روش = "GET"، مسیر = "/report \"q3\""، وضعیت = ۵۰۳، زمان = ۹۵۰ })
پایاناگر سطح را از نتیجه انتخاب کنید (خطا برای پاسخهای 5xx و هشدار برای 4xx)، میتوانید بدون خواندن همهی درخواستها روی خطاها هشدار بگذارید. گیومههای درون مقدار گریز داده میشوند تا هر خط JSON معتبری بماند. همهی مقدارها، حتی عددها، به شکل رشتهی JSON نوشته میشوند.
گزارش در پروندهای که بیپایان بزرگ نمیشود
به پرونده به انتهای پرونده میافزاید و صفر برمیگرداند، یا منفی یک اگر پرونده باز نشود. تنظیم چرخش(بیشترین بایت، تعداد پشتیبان) اندازهاش را مهار میکند: وقتی پرونده به آن اندازه رسید، خط بعدی اول آن را به .1 تغییر نام میدهد، نسخههای قدیمیتر را یک شماره بالا میبرد و پروندهی تازه و خالی را شروع میکند. نسخههایی که از تعداد پشتیبان بیشتر شوند پاک میشوند.
واردسازی گزارش
واردسازی سیستم عامل
واردسازی ورودی خروجی
واردسازی رشته
تابع خط اول(مسیر: رشته): رشته:
خطها := ورودی خروجی.خواندن پرونده(مسیر).بشکاف("\n")
دیرکن خطها.آزادکن()
برگشت خطها.بگیر(۰)
پایان
تابع ریشه:
پروندهها := ["worker.log"، "worker.log.1"، "worker.log.2"، "worker.log.3"]
هر پ در پروندهها:
سیستم عامل.حذف(پ)
پایان
گزارش.نمایش زمان(نادرست)
اگر گزارش.به پرونده("worker.log") != ۰:
سرچاپ "worker.log باز نشد"
برگشت ۱
پایان
گزارش.تنظیم چرخش(۱۲۰، ۲)
تکرار ۲۴ در ش:
گزارش.اطلاعات("کار شمارهی " + رشته.از عدد(ش برگردان صحیح۶۴) + " انجام شد")
پایان
گزارش.بستن پرونده()
هر پ در پروندهها:
اگر سیستم عامل.وجود دارد(پ):
سرچاپ پ، "با این خط شروع میشود:"، خط اول(پ)
وگرنه:
سرچاپ پ، "وجود ندارد"
پایان
پایان
پایاناندازهی اینجا خیلی کوچک است تا نمونه چند بار بچرخد. یک سرویس واقعی چیزی مثل ۱۰ * ۱۰۲۴ * ۱۰۲۴ بایت و پنج پشتیبان به کار میبرد. اندازه پیش از نوشتن هر خط بررسی میشود، پس پرونده ممکن است یک خط از حد بلندتر شود. پیش از پایان برنامه بستن پرونده را صدا بزنید، وگرنه خطهای آخر در میانگیر میمانند؛ مهلک پیش از خروج با کد ۱ خودش پرونده را میبندد.
فیلدهای کلید و مقدار در گزارش متنی
در گزارش متنی، فیلد، فیلد عدد و فیلد منطقی تکههای کلید=مقدار میسازند و کلید مقدار آنها را پشت یک پیام میچیند. فیلد دور مقداری که فاصله یا گیومه دارد گیومه میگذارد و گیومههای درونش را گریز میدهد، تا یک برنامه هنوز بتواند خط را به فیلدهایش بشکند.
واردسازی گزارش
تابع خط ورود(کاربر: رشته، تلاشها: صحیح۶۴، موفق: منطقی، عامل: رشته): رشته:
ناپایا فیلدها := وکتور {} برگردان وکتور<رشته>
دیرکن فیلدها.آزادکن()
فیلدها.بیفزا(گزارش.فیلد("user"، کاربر))
فیلدها.بیفزا(گزارش.فیلد عدد("attempts"، تلاشها))
فیلدها.بیفزا(گزارش.فیلد منطقی("ok"، موفق))
فیلدها.بیفزا(گزارش.فیلد("agent"، عامل))
برگشت گزارش.کلید مقدار("ورود"، فیلدها)
پایان
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
گزارش.اطلاعات(خط ورود("سارا"، ۱، درست، "curl/8.5"))
گزارش.هشدار(خط ورود("کاربر مهمان"، ۳، نادرست، "my \"test\" bot"))
سرچاپ گزارش.فیلد("empty"، "")
سرچاپ گزارش.فیلد("path"، "/a b")
پایانمقدار خالی به شکل key= بدون چیزی پس از آن نوشته میشود. فقط فاصله و نقلقول باعث گذاشتن نقلقول میشوند: نویسهی tab، بکاسلش یا شکستن خط بیتغییر میگذرد. این تابعها فقط متن میسازند؛ وقتی نتیجه را به اطلاعات یا هشدار میدهید، صافی سطح همچنان اعمال میشود.
پیامهای قالبدار و مقدارهایی که از کاربر میآیند
اطلاعات قالبی و دیگر تابعهای قالبی هر {} را با رشتهی بعدی یک وکتور پر میکنند که از زنجیرهای از + خواناتر است. این تابعها مقدارها را پاکسازی نمیکنند. اینجا نام کاربری که شکستن خط دارد در گزارش متنی یک خط [ERROR] جعلی میسازد، ولی خط JSON آن را به شکل \n درون یک رشته نگه میدارد.
واردسازی گزارش
تابع جفت(الف: رشته، ب: رشته): وکتور<رشته>:
ناپایا فهرست := وکتور {} برگردان وکتور<رشته>
فهرست.بیفزا(الف)
فهرست.بیفزا(ب)
برگشت فهرست
پایان
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
نام := "مینا\n[ERROR] disk full"
مقدارها := جفت(نام، "10.0.0.7")
دیرکن مقدارها.آزادکن()
گزارش.اطلاعات قالبی("کاربر {} از {} وارد شد"، مقدارها)
کلیدها := جفت("user"، "ip")
دیرکن کلیدها.آزادکن()
گزارش.تنظیم قالب(گزارش.قالب جیسون)
گزارش.اطلاعات با فیلد("کاربر وارد شد"، کلیدها، مقدارها)
گزارش.تنظیم قالب(گزارش.قالب متن)
گزارش.تنظیم سطح(گزارش.سطح خطا + ۱)
گزارش.خطا("این را کسی نمیبیند")
گزارش.تنظیم سطح(گزارش.سطح اطلاعات)
گزارش.اطلاعات("گزارش دوباره روشن شد")
پایانپایان نمونه ترفندی برای آزمونها و ابزارهای کمحرف را نشان میدهد: سطحی بالاتر از سطح خطا همه چیز را خاموش میکند و برگرداندن سطح، گزارش را دوباره روشن میکند.
ثبت از چند نخ بدون توقف
نوشتن روی مقصد پشت قفل انجام میشود، پس چند نخ میتوانند همزمان تابعهای گزارش را صدا بزنند و حرفها در هم نروند. برای مسیرهای پرترافیک یک گام جلوتر بروید: شروع ناهمگام(ظرفیت) یک نخ نویسنده و یک کانال با ظرفیت دادهشده راه میاندازد. هر فراخوانی خطش را قالب میکند و به کانال میسپارد؛ وقتی کانال پر شود فراخواننده صبر میکند و همین فشار برگشتی حافظه را محدود نگه میدارد. نویسنده کانال را به ترتیب خالی میکند، پس خطهای یک نخ ترتیبشان را نگه میدارند و خطهای نخهای مختلف فقط بین پیامهای کامل در هم میآیند.
// زبان: فارسی
بسته ریشه
واردسازی گزارش
تابع ریشه:
گزارش.نمایش زمان(نادرست)
گزارش.به خروجی استاندارد()
گزارش.تنظیم پیشوند("async")
آغازشده := گزارش.شروع ناهمگام(4 برگردان صحیح۶۴)
گزارش.اطلاعات("one")
گزارش.اطلاعات("two")
گزارش.تخلیه()
گزارش.توقف ناهمگام()
سرچاپ "started:"، آغازشده
پایانشروع ناهمگام وقتی حالت ناهمگام از قبل روشن است نادرست برمیگرداند؛ فراخوانی دوم نویسندهی دیگری نمیسازد. تخلیه صبر میکند تا هر خطی که تا این لحظه ثبت شده به مقصد برسد، و توقف ناهمگام پس از خالی کردن صف نویسنده را میبندد و آزاد میکند. ظرفیت صفر صف را به یک کانال بیبافر تبدیل میکند، پس هر فراخوانی تا برداشتن خطش توسط نویسنده صبر میکند. مهلک پیش از خروج تخلیه میکند.
سطح، پیشوند، قالب و مقصد را پیش از روشن کردن نویسنده تنظیم کنید؛ اینها هنوز متغیرهای سراسریاند و برای تغییر هنگام ثبت نخهای دیگر ساخته نشدهاند. اگر توقف ناهمگام صدا زده نشود، نویسنده تا پایان برنامه میماند؛ خطهای تخلیهشده در اماناند، ولی آخرین خطهای در صف در یک از کار افتادن مثل یک پروندهی میانگیر از دست میروند.
کدام تابع برای کدام کار
| میخواهید | به کار ببرید |
|---|---|
| یک پیام ساده | اشکال زدایی، اطلاعات، هشدار، خطا |
| پیامی که مقدارهایی در آن پر میشود | اطلاعات قالبی و بقیهی تابعهای «قالبی»، با جاینگهدار {} |
| فیلدهایی که ابزارها در آنها جستوجو کنند | اطلاعات با فیلد و بقیهی تابعهای «با فیلد»، بهتر از همه با قالب جیسون |
| سطح به شکل یک متغیر | ثبت(سطح، پیام) |
| توقف برنامه پس از خطایی جبرانناپذیر | مهلک |
| خروجی برای کانتینر یا systemd | حالت پیشفرض، به خطای استاندارد |
پایاها و متغیرها
سطح اشکال زدایی LevelDebug
پایا سطح اشکال زدایی: صحیح۳۲ = 0واردسازی گزارش
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
گزارش.تنظیم پیشوند("[برنامه]")
گزارش.اشکال زدایی("این دیده نمیشود")
گزارش.اطلاعات("سرور آماده است")
گزارش.هشدار("حافظه رو به پایان است")
گزارش.خطا("اتصال قطع شد")
گزارش.تنظیم سطح(گزارش.سطح اشکال زدایی)
گزارش.اشکال زدایی("حالا دیده میشود")
گزارش.ثبت(گزارش.سطح هشدار، "با سطح دلخواه")
سرچاپ گزارش.دریافت سطح()، گزارش.نام سطح(گزارش.سطح خطا)، گزارش.تجزیه سطح("warn")، گزارش.سطح اطلاعات
پایانسطح اطلاعات LevelInfo
پایا سطح اطلاعات: صحیح۳۲ = 1نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
سطح هشدار LevelWarn
پایا سطح هشدار: صحیح۳۲ = 2نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
سطح خطا LevelError
پایا سطح خطا: صحیح۳۲ = 3نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
قالب متن FormatText
پایا قالب متن: صحیح۳۲ = 0واردسازی گزارش
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
ناپایا کلیدها := وکتور {} برگردان وکتور<رشته>
ناپایا مقدارها := وکتور {} برگردان وکتور<رشته>
دیرکن کلیدها.آزادکن()
دیرکن مقدارها.آزادکن()
کلیدها.بیفزا("user")
مقدارها.بیفزا("sara")
کلیدها.بیفزا("ms")
مقدارها.بیفزا("42")
گزارش.اطلاعات با فیلد("درخواست انجام شد"، کلیدها، مقدارها)
گزارش.هشدار با فیلد("کند بود"، کلیدها، مقدارها)
گزارش.خطا با فیلد("شکست خورد"، کلیدها، مقدارها)
گزارش.تنظیم سطح(گزارش.سطح اشکال زدایی)
گزارش.اشکال زدایی با فیلد("جزئیات"، کلیدها، مقدارها)
گزارش.تنظیم قالب(گزارش.قالب جیسون)
گزارش.اطلاعات("به شکل جیسون")
سرچاپ گزارش.دریافت قالب() == گزارش.قالب جیسون، گزارش.قالب متن
ناپایا ف := وکتور {} برگردان وکتور<رشته>
دیرکن ف.آزادکن()
ف.بیفزا(گزارش.فیلد("path"، "/login"))
ف.بیفزا(گزارش.فیلد عدد("status"، ۲۰۰))
ف.بیفزا(گزارش.فیلد منطقی("cached"، نادرست))
سرچاپ گزارش.کلید مقدار("پاسخ"، ف)
پایانقالب جیسون FormatJSON
پایا قالب جیسون: صحیح۳۲ = 1نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
تابعها
نام سطح LevelName
تابع نام سطح(l: صحیح): رشتهDEBUG، INFO، WARN یا ERROR. هر عدد کمتر از ۰ اشکالزدایی و هر عدد بیشتر از ۳ خطا حساب میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
تجزیه سطح ParseLevel
تابع تجزیه سطح(s: رشته): صحیح"warn" را، بیتوجه به حروف کوچک و بزرگ و فاصلههای دو طرف، به سطح تبدیل میکند. debug، info، warn، warning و error را میشناسد و برای هر چیز دیگر «اطلاعات» میدهد.نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
تنظیم سطح SetLevel
تابع تنظیم سطح(l: صحیح)سطح خطا + ۱ گزارش را خاموش میکند.نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
دریافت سطح GetLevel
تابع دریافت سطح(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
تنظیم پیشوند SetPrefix
تابع تنظیم پیشوند(p: رشته)prefix است. رشتهی خالی آن را برمیدارد.نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
نمایش زمان ShowTime
تابع نمایش زمان(b: منطقی)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
تنظیم قالب SetFormat
تابع تنظیم قالب(f: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
دریافت قالب GetFormat
تابع دریافت قالب(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
تنظیم چرخش SetRotation
تابع تنظیم چرخش(max_bytes: صحیح۶۴، max_backups: صحیح)max_bytes رسید، خط بعدی آن را به .1 تغییر نام میدهد، نسخههای قدیمیتر را یک شماره بالا میبرد و پروندهی تازهای شروع میکند؛ حداکثر max_backups نسخهی قدیمی میماند. صفر بایت چرخش را خاموش میکند.واردسازی گزارش
واردسازی ورودی خروجی
تابع ریشه:
گزارش.نمایش زمان(نادرست)
سرچاپ گزارش.به پرونده("app.log")
گزارش.تنظیم چرخش(۱۰۲۴ * ۱۰۲۴، ۳)
گزارش.اطلاعات("نوشته شد در پرونده")
گزارش.بستن پرونده()
گزارش.به خطای استاندارد()
چاپ ورودی خروجی.خواندن پرونده("app.log")
پایانبه خطای استاندارد ToStderr
تابع به خطای استاندارد()نمونهی این مورد همراه با موارد بالاتر آمده است: log-ToFile.salam
به خروجی استاندارد ToStdout
تابع به خروجی استاندارد()نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
به پرونده ToFile
تابع به پرونده(path: رشته): صحیحبستن پرونده در میانگیر میمانند.نمونهی این مورد همراه با موارد بالاتر آمده است: log-ToFile.salam
بستن پرونده CloseFile
تابع بستن پرونده()نمونهی این مورد همراه با موارد بالاتر آمده است: log-ToFile.salam
شروع ناهمگام StartAsync
تابع شروع ناهمگام(capacity: صحیح۶۴): منطقی// زبان: فارسی
بسته ریشه
واردسازی گزارش
تابع ریشه:
گزارش.نمایش زمان(نادرست)
گزارش.به خروجی استاندارد()
گزارش.تنظیم پیشوند("async")
آغازشده := گزارش.شروع ناهمگام(4 برگردان صحیح۶۴)
گزارش.اطلاعات("one")
گزارش.اطلاعات("two")
گزارش.تخلیه()
گزارش.توقف ناهمگام()
سرچاپ "started:"، آغازشده
پایانتوقف ناهمگام StopAsync
تابع توقف ناهمگام()نمونهی این مورد همراه با موارد بالاتر آمده است: log-Async.salam
تخلیه Flush
تابع تخلیه()نمونهی این مورد همراه با موارد بالاتر آمده است: log-Async.salam
ناهمگام است IsAsync
تابع ناهمگام است(): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: log-Async.salam
ثبت Log
تابع ثبت(l: صحیح، msg: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
اشکال زدایی Debug
تابع اشکال زدایی(msg: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
اطلاعات Info
تابع اطلاعات(msg: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
هشدار Warn
تابع هشدار(msg: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
خطا Error
تابع خطا(msg: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Info.salam
اشکال زدایی قالبی Debugf
تابع اشکال زدایی قالبی(tmpl: رشته، args: وکتور<رشته>){} با رشتهی بعدی از args پر میشود.واردسازی گزارش
تابع ریشه:
گزارش.به خروجی استاندارد()
گزارش.نمایش زمان(نادرست)
ناپایا م := وکتور {} برگردان وکتور<رشته>
دیرکن م.آزادکن()
م.بیفزا("سارا")
م.بیفزا("۳")
گزارش.اطلاعات قالبی("کاربر {} وارد شد و {} پیام دارد"، م)
گزارش.هشدار قالبی("تلاش ناموفق برای {}"، م)
گزارش.خطا قالبی("کاربر {} مسدود شد"، م)
گزارش.تنظیم سطح(گزارش.سطح اشکال زدایی)
گزارش.اشکال زدایی قالبی("شناسه {}"، م)
پایاناطلاعات قالبی Infof
تابع اطلاعات قالبی(tmpl: رشته، args: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Infof.salam
هشدار قالبی Warnf
تابع هشدار قالبی(tmpl: رشته، args: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Infof.salam
خطا قالبی Errorf
تابع خطا قالبی(tmpl: رشته، args: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-Infof.salam
مهلک Fatal
تابع مهلک(msg: رشته)دیرکنها اجرا شوند. نمونهاش اینجا اجرا نمیشود.واردسازی گزارش
تابع ریشه:
گزارش.مهلک("پروندهی پیکربندی پیدا نشد")
پایانفیلد Field
تابع فیلد(key: رشته، val: رشته): رشتهkey=value میسازد و مقداری را که فاصله یا نقلقول دارد در نقلقول میگذارد.نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
فیلد عدد FieldInt
تابع فیلد عدد(key: رشته، val: صحیح۶۴): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
فیلد منطقی FieldBool
تابع فیلد منطقی(key: رشته، val: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
کلید مقدار KV
تابع کلید مقدار(msg: رشته، fields: وکتور<رشته>): رشتهاطلاعات و بقیه داده شود.نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
اشکال زدایی با فیلد DebugKV
تابع اشکال زدایی با فیلد(msg: رشته، keys: وکتور<رشته>، vals: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
اطلاعات با فیلد InfoKV
تابع اطلاعات با فیلد(msg: رشته، keys: وکتور<رشته>، vals: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
هشدار با فیلد WarnKV
تابع هشدار با فیلد(msg: رشته، keys: وکتور<رشته>، vals: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam
خطا با فیلد ErrorKV
تابع خطا با فیلد(msg: رشته، keys: وکتور<رشته>، vals: وکتور<رشته>)نمونهی این مورد همراه با موارد بالاتر آمده است: log-InfoKV.salam