---
title: الصحة والمراقبة
description: فحوصات الحيوية والجاهزية، وما تتحقق منه وما لا تتحقق منه، وتنسيق السجلات، والإشارات التي ينبغي إنشاء تنبيهات عليها.
canonical: https://developer.unico.io/ar/human-plugin/self-hosting/health-and-monitoring
locale: ar
generated_by: markdown-export
---

# الصحة والمراقبة

ما يجب فحصه وما يجب مراقبته وما لا تستطيع الفحوصات إخبارك به.

## الفحوصات

| نقطة النهاية | الرد | الاستخدام |
| --- | --- | --- |
| `GET /health/live` | `200 {"status":"ok"}` طالما تخدم العملية الطلبات | الحيوية (liveness) |
| `GET /health/ready` | `200 {"status":"ok"}` عندما تردّ PostgreSQL، وإلا `503 {"status":"unavailable"}` | الجاهزية (readiness): وجّه الطلبات فقط بعد أن يصبح جاهزًا |

```yaml
livenessProbe:
  httpGet: { path: /health/live, port: 8080 }
readinessProbe:
  httpGet: { path: /health/ready, port: 8080 }
  timeoutSeconds: 5
```

اضبط `timeoutSeconds` في فحص الجاهزية. إذا كانت PostgreSQL تقبل الاتصالات لكنها توقفت عن الرد، فقد ينتظر الفحص مدة أطول بكثير، وتجعل المهلة الفحص يفشل بدلًا من أن يتعلق.

### ما لا يتحقق منه فحص الجاهزية

يفحص فحص الجاهزية قاعدة البيانات فقط. وهو **لا** يتحقق من صلاحية مفتاح الوصول ولا من إمكانية الوصول إلى Unico. يظهر مفتاح الوصول الخاطئ على شكل أخطاء عند الإنشاء، وليس كفشل في الفحص. ضمّن طلب إنشاء حقيقيًا في فحوصات ما بعد النشر.

<a id="logs"></a>

## السجلات

السجلات أسطر JSON على المخرج القياسي، وتحتوي على `timestamp` و`severity` و`service` و`message`. تتضمن الإخفاقات المتعلقة بعملية مخزّنة قيمة `id` الخاصة بها. لا تُسجَّل الأخطاء التي يرتكبها المستدعي (`400` و`404` و`409` و`422`).

يسجّل البدء السليم هذه الأسطر، بهذا الترتيب، بين رسائل الاتصال بـ PostgreSQL (تتغير قيمتا `version` و`count` للفهرس مع كل إصدار من الفهرس):

```json
{"severity":"INFO","timestamp":"2026-11-03T14:02:11.482913407Z","message":"attribute catalog loaded","service":"human-plugin","version":"2026-10-29.1","count":53,"url":"https://human-token-assets.unico.app/attribute-catalog.json"}
{"severity":"INFO","timestamp":"2026-11-03T14:02:11.731050212Z","message":"database schema ready","service":"human-plugin"}
{"severity":"INFO","timestamp":"2026-11-03T14:02:11.733418901Z","message":"human plugin listening","service":"human-plugin","addr":":8080"}
```

## ما الذي ينبغي إنشاء تنبيهات عليه

- فشل الجاهزية: قاعدة البيانات لا يمكن الوصول إليها.
- تكرار ردود `503 DATABASE_UNAVAILABLE` أو `502 UPSTREAM_UNAVAILABLE` على استدعاءات الواجهة الخلفية لديك.
- إعادات تشغيل الحاوية: تعني حلقة إعادة التشغيل عادةً إعدادًا مفقودًا أو فهرسًا لا يمكن الوصول إليه أو مشكلة في قاعدة البيانات. يوضح السجل أيًّا منها.
- أسطر السجل من مستوى الخطأ، مثل `creating process` أو `retrieving process`.

لا يصدّر Human Plugin مقاييس. استخدم البوابة (gateway) أو شبكة الخدمات (service mesh) لديك لمعرفة معدلات الطلبات وزمن الاستجابة.