# سنجه‌ها و پایش

> سنجه‌های Prometheus، کانتینر همراه Prometheus و نشانی سلامتی که پایشگر آپ‌تایم را به آن وصل می‌کنید.

Source: https://joinnasnet.com/fa/guides/nasnet-linux/monitoring/
Last updated: 2026-08-14

---

## معرفی

پنل سنجه‌های Prometheus را زیر فضای نام `nasnet_` منتشر می‌کند و پشته Docker
Compose یک کانتینر Prometheus همراه دارد که از پیش برای جمع‌آوری آن‌ها تنظیم شده
است. همین از همان ابتدا رصدپذیری واقعی به شما می‌دهد: تأخیر HTTP، مصرف پردازنده و
حافظه میزبان، ترافیک و کاربران آنلاین، زمان باقی‌مانده تا انقضای گواهی هر دامنه،
مصرف استخر اتصال پایگاه داده و زمان‌بندی وظایف، که همه قابل پرس‌وجو و همه یک منبع
داده طبیعی برای Grafana.

## پیش‌نیازها

- پیش از آنکه نقطهٔ متریک‌ها را در معرض بگذارید از آن محافظت کنید.
  `METRICS_USERNAME` و `METRICS_PASSWORD` احراز هویت پایه اضافه می‌کنند، و
  Prometheus همراه وقتی تنظیم شده باشند از همان‌ها استفاده می‌کند.
- جمع‌آوری سنجه‌ها را می‌شود بدون راه‌اندازی مجدد از
  **تنظیمات ← سرور ← Monitoring** روشن و خاموش کرد؛ جمع‌کننده در هر تیک
  زمان‌بند تنظیم `metrics_enabled` را از پایگاه‌داده دوباره می‌خواند. متغیر
  محیطی `METRICS_ENABLED` تنها پیش‌فرض هنگام بالا آمدن است.

## مراحل

1. کلیدهای متریک را در `.env` بگذارید:

   ```dotenv
   METRICS_ENABLED=true
   METRICS_PATH=/metrics
   METRICS_USERNAME=prometheus
   METRICS_PASSWORD=change-me
   ```

2. زیر Docker Compose، Prometheus همراه با همان پشته روی
   `${PROMETHEUS_PORT:-9090}` بالا می‌آید و خودکار از برنامه جمع‌آوری می‌کند.
3. برای ساخت داشبورد، Grafana را به همان Prometheus وصل کنید.
4. پایشگر آپ‌تایم یا توزیع‌کنندهٔ بار خود را به نقطهٔ آمادگی وصل کنید:

   ```bash
   curl -f http://localhost:9761/health/ready
   ```

## مرجع

| گروه سنجه | نمونه‌ها |
| --------- | -------- |
| HTTP | مجموع درخواست‌ها، هیستوگرام تأخیر، درخواست‌های در جریان. |
| کسب‌وکار | کاربران، اشتراک‌ها. |
| سرور (Xray و میزبان) | پردازنده، حافظه و دیسک میزبان؛ اتصال‌های فعال، ترافیک، کاربران آنلاین، زمان بالا بودن هستهٔ Xray. |
| تدارک | عمق صف، کارهای پردازش‌شده به‌همراه شمار موفق و ناموفق. |
| گواهی‌ها | ثانیه‌های مانده تا انقضا، به تفکیک دامنه. |
| پایگاه‌داده | مصرف استخر اتصال. |
| زمان‌بند | مدت هر کار و شمار خطاها. |
| گذرگاه رویداد | رویدادهای منتشرشده، مشترکان فعال. |

| متغیر | چه می‌کند | پیش‌فرض |
| ----- | --------- | ------- |
| `METRICS_ENABLED` | پیش‌فرض جمع‌آوری هنگام بالا آمدن. | `true` |
| `METRICS_PATH` | جایی که سنجه‌ها سرو می‌شوند. | `/metrics` |
| `METRICS_USERNAME` | کاربر احراز هویت پایه برای نقطهٔ متریک‌ها. | خالی |
| `METRICS_PASSWORD` | رمز احراز هویت پایه. | خالی |
| `PROMETHEUS_PORT` | درگاه میزبان برای Prometheus همراه. فقط در Compose. | `9090` |
| `PROMETHEUS_RETENTION` | مدتی که Prometheus سری‌ها را نگه می‌دارد. فقط در Compose. | `15d` |
| `PROMETHEUS_SCRAPE_INTERVAL` | فاصلهٔ جمع‌آوری. فقط در Compose. | `5s` |
| `PROMETHEUS_TARGET` | چیزی که Prometheus از آن جمع‌آوری می‌کند. فقط در Compose. | `app:9761` |

اعلان رویدادها و هشدارها جداگانه فرستاده می‌شود، از راه کانال‌های Telegram،
Discord و webhook که زیر **تنظیمات ← Notifications** پیکربندی می‌شوند. ماتریس
رویداد همان‌جا به شما اجازه می‌دهد برای هر کانال انتخاب کنید کدام رویدادها اعلان
بدهند، از آنلاین و آفلاین شدن سرور، خاموش شدن، بازیابی و حلقهٔ کرش Xray گرفته تا
ساخت، تمدید، لغو و انقضای اشتراک و هشدارهای سیستمی.

## مطالب مرتبط

- [هشدارها](/fa/guides/nasnet-linux/alerts/)
- [تنظیمات](/fa/guides/nasnet-linux/settings/)
- [داشبورد](/fa/guides/nasnet-linux/dashboard/)