إنتقل إلى المحتوى الرئيسي

قابلية المراقبة

يوفّر EntityFlow التتبّع، والإبلاغ عن الأخطاء، والسجلّات المنظَّمة، ومسار تدقيق — وكلّها مُتحكَّم بها عبر متغيّرات البيئة ومُعطَّلة افتراضيًا دون أي عبء إضافي حتى تقوم بتشغيلها.

التتبّع​

يُصدر EntityFlow آثار OpenTelemetry عندما يكون EF_OTEL_ENABLED=true (مُعطَّل افتراضيًا — لا يوجد أي عبء إضافي عند التعطيل). وجِّهه إلى المُجمِّع لديك باستخدام EF_OTEL_EXPORTER_OTLP_ENDPOINT وسمِّ الخدمة باستخدام EF_OTEL_SERVICE_NAME (القيمة الافتراضية ef-server).

تغطّي الـ spans ما يلي:

  • طلبات HTTP (tRPC وREST)،
  • استعلامات قاعدة البيانات،
  • مهام الإسقاط، وتوليد الشيفرة، والتحقّق.

الأخطاء​

اضبط EF_SENTRY_DSN لتفعيل الإبلاغ عن الأخطاء عبر Sentry. عندما لا يكون الـ DSN مضبوطًا، يكون Sentry معطَّلًا تمامًا.

السجلّات​

السجلّات بصيغة JSON منظَّمة عبر pino. تحكَّم في مستوى التفصيل باستخدام EF_LOG_LEVEL:

المستوى
fatal error warn info debug trace silentinfo هي القيمة الافتراضية.

التدقيق​

يسجّل سجلّ تدقيق للإلحاق فقط أحداث دورة حياة الحسابات وإجراءات المسؤولين. هذه ميزة مؤسسية (انظر الترخيص) وتُعرض في صفحة سجل التدقيق في EntityFlow Hub.

مثال​

فعِّل التتبّع والإبلاغ عن الأخطاء معًا:

export EF_OTEL_ENABLED=true
export EF_OTEL_EXPORTER_OTLP_ENDPOINT="http://otel-collector:4318"
export EF_OTEL_SERVICE_NAME="ef-server"
export EF_SENTRY_DSN="https://examplePublicKey@o0.ingest.sentry.io/0"
export EF_LOG_LEVEL="info"

راجع مرجع التهيئة للاطّلاع على القائمة الكاملة لمتغيّرات قابلية المراقبة.