---
title: "سنجه‌های لاگ"
description: "لاگ‌های ساخت‌یافته‌تان را به عدد روزانه و ماهانه تبدیل کنید: شمردن خط‌ها، جمع یک فیلد عددی یا شمردن مقدارهای متفاوت، با تفکیک بر اساس هر فیلد، فهرست برترین‌ها و سقف مرجع ماهانه. بدون SDK اضافه و بدون هزینه‌ی اضافه."
product: trace
language: fa
url: https://abrova.ir/docs/trace/log-metrics
updated: 2026-11-09
---

# سنجه‌های لاگ

لاگ‌های ساخت‌یافته‌تان را به عدد روزانه و ماهانه تبدیل کنید: شمردن خط‌ها، جمع یک فیلد عددی یا شمردن مقدارهای متفاوت، با تفکیک بر اساس هر فیلد، فهرست برترین‌ها و سقف مرجع ماهانه. بدون SDK اضافه و بدون هزینه‌ی اضافه.

- **سنجهٔ لاگ چیست؟** — عددهایی از دل لاگ‌هایی که سرورها و اپ‌هایتان همین حالا می‌فرستند: چند بار یک پیام ثبت شده، جمع یک فیلد عددی، یا یک فیلد چند مقدار متفاوت داشته، روزانه و ماهانه.
- **کجا؟** — کنسول ابرووا ← پروژه‌ی شما ← تریس ← بینش‌ها ← سنجه‌های لاگ. تا ۲۰ سنجه برای هر پروژه، بدون هزینه‌ی اضافه.

## ۱. یک پیام ثابت با فیلدها ثبت کنید

سنجه خط‌ها را با **پیام**شان انتخاب می‌کند، پس هر بار همان متن را ثبت کنید و آنچه تغییر می‌کند را در فیلدها (metadata) بگذارید:

```ts
// 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 هر سنجهی را. [نقش‌ها و دسترسی‌ها](https://abrova.ir/docs/trace/error-dashboard#roles-permissions) را ببینید.

## حریم خصوصی

سنجه‌ها عدد هر روز را نگه می‌دارند و برای **مقدارهای متفاوت** فقط یک هش کوتاه یک‌طرفه از هر مقدار، هرگز خود مقدار را. مقدار فیلدهای **تفکیک** همان‌طور که هست نشان داده می‌شود، پس با شناسه تفکیک کنید، نه با ایمیل یا شماره‌ی تلفن.

## هشدار روی خط‌های لاگ

برای اینکه وقتی یک پیام آمد خبردار شوید، آن را در **تریس ← لاگ‌ها** به‌عنوان جست‌وجو ذخیره کنید و یک قانون **جست‌وجوی لاگ** بسازید، یا برای خطاها از قانون **دیده شدن مشکل** استفاده کنید. [قانون‌های هشدار](https://abrova.ir/docs/trace/alert-rules) را ببینید.

#### سنجه چیزی نشان نمی‌دهد؟

- پیام باید دقیقاً یکی باشد، با همان حروف و فاصله‌ها. آن را از یک خط در تریس ← لاگ‌ها کپی کنید.
- برای جمع، فیلد باید در لاگ عدد باشد (`412000`)، نه متن همراه واحد.
- سنجهٔ تازه چند دقیقه لازم دارد تا لاگ‌های نگه‌داشته را بشمارد.