گزارش‌گیری

میترا در خروجی استاندارد گزارش می‌نویسد، پس docker compose logs همه چیز را نشان می‌دهد:

docker compose logs -f mitra

یک سرور سالم عمداً ساکت است: به‌طور پیش‌فرض فقط آنچه مهم است را ثبت می‌کند. هنگام ردیابی یک مشکل سطح را بالا ببرید و وقتی کارتان تمام شد دوباره پایین بیاورید.

تنظیم سطح

environment:
  MITRA_LOG_LEVEL: 'debug'

هر سطح همه چیزهای ساکت‌تر از خود را هم شامل می‌شود:

MITRA_LOG_LEVEL	آنچه می‌گیرید
error	فقط خطاها.
warn	مشکلاتی که میترا دور زده است هم، مانند یادآوری که تحویل داده نشد، جغرافیابی‌ای که پاسخ نداد یا ارائه‌دهنده ورودی که نتوانست به آن برسد.
info (پیش‌فرض)	آنچه هر روز مهم است هم: راه‌اندازی، ورودها، حساب‌های متصل‌شده، تغییرات همگام‌شده از ارائه‌دهندگان و یادآورهای فرستاده‌شده.
debug	هر درخواست با وضعیت و زمانش، هر همگام‌سازی، زمانی که همگام‌سازی با باز و بسته شدن میترا توسط افراد تندتر یا کندتر می‌شود، نشست‌ها، ویرایش موارد و گفتگو با سرورهای CalDAV هم.
trace	هر پرس‌وجوی پایگاه‌داده و داده خام تقویم هم. حجم آن زیاد است.

میترا هنگام راه‌اندازی سطحی را که با آن اجرا می‌شود ثبت می‌کند.

NOTE

گذرواژه‌ها، توکن‌ها و دیگر رازها هرگز در هیچ سطحی ثبت نمی‌شوند. اما debug و trace همچنان می‌توانند عنوان موارد و داده تقویم را نشان دهند، پس پیش از اشتراک‌گذاری یک گزارش آن را مرور کنید.

کدام سطح را استفاده کنیم

• وقتی تقویمی همگام نمی‌شود، debug هر همگام‌سازی و درخواست‌ها به CalDAV و Notion را نشان می‌دهد.
• وقتی یادآورها نمی‌رسند، info از پیش هر یادآور را هنگام ارسال ثبت می‌کند و debug هر تلاش تحویل و دستگاه‌های حذف‌شده را هم اضافه می‌کند.
• وقتی صفحه خطا می‌بینید، error آن را با ردپای پشته دارد و info پیش‌فرض آن را شامل می‌شود.
• وقتی باید دقیقاً ببینید ارائه‌دهنده چه فرستاده، trace داده خام و پرس‌وجوهای پایگاه‌داده را اضافه می‌کند. فقط برای مدت کوتاه روشنش بگذارید.