شروع به کار
پس از فعال‌سازی این سرویس، آدرس یک Datasource از نوع Grafana Loki (شامل آدرس اتصال، نام کاربری و رمز عبور) در اختیارتان قرار می‌گیرد که با اتصال این دیتاسورس به گرافانا (Grafana) می‌توانید روی لاگ‌هایتان query بزنید.
فعال‌سازی
برای فعال‌سازی سرویس لاگ، از نوار کناری روی آیکون لاگ و سپس دکمه فعال‌سازی کلیک کنید.
پس از فعال‌سازی، در صفحه ذخیره سازی، یک دیتا استور Grafana Loki به صورت پیشفرض برای سازمان شما ساخته میشود.
با کلیک بر روی این دیتا استور وارد صفحه جزئیات آن میشوید. اطلاعات مورد نیاز برای اتصال به این دیتا استور از جمله آدرس کوئری و دسترسی مورد نظر داخل این صفحه می باشد.
با استفاده از اطلاعات این قسمت می‌توانید به اندپوینت کوئری Grafana Loki متصل شوید. در صورتی که هم‌اکنون از گرافانا (در بستر هم‌روش یا هر جای دیگری) استفاده می‌کنید، می‌توانید به سادگی یک Datasource از نوع Loki بسازید و مشخصات بالا را وارد کنید.
در نظر داشته باشید در حال حاضر دیتا استور Grafana Loki پیشفرض ساخته شده با پلن فعلی،تا ۲۴ ساعت لاگ نگهداری میکند.
ساخت و اتصال به گرافانا
گرافانا (Grafana) ابزاری پر کاربرد برای مصورسازی (Visualization) داده‌هاست. در صورتی که از گرافانا استفاده نمی‌کنید، می‌توانید با کلیک بر اتصال به گرافانا به سادگی یک اپ جدید گرافانا بسازید. پس از راه‌اندازی گرافانا و ورود در آن، برای ساخت Datasource جدید، روی گزینه‌ی «Add data source» کلیک کنید سپس در صفحه‌ی انتخاب نوع Datasource روی گزینه‌ی «Loki» کلیک کنید.
در صفحه‌ی وارد کردن اطلاعات دسترسی، مقادیر زیر را وارد کنید: در قسمت url، مقدار «آدرس» دیتاسورس در سرویس لاگ را قرار دهید. سپس در قسمت «Auth» گزینه‌ی «Basic auth» را فعال کنید. در قسمت «Basic Auth Details» مقادیر «User» و «Password» را مطابق اطلاعات دیتاسورس تکمیل کنید.
در انتها با کلیک روی گزینه‌ی «Save & test» دیتاسورس شما به گرافانا اضافه میشود و امکان استفاده از آن را دارید.
جمع‌آوری لاگ‌های لایه اپلیکیشن
برای اینکه لاگ‌های اپلیکیشن‌های شما جمع‌آوری و ذخیره شوند، می‌توانید روی اپلیکیشن مورد نظر خود کلیک کنید، و از منوی کناری، گزینه جمع‌آوری لاگ را انتخاب کنید. در صفحه‌ای که باز میشود، در صورتی که می‌خواهید لاگ‌های stdout جمع‌آوری شوند، روی دکمه فعال‌سازی آن کلیک کنید؛ و اگر می‌خواهید لاگ‌های یک یا چند فایل مختلف را جمع‌آوری کنید، در قسمت Path، مسیر فایل(های) مورد نظر خود را ثبت کنید.
بعد از زدن دکمه‌ی «ذخیره تغییرات» سرویس لاگ از روی مشخصاتی که تعریف کردید، تنظیمات خود را بروزرسانی میکند و لاگ‌های شما جمع‌آوری و در Loki ذخیره میشود. هم‌اکنون می‌توانید در گرافانا به تب «Explore» بروید و در قسمت وارد کردن کوئری، با کلیک بر روی دکمه "Log Browser" برچسب‌هایی را مشاهده کنید که با استفاده از آن‌ها می‌توانید لاگ‌های خود را فیلتر و در آن جستجو کنید.
غیر فعال‌سازی
برای غیر فعال‌سازی سیستم لاگ،در بخش ذخیره سازی، روی آیکون سطل زباله دیتا استور مورد نظر کلیک کنید.