☰ فهرست مستندات · سنجه‌های لاگ
سنجه‌های لاگ
لاگ‌های ساخت‌یافته‌تان را به عدد روزانه و ماهانه تبدیل کنید: شمردن خط‌ها، جمع یک فیلد عددی یا شمردن مقدارهای متفاوت، با تفکیک بر اساس هر فیلد، فهرست برترین‌ها و سقف مرجع ماهانه. بدون SDK اضافه و بدون هزینه‌ی اضافه.
عددهایی از دل لاگ‌هایی که سرورها و اپ‌هایتان همین حالا می‌فرستند: چند بار یک پیام ثبت شده، جمع یک فیلد عددی، یا یک فیلد چند مقدار متفاوت داشته، روزانه و ماهانه.
کنسول ابرووا ← پروژه‌ی شما ← تریس ← بینش‌ها ← سنجه‌های لاگ. تا ۲۰ سنجه برای هر پروژه، بدون هزینه‌ی اضافه.
۱. یک پیام ثابت با فیلدها ثبت کنید#
سنجه خط‌ها را با پیامشان انتخاب می‌کند، پس هر بار همان متن را ثبت کنید و آنچه تغییر می‌کند را در فیلدها (metadata) بگذارید:
// Node.js SDK
AbrovaTrace.info('call: ended', { durationMs: 650022, relayMs: 412000, accountId: user.accountId });عددها عدد بمانند (412000، نه "412 s"). فیلدها می‌توانند تودرتو باشند (device.model).
۲. سنجه بسازید#
تریس ← بینش‌ها را باز کنید و در سنجه‌های لاگ یک سنجهٔ تازه بسازید:
| تنظیم | چه می‌کند |
|---|---|
| پیام‌ها | یک تا ۱۰ پیام دقیق، مثلاً `call: ended`. خط‌هایی با پیام دیگر کنار گذاشته می‌شوند. |
| عملیات | **شمردن** خط‌ها، **جمع** یک فیلد عددی، یا **شمردن مقدارهای متفاوت** یک فیلد. |
| فیلد | برای جمع و مقدارهای متفاوت: نام فیلد، مثلاً `relayMs` یا `device.model`. |
| شرط‌ها | تا ۵ شرط: فیلد برابر، متفاوت، بزرگ‌تر یا کوچک‌تر از یک مقدار باشد، یا باشد یا نباشد. مثال: `relayMs` بزرگ‌تر از ۰. |
| تفکیک بر اساس | تا ۲ فیلد. هر مقدار عدد خودش را دارد و ۱۰ تای برتر فهرست می‌شوند، مثلاً تفکیک با `accountId` تا ببینید چه کسی بیشترین مصرف را داشته. |
| واحد | برای جمع: میلی‌ثانیه، ثانیه یا بایت، که به دقیقه، ساعت، مگابایت یا گیگابایت نشان داده می‌شود. |
| مرجع ماهانه | اختیاری. هر ردیف برتر سهمش از آن را در هر ماه نشان می‌دهد، مثلاً ۱۰ ساعت برای هر حساب: هر کس نزدیک آن است در ۹۰٪ دیده می‌شود. |
چند مثال:
| پرسش | سنجه |
|---|---|
| زمان رله در هر ماه | جمع `relayMs` روی `call: ended`، واحد میلی‌ثانیه |
| حساب‌هایی که از رله استفاده کردند | شمردن مقدارهای متفاوت `accountId` روی `call: ended`، با شرط `relayMs` بزرگ‌تر از ۰ |
| تماس‌های شروع‌شده بر اساس نتیجه | شمردن `call: started`، تفکیک با `relayAvailable` و `relayBlockedBy` |
| اشتراک‌های پولی تازه | شمردن `plans: confirmed` |
۳. عددها را بخوانید#
هر سنجه روزانه (۳۰ روز گذشته) یا ماهانه (۱۲ ماه گذشته)، جمع آن بازه و وقتی تفکیک شده ۱۰ مقدار برتر را نشان می‌دهد. خطی که فیلد تفکیکش را ندارد به‌صورت (بدون مقدار) می‌آید. اگر یک روز بیش از ۲۰۰ مقدار متفاوت باشد، کوچک‌ترها زیر دیگر جمع می‌شوند.
- روزها به وقت UTC هستند. عددها هر چند دقیقه به‌روز می‌شوند.
- سنجهٔ تازه یا تغییرکرده لاگ‌هایی را که تریس هنوز نگه داشته (۳۰ روز گذشته) می‌شمارد، پس با سابقه شروع می‌شود.
- عددهای ماهانه بعد از پاک شدن خود خط‌های لاگ هم حدود ۱۳ ماه می‌مانند.
- هر خط در روزِ زمان خودش شمرده می‌شود. خط‌هایی که بیش از دو روز دیرتر برسند شمرده نمی‌شوند.
- مقدارهای متفاوت در طول روزها دقیق است: یک حساب در دو روز، در ماه یک بار شمرده می‌شود.
نقش‌ها#
همه‌ی کسانی که به پروژه دسترسی دارند سنجه‌ها را می‌بینند. memberها سنجه می‌سازند و سنجه‌های خودشان را تغییر می‌دهند یا حذف می‌کنند؛ admin و owner هر سنجهی را. نقش‌ها و دسترسی‌ها را ببینید.
حریم خصوصی#
سنجه‌ها عدد هر روز را نگه می‌دارند و برای مقدارهای متفاوت فقط یک هش کوتاه یک‌طرفه از هر مقدار، هرگز خود مقدار را. مقدار فیلدهای تفکیک همان‌طور که هست نشان داده می‌شود، پس با شناسه تفکیک کنید، نه با ایمیل یا شماره‌ی تلفن.
هشدار روی خط‌های لاگ#
برای اینکه وقتی یک پیام آمد خبردار شوید، آن را در تریس ← لاگ‌ها به‌عنوان جست‌وجو ذخیره کنید و یک قانون جست‌وجوی لاگ بسازید، یا برای خطاها از قانون دیده شدن مشکل استفاده کنید. قانون‌های هشدار را ببینید.
سنجه چیزی نشان نمی‌دهد؟
- پیام باید دقیقاً یکی باشد، با همان حروف و فاصله‌ها. آن را از یک خط در تریس ← لاگ‌ها کپی کنید.
- برای جمع، فیلد باید در لاگ عدد باشد (
412000)، نه متن همراه واحد. - سنجهٔ تازه چند دقیقه لازم دارد تا لاگ‌های نگه‌داشته را بشمارد.
به‌روزرسانی: ۱۸ آبان ۱۴۰۵