---
title: "قانون‌های هشدار"
description: "هشدارهای خودتان روی خطا، تأخیر و لاگ: یک آستانه، یک بازه و کانال‌هایی که باید خبر بگیرند. شامل «دیده شدن مشکل» که هر رخداد تازه‌ی خطایی را که برایتان مهم است، فوراً خبر می‌دهد."
product: trace
language: fa
url: https://abrova.ir/docs/trace/alert-rules
updated: 2026-11-09
---

# قانون‌های هشدار

هشدارهای خودتان روی خطا، تأخیر و لاگ: یک آستانه، یک بازه و کانال‌هایی که باید خبر بگیرند. شامل «دیده شدن مشکل» که هر رخداد تازه‌ی خطایی را که برایتان مهم است، فوراً خبر می‌دهد.

- **قانون هشدار چیست؟** — عددی که تریس هر دقیقه بررسی می‌کند (مشکل‌های تازه، تأخیر p95، خط‌های لاگ منطبق…) با یک آستانه. وقتی از آن بگذرد، کانال‌هایی که انتخاب کرده‌اید خبر می‌گیرند؛ وقتی به حالت عادی برگردد، خبر رفع شدن را می‌گیرند.
- **کجا؟** — کنسول ابرووا ← پروژه‌ی شما ← تریس ← هشدارها. تا ۵۰ قانون با موجودی کیف پول، بدون هزینه‌ی اضافه.

> **به موجودی کیف پول نیاز دارد**
>
> قانون‌های هشدار به کیف پول با موجودی نیاز دارند. با کیف پول خالی قانون‌ها می‌مانند ولی بررسی نمی‌شوند. [قیمت‌ها](https://abrova.ir/pricing) را ببینید.

## نوع قانون‌ها

| نوع | آنچه در بازه شمرده می‌شود |
| --- | --- |
| `تعداد خطا` | مشکل‌های تازه (اولین بار در بازه دیده شده). |
| `جهش خطا` | مشکل‌های تازه، به‌صورت درصد بالاتر از میانگین ۲۴ ساعت گذشته. [تشخیص جهش](/docs/trace/spike-detection) را ببینید. |
| `تأخیر P95` | صدک ۹۵ مدت spanهای عملکرد، به میلی‌ثانیه. |
| `تعداد لاگ خطا` | خط‌های لاگ با سطح error یا fatal. |
| `جست‌وجوی لاگ` | خط‌های لاگ منطبق با یک جست‌وجوی ذخیره‌شده در تریس ← لاگ‌ها، مثلاً یک پیام از یک منبع. |
| `دیده شدن مشکل` | مشکل‌هایی که پیامشان متن شما را دارد و رخدادی داشته‌اند: هر رخدادی، حتی از مشکلی که از قبل دارید یا حل کرده‌اید. |

همه‌ی نوع‌ها **کل پروژه** را می‌شمارند: خطاهای اندروید، آی‌اواس، فلاتر، وب و سرورهایتان با هم.

## دیده شدن مشکل: هشدار برای هر بار رخ دادن یک خطا

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

1. خطا را با یک پیام ثابت گزارش کنید و آنچه تغییر می‌کند را در داده‌ی اضافه‌اش بگذارید:

```javascript
AbrovaTrace.captureException(new Error('payments: provider refused'), { extra: { status, code } });
```

2. یک قانون از نوع **دیده شدن مشکل** بسازید با **پیام مشکل شامل این متن است** `payments: provider refused`، آستانه‌ی **۱**، بازه‌ی **۵** دقیقه و کانال‌هایتان.

در اولین بررسی بعد از رخداد (ظرف یک دقیقه) و بدون صبر کردن به اندازه‌ی یک بازه فعال می‌شود، و وقتی یک بازه‌ی کامل بدون رخداد بگذرد رفع می‌شود. تا وقتی فعال است، رخدادهای بیشتر دوباره پیام نمی‌فرستند؛ بعد از رفع شدن، رخداد بعدی دوباره فعالش می‌کند، مگر اینکه زمان انتظار (پیش‌فرض ۳۰ دقیقه) هنوز نگذشته باشد. متن در هر جای پیام و بدون توجه به حروف کوچک و بزرگ پیدا می‌شود. مشکل‌هایی که **نادیده** گرفته‌اید شمرده نمی‌شوند.

## تنظیم‌ها

| تنظیم | چه می‌کند |
| --- | --- |
| `آستانه و عملگر` | مثلاً بیشتر از ۱۰. برای «دیده شدن مشکل» دست‌کم ۱. |
| `بازه` | چند دقیقه داده که هر بررسی می‌بیند (پیش‌فرض ۵). به‌جز «دیده شدن مشکل»، قانون باید به اندازه‌ی یک بازه بالای آستانه بماند تا فعال شود، تا یک نوسان کوتاه بیدارتان نکند. |
| `زمان انتظار` | چند دقیقه بعد از یک پیام که قانون دوباره پیام نمی‌فرستد (پیش‌فرض ۳۰). |
| `محیط` | فقط داده‌ی یک محیط، مثلاً production. |
| `ابرووا تیم` | مالک سازمان و همه‌ی کسانی که به پروژه اضافه شده‌اند، در اپ ابرووا تیم خبر می‌گیرند، وقتی فعال و وقتی برطرف می‌شود. وقتی ابرووا تیم برای پروژه روشن است، روی قانون‌های تازه از پیش انتخاب شده است؛ هر کس می‌تواند هشدارها را در اپ خاموش کند. |
| `کانال‌ها` | یکپارچه‌سازی‌های پروژه که خبر می‌گیرند: [ایمیل](/docs/trace/email)، [تلگرام](/docs/trace/telegram)، [Webhook](/docs/trace/webhooks)، [Slack](/docs/trace/slack)، [Discord](/docs/trace/discord). بدون کانال، قانون فعال می‌شود ولی به کسی خبر نمی‌دهد. |

## نقش‌ها

admin و owner قانون‌ها را می‌سازند، تغییر می‌دهند و حذف می‌کنند. memberها یک قانون فعال را تأیید یا بی‌صدا می‌کنند. [نقش‌ها و دسترسی‌ها](https://abrova.ir/docs/trace/error-dashboard#roles-permissions) را ببینید.

#### قانون فعال شد ولی پیامی نرسید؟

- دست‌کم یک کانال روی قانون انتخاب کنید و آن را با **ارسال آزمایشی** در تریس ← یکپارچه‌سازی‌ها بررسی کنید.
- پیامی که در زمان انتظار بیفتد فرستاده نمی‌شود؛ سابقه‌ی قانون آن را نشان می‌دهد.
- قانون بی‌صدا تا پایان بی‌صدایی بررسی نمی‌شود.